支付完成异步通知

当订单成功完成支付后，系统会向您创建订单时的 notify_url 发送一个 POST 请求，以异步方式通知您订单完成。

通知请求

请求头 (Headers)

请求头中需要包含认证信息和内容类型。

字段	类型	描述
X-API-Key	string	您的 API Key，用于标识调用方身份。
X-Timestamp	string	当前请求的时间戳 (Unix epoch time, 秒)。
X-Nonce	string	随机字符串 (Nonce)，每次请求必须使用唯一的 Nonce。
X-Signature	string	请求内容的签名。

请求体示例 (JSON)

{
  "id": "524206080",
  "order_no": "Pay1756019978",
  "currency": "EUR",
  "amount": "0.1",
  "chain_type": "bsc",
  "order_amount": "0.12",
  "product_name": "Test product name",
  "cancel_time": 1756021778,
  "meta": "",
  "state": 2,
  "pay_amount": "0.12",
  "fee": "0.01",
  "txid": "0xa3c6beb38c2fa1b4681d3b126a...",
  "pay_time": 1756020040
}

字段说明

字段	类型	描述
id	string	收款系统内部订单 ID。
order_no	string	商户侧订单号。
currency	string	订单币种代码。
amount	string	原始订单金额。
chain_type	string	收款链类型。
order_amount	string	实际收款的USDT金额。
product_name	string	商品或服务名称。
cancel_time	integer	订单的取消/过期时间（Unix Mtimestamp, 秒）。
meta	string	附加元数据。
state	integer	订单当前状态。此时固定为 2 (已支付)。 更多状态请参考 订单状态。
pay_amount	string	实际收款金额。
fee	string	交易手续费。
txid	string	区块链交易哈希。
pay_time	integer	收款完成时间 (Unix Mtimestamp, 秒)。

响应要求

为了确认通知已成功接收，您的服务器需要返回一个 HTTP 200 状态码，并且响应体应为 "success" 字符串。

通知重试机制

如果您的服务器未能返回上述指定的成功响应（例如，网络超时、返回非 200 状态码或响应体格式不正确），系统将认为通知失败，并会按照以下策略进行重试：

• 重试间隔：通知的间隔频率为：4m、10m、10m、1h、2h、6h、15h。
• 停止条件：在收到成功的响应或所有重试完成后，系统将停止发送通知。