链上转账事件
此类事件由指向订单收款地址的底层区块链单笔转账触发。它们适用于需要向用户精细化展示具体交易哈希 (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"
}
}Updated about 13 hours ago
