业务说明

应用场景

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

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

交易请求报文

JSON:

{
    "request_type": "online_quickpay_apply_request",
    "isspid": "39493002",
    "pos_id": "0001",
    "store_id": "0001",
    "pos_seq": "qpa_20240301235959000001",
    "user_id": "user01",
    "system_id": "8888",
    "memo": "订单备注",
    "device_ip": "127.0.0.1",
    "device_type": "4",
    "device_mac": "0C-96-E6-84-1E-11",
    "device_imei": "460030912121001",
    "device_imsi": "460030912121001",
    "device_icc_id": "898600680113F0123014",
    "device_wifi_mac": "96-87-78-69-5A-4B",
    "latitude": "+37.12",
    "longitude": "-121.213",
    "online_quickpay_apply_request": {
        "user_yima_id": "6666000103803532",
        "card_token_no": "10000093623",
        "tx_amt": "1",
        "order_type": "P",
        "time_expire": "20240301235959",
        "biz_tp": "100099",
        "goods_short_name": "个人电脑",
        "gw_chnnl_tp": "01",
        "notify_url": "https://www.baidu.com/",
        "extend_params": {
            "split_flag": "R",
            "plan_split_date": "20230418",
            "split_info": {
                "keep_amt": "800",
                "split_list": [
                    {
                        "merchant_id": "10000000000001",
                        "div_amt": "150"
                    },
                    {
                        "merchant_id": "10000000000002",
                        "div_amt": "50"
                    }
                ]
            }
        }
    },
    "sign": "314DA43E7E244105ECBD45F797264854"
}

XML:

<?xml version="1.0" encoding="GBK"?>
<business_trans>
    <request_type>online_quickpay_apply_request</request_type>
    <isspid>39493002</isspid>
    <pos_id>0001</pos_id>
    <store_id>0001</store_id>
    <pos_seq>qpa_20240301235959000001</pos_seq>
    <user_id>user01</user_id>
    <system_id>8888</system_id>
    <memo>订单备注</memo>
    <device_ip>127.0.0.1</device_ip>
    <device_type>4</device_type>
    <device_mac>0C-96-E6-84-1E-11</device_mac>
    <device_imei>460030912121001</device_imei>
    <device_imsi>460030912121001</device_imsi>
    <device_icc_id>898600680113F0123014</device_icc_id>
    <device_wifi_mac>96-87-78-69-5A-4B</device_wifi_mac>
    <latitude>+37.12</latitude>
    <longitude>-121.213</longitude>
    <online_quickpay_apply_request>
        <user_yima_id>6666000103803532</user_yima_id>
        <card_token_no>10000093623</card_token_no>
        <tx_amt>1</tx_amt>
        <order_type>P</order_type>
        <time_expire>20240301235959</time_expire>
        <biz_tp>100099</biz_tp>
        <goods_short_name>个人电脑</goods_short_name>
        <gw_chnnl_tp>01</gw_chnnl_tp>
        <notify_url><![CDATA[https://www.baidu.com/]]></notify_url>
        <extend_params><![CDATA[扩展参数(JSONObject)]]></extend_params>
    </online_quickpay_apply_request>
</business_trans>

交易请求报文说明

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

goods_short_name 商品简称

不能包含的特殊字符如下：<、>、&、'、"、|、%、#、^、-

extend_params 扩展参数

分账业务相关的特别说明：
1. split_flag=N 不分账时，split_info不允许传入；
2. split_flag=R 实时分账时，split_info必传，其中keep_amt与div_amt叠加必须全额分完整笔订单；
3. split_flag=D 延时分账时，split_info不允许传入，在后续流程中调用延迟交易确认接口完成分账，或使用翼码分账系统界面进行分账。

split_info 分账信息

split_list 分账明细

若业务涉及100%分账给接收方，请于业务对接人联系申请使用净值分账功能。

extend_params 样例：

{
    "split_flag": "R",
    "plan_split_date": "20230418",
    "split_info": {
        "keep_amt": "800",
        "split_list": [
            {
                "merchant_id": "10000000000001",
                "div_amt": "150"
            },
            {
                "merchant_id": "10000000000002",
                "div_amt": "50"
            }
        ]
    }
}

交易返回报文

JSON:

{
    "response_type": "online_quickpay_apply_response",
    "isspid": "39493002",
    "pos_id": "0001",
    "pos_seq": "qpa_20240301235959000001",
    "trans_time": "20240301151515",
    "sys_seq": "0741136885a748c1",
    "avoid_sms_flag": "0",
    "result": {
        "id": "0000",
        "comment": "申请成功"
    },
    "sign": "F6106656C20AB23B547B0C30DD819793"
}

XML:

<?xml version="1.0" encoding="GBK"?>
<business_trans>
    <response_type>online_quickpay_apply_response</response_type>
    <isspid>39493002</isspid>
    <pos_id>0001</pos_id>
    <pos_seq>qpa_20240301235959000001</pos_seq>
    <sys_seq>0741136885a748c1</sys_seq>
    <trans_time>20240301151515</trans_time>
    <avoid_sms_flag>0</avoid_sms_flag>
    <result>
        <id>0000</id>
        <comment>申请成功</comment>
    </result>
</business_trans>

交易返回报文说明

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

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

判断响应码与免短标签进行后续调用流程说明

返回响应码(result->id)为“0000”时，表示该笔快捷支付申请成功，此时需进一步判断返回免短标签(avoid_sms_flag)是否为“1”：

1.当avoid_sms_flag=1时，表示该笔交易无需进行短信验证码验证直接会完成扣款，此时不需要调用【快捷支付确认】，进入等待【4.20 支付交易支付结果通知】通知支付结果或主动调用【线上交易查询】查询支付结果的流程；

2.当avoid_sms_flag!=1时，表示该笔交易需要短信验证码验证，此时下一步需要调用【快捷支付确认】上送持卡人手机收到的短信验证码进行验证，验证成功后才会完成扣款，之后再进入等待【4.20 支付交易支付结果通知】通知支付结果或主动调用【线上交易查询】查询支付结果的流程。