业务说明
应用场景
本接口用于快捷支付流程中,商户系统调用快捷支付申请接口后,翼码平台会向持卡人在银行预留的手机号发送短信验证码,商户系统调用快捷支付确认接口,上送短信验证码,完成支付。
商户需要开通快捷支付业务,并且完成绑卡,商户系统已获取到了持卡人用户号(user_yima_id)和绑卡序列号(card_token_no)。
交易请求报文
JSON:
{
"request_type": "online_quickpay_confirm_request",
"isspid": "39493002",
"pos_id": "0001",
"store_id": "0001",
"pos_seq": "qpc_20240301235959000001",
"org_pos_seq": "qpa_20240301235959000001",
"system_id": "8888",
"verify_code": "010101",
"goods_desc": "个人电脑",
"sign": "314DA43E7E244105ECBD45F797264854"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>online_quickpay_confirm_request</request_type>
<isspid>39493002</isspid>
<pos_id>0001</pos_id>
<store_id>0001</store_id>
<pos_seq>qpc_20240301235959000001</pos_seq>
<org_pos_seq>qpa_20240301235959000001</org_pos_seq>
<system_id>8888</system_id>
<verify_code>010101</verify_code>
<goods_desc>个人电脑</goods_desc>
</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:
{
"response_type": "online_quickpay_confirm_response",
"isspid": "39493002",
"pos_id": "0001",
"pos_seq": "qpc_20240301235959000001",
"trans_time": "20240301151515",
"sys_seq": "0741136885a748c1",
"result": {
"id": "0000",
"comment": "交易确认成功"
},
"sign": "F6106656C20AB23B547B0C30DD819793"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>online_quickpay_confirm_response</response_type>
<isspid>39493002</isspid>
<pos_id>0001</pos_id>
<pos_seq>qpc_20240301235959000001</pos_seq>
<sys_seq>0741136885a748c1</sys_seq>
<trans_time>20240301151515</trans_time>
<result>
<id>0000</id>
<comment>交易确认成功</comment>
</result>
</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”的其他值时,表示该笔快捷支付确认失败,该笔快捷支付交易失败,可结束支付流程。