代付 Webhook
代付状态异步通知。
接口
POST/callback_url认证
Merchant Credential。详见 认证。
重要说明
警告
该接口的响应时间请务必在3s内响应，如超3s响应，系统将当做回调失败处理！
请求头
| 名称 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
Content-Type | header | string | 是 | application/json | |
X-Nonce | header | string | 是 | a9f3c1d47e8b9a2c4d1f9e8a7b6c5d4e | |
X-Merchant-Id | header | string | 是 | 2492265300 | |
X-Timestamp | header | string | 是 | 1638123456 | |
Digest | header | string | 是 | SHA-256=Jr9cX0nM6yT7uF9GQ5G8ZC5M8vRZrQZP9+VbQ8Z8z0Q= | |
Authorization | header | string | 是 | Signature keyId="m123456",alg="ES256",headers="(request-target) x-timestamp x-nonce digest",signature="MEUCIQD8VxkzR7q5hF3k9dY0v6mKk7K0Nq9nYw+7Ck8LJr9mYAIgC5VQ7J0Z9YqL5F8Wc6E2Yw5qf1z8bYyYcR9kX8pY=" |
请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
mchOrderNo | string | 是 | 商户订单号 |
platOrderNo | string | 是 | 平台订单号 |
orderStatus | string | 是 | 订单状态 (enum=PENDING, SUCCESS, FAILED, REFUND) |
amount | number | 是 | 到账金额 |
fee | number | 是 | 手续费 |
toPix | string | 是 | |
toIspb | string | 是 | |
toName | string | 是 | |
fromBank | string | 是 | |
fromCnpj | string | 是 | |
fromName | string | 是 | |
toCpfCnpj | string | 是 | |
ispbName | string | 是 | |
msg | string | 是 | 信息 — 错误信息 |
event | string | 是 | 事件 (enum=PIX_OUT_SUCCESS, PIX_OUT_FAILED, PIX_OUT_REFUND) |
payTime | number | 是 | |
e2eId | string | 是 |
请求示例
json
{
"event": "PIX_OUT_SUCCESS",
"mchOrderNo": "payout_1662104438",
"platOrderNo": "wussXUCOoXO3yptr7rQV",
"orderStatus": "PENDING",
"e2eId": "E20259930123438389IOs9ewKop39s",
"payTime": 1669080985,
"amount": 180.34,
"fee": 200.36,
"toPix": "47***112",
"toIspb": "22896431",
"toName": "SEBASTIAO CONCEICAO SANTOS",
"fromBank": "Adox IP",
"fromCnpj": "***.820.307/0002**",
"fromName": "DX MEIOS DE PAGAMENTOS LTDA",
"toCpfCnpj": "473******53",
"ispbName": "-"
}