业务说明

应用场景

本接口用于快捷支付流程中，商户系统调用快捷支付申请接口后，翼码平台会向持卡人在银行预留的手机号发送短信验证码，商户系统调用快捷支付确认接口，上送短信验证码，完成支付。

商户需要开通快捷支付业务，并且完成绑卡，商户系统已获取到了持卡人用户号(user_yima_id)和绑卡序列号(card_token_no)。

交易请求报文

JSON:

  1. {
  2.     "request_type": "online_quickpay_confirm_request",
  3.     "isspid": "39493002",
  4.     "pos_id": "0001",
  5.     "store_id": "0001",
  6.     "pos_seq": "qpc_20240301235959000001",
  7.     "org_pos_seq": "qpa_20240301235959000001",
  8.     "system_id": "8888",
  9.     "verify_code": "010101",
  10.     "goods_desc": "个人电脑",
  11.     "sign": "314DA43E7E244105ECBD45F797264854"
  12. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <request_type>online_quickpay_confirm_request</request_type>
  4.     <isspid>39493002</isspid>
  5.     <pos_id>0001</pos_id>
  6.     <store_id>0001</store_id>
  7.     <pos_seq>qpc_20240301235959000001</pos_seq>
  8.     <org_pos_seq>qpa_20240301235959000001</org_pos_seq>
  9.     <system_id>8888</system_id>
  10.     <verify_code>010101</verify_code>
  11.     <goods_desc>个人电脑</goods_desc>
  12. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节		可空
request_type请求类型String(32)固定值：online_quickpay_confirm_request必填
isspid商户号String(8)翼码商户号，由翼码提供必填
pos_id终端号String(20)商户自定义终端号必填
store_id门店号String(20)商户自定义门店号必填
pos_seq支付确认流水号String(32)可空，若传值则同一个翼码商户号下唯一，不可重复使用，且大于12位可空
org_pos_seq支付申请流水号String(32)被确认的支付申请流水号，且大于12位
对应【快捷支付申请】请求节点中的pos_seq		必填
system_id系统平台号String(4)由翼码提供必填
verify_code手机验证码String(6)6位数字必填
goods_desc商品描述String(64)必填

自定义门店号(store_id)和自定义终端号(pos_id)需经过4.1终端绑定交易接口绑定成功过的值才可以调用，绑定一次即可不需要重复绑定。

交易返回报文

JSON:

  1. {
  2.     "response_type": "online_quickpay_confirm_response",
  3.     "isspid": "39493002",
  4.     "pos_id": "0001",
  5.     "pos_seq": "qpc_20240301235959000001",
  6.     "trans_time": "20240301151515",
  7.     "sys_seq": "0741136885a748c1",
  8.     "result": {
  9.         "id": "0000",
  10.         "comment": "交易确认成功"
  11.     },
  12.     "sign": "F6106656C20AB23B547B0C30DD819793"
  13. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <response_type>online_quickpay_confirm_response</response_type>
  4.     <isspid>39493002</isspid>
  5.     <pos_id>0001</pos_id>
  6.     <pos_seq>qpc_20240301235959000001</pos_seq>
  7.     <sys_seq>0741136885a748c1</sys_seq>
  8.     <trans_time>20240301151515</trans_time>
  9.     <result>
  10.         <id>0000</id>
  11.         <comment>交易确认成功</comment>
  12.     </result>
  13. </business_trans>

交易返回报文说明

标准接口会因业务升级需要而新增节点，请在解析返回报文时避免新增未知节点产生的程序出错！

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节		可选
response_type返回类型String(32)固定值：online_quickpay_confirm_response必填
isspid商户号String(8)翼码商户号，由翼码提供必填
pos_id终端号String(20)商户自定义终端号必填
pos_seq支付确认流水号String(32)支付确认流水号，和请求报文相同必填
sys_seq随机串号String(16)随机生成串号，仅用于日志跟踪用，不保存必填
trans_time接口返回时间String(14)接口返回时间，格式：yyyyMMddHHmmss必填
result
->id		响应码String(4)0000：交易确认成功
9998：交易确认结果未知
其它表示失败，错误信息说明见“响应码解释”字段		必填
result
->comment		响应码解释String(64)响应码对应中文注解，用于显示提示必填

标准接口会因业务升级需要而新增节点，请在解析返回报文时避免新增未知节点产生的程序出错！

判断响应码进行后续调用流程说明

返回响应码(result->id)为“0000”时，表示该笔快捷支付确认成功，此时进入等待【4.20 支付交易支付结果通知】通知支付结果或主动调用【线上交易查询】查询支付结果的流程。

返回响应码(result->id)为“9998”时，表示该笔快捷支付确认结果未知，此时进入等待【4.20 支付交易支付结果通知】通知支付结果或主动调用【线上交易查询】查询支付结果的流程。若30秒仍未收到支付结果通知或主动查询支付结果始终为“等待付款”，可在短信验证码有效时间内重试【快捷支付确认】或认定为支付失败结束支付流程。

返回响应码(result->id)为非“0000”或非“9998”的其他值时，表示该笔快捷支付确认失败，该笔快捷支付交易失败，可结束支付流程。