获取下单ticket--用户授权版

使用场景:三合一支付获取下单ticket

调用凭证: 用户凭证管理

请求地址: https://oapi.gongyi.qq.com/api/partner_transaction/GetPrepayTicket?access_token=31_14a530b6afce1383fc8163ea5b8b3fcccVFdManC9KlD8oIK4SRAW83L3Mkl6XzF4Nk8wv7NnI8NRj4JZEC0k6JGxCAJlsES0IhxQFor2sYGjBIrh5TnKm5Gyx3vN

请求方法: 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"
}
© 1998 - 2022 Tencent Inc. all right reserved,powered by tencent.更新时间: 2025-03-06 17:00:45

results matching ""

    No results matching ""

    results matching ""

      No results matching ""