支付结果回调
本接口应在服务器端调用,严禁在前端(APP 客户端、网页、小游戏等)直接调用,避免凭证泄露风险。
接口说明
接口英文名 pay.notify
功能描述 当支付结果确定(支付成功或支付失败关闭)后,APP 服务端调用此接口向 SUD 同步支付结果。
注意:本接口强制要求服务通信二次加密和签名:请求参数必须加密并携带签名,响应必须验签后再解密,可有效防止数据篡改与泄露。
调用方式
HTTPS 调用
http
POST /v1/pay/notify?access_token=ACCESS_TOKEN调用时,请在接口路径前拼接应用所属服务区域的基础地址,详见服务区域与接口地址。
请求参数 - Query
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 |
请求参数 - Body
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| env | number | 是 | 环境配置 0-正式环境, 1-测试环境 | |
| game_id | string | 是 | 游戏id | |
| user_id | string | 是 | 下单用户id | |
| sud_trade_no | string | 是 | SUD 业务订单号 | |
| product_id | string | 是 | 商品id | |
| product_name | string | 是 | 商品名称 | |
| quantity | number | 是 | 购买数量 | |
| unit_price | number | 是 | 商品单价(分) | |
| currency | string | 是 | 币种: CNY | |
| status | string | 是 | 状态,枚举类: PAID-支付成功,CLOSED-已关闭。仅需上报终态,支付中(PAYING)无需上报。本接口仅同步支付环节状态,退款状态请通过 pay.refundNotify 同步 | |
| pay_type | number | 否 | 支付方式:1-微信支付,2-支付宝,3-apple支付 | |
| transaction_id | string | 否 | 第三方支付交易号(微信/支付宝等流水号) | |
| attach | string | 否 | 透传数据 |
返回值
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 错误码 |
| errmsg | string | 错误信息 |
调用示例
说明:以下请求示例为加密前的业务数据,实际发送的是加密后的密文并携带签名请求头;返回示例为验签解密后的业务数据。封装与签名规则见服务端 API 签名加密。
请求数据示例
json
{
"env": 0,
"game_id": "game_1001",
"user_id": "user_293847",
"sud_trade_no": "sud_20231024123456",
"product_id": "item_001",
"product_name": "100金币",
"quantity": 1,
"unit_price": 600,
"currency": "CNY",
"status": "PAID",
"pay_type": 1,
"transaction_id": "420000123420231024567890",
"attach": "custom_passthrough_data"
}返回数据示例
json
{
"errcode": 0,
"errmsg": "ok"
}