Skip to content

支付结果回调 ​

本接口应在服务器端调用,严禁在前端(APP 客户端、网页、小游戏等)直接调用,避免凭证泄露风险。

接口说明 ​

接口英文名 pay.notify

功能描述 当支付结果确定(支付成功或支付失败关闭)后,APP 服务端调用此接口向 SUD 同步支付结果。

注意:本接口强制要求服务通信二次加密和签名:请求参数必须加密并携带签名,响应必须验签后再解密,可有效防止数据篡改与泄露。

调用方式 ​

HTTPS 调用 ​

http
POST /v1/pay/notify?access_token=ACCESS_TOKEN

调用时,请在接口路径前拼接应用所属服务区域的基础地址,详见服务区域与接口地址。

请求参数 - Query ​

属性类型默认值必填说明
access_tokenstring是接口调用凭证

请求参数 - Body ​

属性类型默认值必填说明
envnumber是环境配置 0-正式环境, 1-测试环境
game_idstring是游戏id
user_idstring是下单用户id
sud_trade_nostring是SUD 业务订单号
product_idstring是商品id
product_namestring是商品名称
quantitynumber是购买数量
unit_pricenumber是商品单价(分)
currencystring是币种: CNY
statusstring是状态,枚举类: PAID-支付成功,CLOSED-已关闭。仅需上报终态,支付中(PAYING)无需上报。本接口仅同步支付环节状态,退款状态请通过 pay.refundNotify 同步
pay_typenumber否支付方式:1-微信支付,2-支付宝,3-apple支付
transaction_idstring否第三方支付交易号(微信/支付宝等流水号)
attachstring否透传数据

返回值 ​

返回的 JSON 数据包

属性类型说明
errcodeint32错误码
errmsgstring错误信息

调用示例 ​

说明:以下请求示例为加密前的业务数据,实际发送的是加密后的密文并携带签名请求头;返回示例为验签解密后的业务数据。封装与签名规则见服务端 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"
}