Taypay v1
支付通知
Taypay v1 支付通知回调格式和处理要求。
支付通知
支付完成后平台会向应用通知地址发送事件。商户必须先校验签名, 再根据 merchant_order_no 和 platform_order_no 做幂等更新。
通知参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| event_id | string | 是 | 事件唯一 ID。 |
| event_type | string | 是 | 事件类型, 如 payment.succeeded。 |
| app_id | string | 是 | 商户应用 ID。 |
| merchant_order_no | string | 是 | 商户订单号。 |
| platform_order_no | string | 是 | 平台订单号。 |
| amount | string | 是 | 支付金额。 |
| channel | string | 是 | 支付通道。 |
| status | integer | 是 | 支付状态码。 |
| payment_status | string | 是 | 支付状态文本。 |
| paid_time | integer | 否 | 支付完成时间戳。 |
| timestamp | integer | 是 | 秒级时间戳。 |
| sign_type | string | 是 | 固定为 HMAC-SHA256。 |
| sign | string | 是 | 签名值。 |
响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
| body | string | 处理完成后必须返回文本 success, 非 success 会视为处理失败。 |
处理成功后返回纯文本:
success
非 success 或超时会被视为通知失败并进入重试流程。
通知示例:
{
"event_id": "evt_202605220001",
"event_type": "payment.succeeded",
"app_id": "your_app_id",
"merchant_order_no": "M202605220001",
"platform_order_no": "EP202605220001",
"amount": "99.00",
"channel": "epay_alipay",
"status": 1,
"payment_status": "paid",
"paid_time": 1779465700,
"timestamp": 1779465701,
"sign_type": "HMAC-SHA256",
"sign": "generate_by_app_secret"
}