订单完成后,系统会自动向订单关联的回调地址(notifyUrl)发送通知,告知订单最终状态。
推送 6 次:10 秒、30 秒、60 秒、300 秒、600 秒、900 秒
推送 URL
eg. https://www.qpay.ink/notify
推送方式
POST
推送参数
| 名称 | 字段类型 | 是否必填? | 签名 | 描述 |
|---|---|---|---|---|
| AppId | string | 是 | 是 | 项目 APP ID |
| orderNo | number | 是 | 是 | QPay 订单号。 |
| merchantOrderNo | number | 是 | 是 | 商户订单号。 |
| actualCrypto | number | 是 | 是 | 实际收到的 USDT 金额。 |
| crypto | number | 是 | 是 | 原始 USDT 订单金额。 |
| updatetime | number | 是 | 是 | 订单更新时间。 |
| createtime | number | 是 | 是 | 订单创建时间。 |
| timestamp | number | 是 | 是 | 时间戳,用于参与签名计算。 |
| status | number | 是 | 是 | 订单状态:pending、success、failed |
| chainType | number | 是 | 是 | 支付类型:trc20 或 erc20。 |
| poundage | number | 是 | 是 | 订单手续费。 |
| father_merchantOrderNo | number | 是 | 是 | 原始商户订单号。 |
| hash | number | 是 | 是 | 交易 HASHID。 |
| signature | number | 是 | 是 | 数据签名,参考下方签名算法 |
function makeSignBysend($params, $appKey)
{
$str = $params['AppId']
.$params['orderNo']
. $params['merchantOrderNo']
. $params['hash']
. $params['actualCrypto']
. $params['chainType']
. $params['timestamp'];
return strtoupper(hash_hmac('sha256', $str, $appKey));
}
参考上述方法计算签名。