支付与回调

1 接口说明

开发者根据自身业务，定制多样的支付场景，本接口用于支付场景之前的创单行为。

2 请求说明

2.1 基础信息

2.2 请求参数

商品类型目前主要有以下几种，开发者根据自己的业务场景，选择对应的product_type以及product_id，建议开发者合理、准确传值，促进双方系统精准化运营和归因。

3 响应说明

3.1 响应信息

3.2 错误码

备注：后续有新增或者变化，会持续新增

3.3 完整示例

3.3.1 请求示例

URL：
{API}?access_key=b6dj2f1e785149fjp2dedbiad68dwl9y&ts=1736739534331&sign=WbGNoWSnhogpKzilnQfPciPYdJgiTc2w6T2BI7Bcpo4B

Body：

{
  "open_id": "12345678900101",
  "dev_order_id": "m123456789",
  "app_id": "bili388fh0g748hdj",
  "amount": 100,
  "product_type": 1,
  "product_id": "1234567",
  "product_name": "天龙八部",
  "product_desc": "以宋哲宗时代为背景，各国之间的武林恩怨和民族矛盾，对人生和社会进行审视和描写",
  "notify_url": "https://demo.com/order/callback",
  "extra_data": "{\"a\":1,\"b\":\"4567dd\"}"
}

3.3.2 响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "order_id": "123456789",
    "pay_info": "57Gz5YiH5bCU5bCx6KW6JeP5a6a939fjd3KudH5pel6YGt5YX5Zyw6ZyH5ZCR5Lit5Zu95pS5bqc"
  }
}

4 回调通知

回调通知通常发生在支付成功等交易场景，建议开发者接入。

4.1 回调参数

• 回调形式

• 回调地址 开放平台会根据开发者创单时使用的access_token进行数据签名，比如创单时的notify_url=https:\//demo.com/order/callback， 则实际开放平台回调的URL是https:\//demo.com/order/callback?ts=1736750625059&sign=11GNoWSnBtgpK59lnip06iPYdJgiTc2w6T2BI7Bcpo4B，开发者根据相关参数进行参数签名校验。

• 详细回调请求

• 确保响应体的结构如下，其中code=0则认为回调成功，否则认为回调失败

{
  "code": 0,
  "message": "success"
}

• 请尽可能保证回调服务的稳定性和幂等性，开放平台保证在支付成功后及时回调，如果该接口回调失败，则依次按照5s, 10s, 20s, 1min, 3min, 5min, 30min, 1hour的梯度重试，所有重试梯度使用完之后，放弃回调

• 业务方在校验签名时，要兼容后续开放平台返回增量字段的能力，因此建议使用JSON接收回调信息，然后生成签名和校验签名，签名验证通过后，再反序列化自身关注的字段。

4.2 完整示例

4.2.1 请求示例

{
  "order_id": "123456789",
  "dev_order_id": "m123456789",
  "amount": 100,
  "pay_amount": 100,
  "pay_time": 1736752136959,
  "pay_status": 1,
  "extra_data": "{\"a\":1,\"b\":\"4567dd\"}"
}

4.2.2 响应示例

{
  "code": 0,
  "message": "success"
}

5 版本变更