链上转账事件

此类事件由指向订单收款地址的底层区块链单笔转账触发。它们适用于需要向用户精细化展示具体交易哈希 (txHash) 进度的商户,特别是在用户将单笔订单金额拆分为多次链上转账的复杂场景中。

🔔 事件类型 (Event Types)

事件标识 (event_identifier)触发时机与业务含义
pay.chain.transaction转账侦测 (Created):区块链网络侦测到一笔指向该订单地址的新交易哈希 (txHash)。
pay.chain.transaction.update转账更新 (Updated):该笔 txHash 的状态或区块确认数发生变化(如达到安全确认数)。
🛑

核心警告 (Crucial Warning)
单笔链上交易的确认并不代表订单总金额已足额支付(例如用户可能存在少付情况)。绝对不要将此类事件作为发货或业务放行的凭证。 所有的发货动作必须严格依赖上级订单的 pay.transaction.update (且 status=completed) 事件。

📦 Webhook 数据结构样例 (Payload Example)

data 对象提供了底层的完整哈希记录详情,并通过 payIdNo 字段与主订单进行关联。

{
    "event_id": "997daf9b-4162-4864-914c-960ff6cc16ad",
    "event_identifier": "pay.chain.transaction.update",
    "data": {
        "id": "e62f4f6e-6666-458f-99c1-b621b32e06c8",
        "payIdNo": "1940644675780100098",
        "cursorId": "375638181647749120",
        "txHash": "0x32a6c8cba334eb52699d612e1ba7235a2cca6f21c81f871ec93c95fcd108f3a8",
        "transferAmount": "0.011",
        "type": "in_term",
        "createdAt": "2025-07-03T06:14:11.218Z"
    }
}