获取下单ticket

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

调用凭证: 应用签名

请求地址: https://oapi.gongyi.qq.com/api/open_transaction/GetPrepayTicket

请求方法: POST (HTTPS

请求参数:

参数 类型 必填 说明
bt string 长度小于或等于6,新增bt取值时需要事先在支付系统配置
bid string 业务ID
busi_code string 长度小于或等于28字节,可使用字符集[A-Za-z0-9_-@]; 该字段若有唯一性需求,由业务侧保证
pid string 项目ID
money int 金额,单位分;若有填,则后续只能以该金额下单;若不填,则用户可自定义金额下单

备注:busi_code作为携带业务信息字段使用,推荐两种使用场景

  • 场景1: 作为业务订单号使用,各种业务数据可挂载到业务订单号下缓存;回调时,再根据该字段索引并恢复业务数据;此种场景下,若有唯一性需求,需由业务侧保证
  • 场景2: 简单的传递业务信息

备注:某个bid(即包头Gy-H-Request-Bid字段)能填哪些bt和pid,是需要配置的,一般是在业务申请接入时沟通和配置好的,可咨询具体对接的产品或运营人员

  • 请求示例
    {
      "bid": "120000002",
      "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"
}

错误码列表

错误码 宏定义 说明
30720001 ErrPayOCWxpayNoPay 订单未支付
30720002 ErrPayOCTransNotFound 订单不存在
30720003 ErrPayOCCkvError ckv访问错误
30720004 ErrPayOCOrderDataError 订单数据错误
30720005 ErrPayOCRedisError redis访问错误
30720006 ErrPayOCReqWxpayError 微信支付访问错误
30720007 ErrPayOCTranscodeInvalid 订单号无效
30720008 InterfaceNotAuth 支付查单接口没有授权
30720009 ErrOrderTypeNotMatch 订单类型不匹配
30720010 ErrPayMissParams 缺少参数
30720011 ErrPayIllegalQuery 不允许查询非本人订单
30730001 ErrRequestParam 请求参数错误
© 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 ""