业务说明

应用场景

用于快捷支付业务，本接口直接返回快捷支付页面，封装了快捷支付流程。用户在页面上输入银行卡等信息，通道平台会向持卡人在银行预留的手机号发送短信验证码，系统自动完成绑卡支付。

通道平台提供快捷支付页面，用户在快捷支付页面上可以完成绑卡、支付等操作。

交易请求报文

JSON:

{
    "request_type": "online_quickpay_pageinfo_request",
    "isspid": "39493002",
    "pos_id": "1511300001",
    "store_id": "1511300001",
    "pos_seq": "2018121400000004",
    "user_id": "user01",
    "system_id": "8888",
    "device_type": "4",
    "device_ip": "127.0.0.1",
    "memo": "订单备注",
    "online_quickpay_pageinfo_request": {
        "tx_amt": "1",
        "order_type": "P",
        "page_type": "P",
        "time_expire": "20221128235959",
        "gw_chnnl_tp": "01",
        "goods_short_name": "个人电脑",
        "biz_tp": "100099",
        "user_yima_id": "111111111111",
        "front_url": "https://www.baidu.com/",
        "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_pageinfo_request</request_type>
    <isspid>39493002</isspid>
    <pos_id>1511300001</pos_id>
    <store_id>1511300001</store_id>
    <pos_seq>1511300000002</pos_seq>
    <user_id>user01</user_id>
    <system_id>8888</system_id>
    <device_type>4</device_type>
    <device_ip>127.0.0.1</device_ip>
    <memo>订单备注</memo>
    <online_quickpay_pageinfo_request>
        <tx_amt>1</tx_amt>
        <order_type>P</order_type>
        <page_type>P</page_type>
        <time_expire>20221128235959</time_expire>
        <gw_chnnl_tp>01</gw_chnnl_tp>
        <goods_short_name>个人电脑</goods_short_name>
        <biz_tp>100099</biz_tp>
        <user_yima_id>111111111111</user_yima_id>
        <front_url><![CDATA[https://www.baidu.com/]]></front_url>
        <notify_url><![CDATA[https://www.baidu.com/]]></notify_url>
        <extend_params><![CDATA[扩展参数(JSONObject)]]></extend_params>
    </online_quickpay_pageinfo_request>
</business_trans>

交易请求报文说明

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

user_yima_id 用户号

1. 用户在首次支付：不传用户用户号，此时到通道方的页面需要先进行绑卡->签约->支付，支付成功后【4.20 支付交易支付结果通知】中会返回用户号(此时可以进行记录)；
2. 用户非首次支付：可传用户用户号，此时到通道方的页面直接进行支付。

goods_short_name 商品简称

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

front_url 页面跳转地址

1. front_url若传入：交易在通道提供的支付页出现失败，会在通道提供的支付结果页面展示结果，待页面10s倒计时结束后，将由通道方会将交易结果数据data以页面from表单POST的方式提交，将data结果传给商户。返回：key=data,value=”JOSNString同步返回data”。
2. front_url不传入：支付成功或失败，均会在通道提供的支付结果页面展示结果。

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"
            }
        ]
    }
}

同步返回说明

针对页面版本接口，同步返回一个完整的html页面。Html页面中信息有几种情况如下：

1. 接口失败：
   • 请求参数front_url传值：返回错误的html页面，商户打开页面会以form表单POST请求方式进行的按照请求参数front_url传入的值进行跳转，”data”作为key，value=data，跳转到商户页面。如：key=data,value=”JOSNString同步返回data”；
   • 请求参数front_url不传值：返回的html页面元素，是通道方的支付结果页面信息。
2. 接口成功：
   • 返回结果待支付的操作html页面元素；
   • 在页面中支付成功后，进行返回的html页面，商户打开页面会以form表单POST请求方式进行的按照请求参数front_url传入的值进行跳转，”data”作为key，value=data跳转到商户页面。如：key=data,value=”JOSNString同步返回data”。

跳转请求front_url的参数

通道方业务返回码与信息