发票 Webhook 格式

创建支付时指定的 Webhook HTTP 请求体中发送的数据。

为确认处理成功,您的服务器必须返回 HTTP 200 OK 状态。否则,系统将以 15 秒间隔最多重试发送 Webhook 5 次。

如有需要,可以使用重新发送 Webhook 方法再次发送该 Webhook。

Webhook 接收的数据格式application/json

id

uuid

已创建支付的 ID
info.currency

string | null

发票的法币代码
info.token

string | null

支付代币
info.network

string | null

支付网络
info.address

string | null

用于支付的钱包地址
amount.starting_price

number

发票的初始法币金额
amount.discount_percent

number

折扣百分比
amount.merchant_fee_percent

number

商户手续费百分比
amount.service_fee_percent

number | null

平台服务费百分比
amount.total

number

折扣和手续费后的最终金额
url.webhook

string | null

商户 Webhook URL
url.success

string | null

支付成功后的跳转 URL
url.error

string | null

支付失败后的跳转 URL
url.payment

string

支付页面链接
options.part_payment

boolean

是否允许部分付款
options.ignore_client_amount

boolean

是否忽略客户的精确金额
options.payment_accuracy

number

允许的付款误差
additional.order_id

string | null

外部订单 ID
additional.info

string | null

订单附加信息
status

string

发票当前状态
expired_at

string (ISO 8601, UTC)

发票过期日期
created_at

string (ISO 8601, UTC)

发票创建日期
payment.transactions

array

传入区块链交易列表
payment.transactions[].txid

string | null

交易哈希
payment.transactions[].from

string | null

发送方地址
payment.transactions[].amount

string | null

以代币最小单位表示的传入交易金额
payment.fiat_payment_amount

number

已支付的法币金额
payment.service_fee_amount

number

以法币计的累计服务费