获取下单ticket--用户授权版
使用场景:三合一支付获取下单ticket
调用凭证: 用户凭证管理
请求方法: POST (HTTPS)
HTTP header:
需要在header中带上业务所需的bid
参数 | 必填 | 说明 |
---|---|---|
Gy-H-Request-Bid | 是 | 业务ID |
请求参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
bt | string | 是 | 长度小于或等于6,新增bt取值时需要事先在支付系统配置 |
busi_code | string | 是 | 长度小于或等于28字节,可使用字符集[A-Za-z0-9_-@]; 该字段若有唯一性需求,由业务侧保证 |
pid | string | 是 | 项目ID |
money | int | 否 | 金额,单位分;若有填,则后续只能以该金额下单;若不填,则用户可自定义金额下单 |
备注:busi_code作为携带业务信息字段使用,推荐两种使用场景
- 场景1: 作为业务订单号使用,各种业务数据可挂载到业务订单号下缓存;回调时,再根据该字段索引并恢复业务数据;此种场景下,若有唯一性需求,需由业务侧保证
- 场景2: 简单的传递业务信息
备注:某个bid(即包头Gy-H-Request-Bid字段)能填哪些bt和pid,是需要配置的,一般是在业务申请接入时沟通和配置好的,可咨询具体对接的产品或运营人员
- 请求示例
{ "bt":"IOT", "busi_code":"180000521120231130_yALiDGkAB", "pid":"3003536" }
返回参数:
参数 | 类型 | 说明 |
---|---|---|
code | int | 返回码:0表示成功,其他值表示错误,请参考错误码说明 |
msg | string | 错误信息 |
data | object | 返回数据 |
data.ticket | string | 下单票据, 用做H5接入跳转中间页,或小程序接入时跳转支付页时的入参 |
data.expire_time | uint32 | 过期时间,单位:s; 一般是1小时 |
返回示例:
{
"code": 0,
"data": {
"expire_time": 3600,
"ticket": "CiAxOTI4M0ZBNUQ4RTVGQjFDNDU0NjIxRTNBMDRDMTc3OBCyg_SsBhocb3Byb0pqMTVtMDd2X0Z6dnVtNzk2a1kweDB2RSIDWVFaKgkxMjAwMDAwMDIyHDE4MDAwMDUyMTEyMDIzMTEzMF95QUxpREdrQUI6BzMwMDM1MzY"
},
"msg": "",
"op_time": 1704788402,
"trace_id": "c7c87fa555a9ac8e8e13061161e82aae"
}