支付票据通知 Webhooks
支付票据的 Webhook 通知基于创建支付票据时传入的 Webhook 通知类型。目前支持的支付票据 Webhook 类型如下:
invoice.paid: 支付票据已支付成功(尚未完成)事件通知，该事件通知在支付票据支付成功后触发，但是并不代表该支付票据已经完成，请只以invoice.completed事件通知为准invoice.completed: 支付票据已完成事件通知，该事件通知在支付票据完成后触发，代表该支付票据已经确认完成invoice.expired: 支付票据已过期事件通知，该事件通知在支付票据过期后触发，代表该支付票据已经过期
目前 invoice.paid 与 invoice.completed 返回数据均如下方所示:
| 字段 | 类型 | 描述 |
|---|---|---|
| invoiceId | string | 支付票据 ID |
| merOrderId | string | 商户侧商户订单号 |
| fiat | string | ISO 4217 3 位字符的法币代码 |
| currency | string | 加密货币币种，例如: USDT, BTC 等 查看币种列表 |
| fiatAmount | decimal | 该支付票据要求支付的法币金额 |
| paidAmount | decimal | 已支付的加密货币金额 |
| totalAmount | decimal | 该支付票据要求支付的加密货币金额 |
| currencyExchange | decimal | 如果该支付票据为法币折算为加密货币类型，则展示当前汇率 |
| tradeTime | long | 支付时间戳 |
| channel | string | 支付渠道(biqu_pay: 币趣支付, chain_pay: 链支付) |
| metadata | map | 传入的结构化元数据，用于商户本身记录相应的数据。该字段将在后续原样返回 |
| chainPaymentInfo | InvoiceChainPaymentInfo | 如果使用链支付则显示链支付的信息 |
InvoiceChainPaymentInfo
| 字段 | 类型 | 描述 |
|---|---|---|
| network | string | 用户支付的链网络 |
| payeeAddress | string | 用户支付的收款地址(即币趣钱包ID) |
| transactionId | string | 用户支付的交易公链交易ID |
| blockHash | string | 用户支付的交易链上打包块 Hash |
| blockHeight | long | 用户支付的交易链上打包块高度 |
| packageTime | long | 用户支付的交易链上打包时间 |