🔔订单异步通知

订单完成后,系统会自动向订单关联的回调地址(notifyUrl)发送通知消息,告知该笔订单的最终状态。

请求方法:POST

请求类型:application/json

请求参数:

字段名称
字段类型
是否必填
是否签名
说明

appId

string

APP ID

orderNo

string

UPay 订单号

merchantOrderNo

string

商户订单号

chainType

string

链路:

1: 波场(TRC20)

2: 以太坊(ERC20)

3: PayPal(PYUSD)

crypto

string

金额,单位 USDT / PYUSD

actualCrypto

string

订单实付金额,单位 USDT / PYUSD

poundage

string

手续费,单位 USDT / PYUSD

actualPoundage

string

订单实付手续费,单位 USDT / PYUSD

status

string

订单状态,详见:订单状态

createdAt

string

订单创建时间,Unix 秒级时间戳

completedAt

string

订单完成时间,Unix 秒级时间戳

attach

string

用户自定义数据,在回调到 notifyUrl 的时候会原样返回

signature

string

数据签名,详见:签名算法

通知返回

商户在收到通知信息后,在响应体的 body 中输出 OK 或者 ok(php例子:echo "OK";) ,否则会重复 5 次发送点对点通知。

重试规则如下:

如第一次通知失败,后续通知频率(秒):10,30,60,300,600 。

订单状态:

状态
字段类型
描述

0

string

处理中

1

string

订单完成

2

string

订单超时

3

string

订单失败

Last updated