业务说明

应用场景

用于网银支付业务，付款人的银行卡需要预先在银行网银或柜面开通网银支付功能可进行支付。商户调用该接口获取网银提交页面html，引导用户浏览器跳转至银行网银页面，用户在网银页面完成支付，支持个人网银和企业网银。

支付模式

商户可根据需求自由选择支付模式：
模式一：支付过程中展示通道方的银行选择页面，展示商户在控台配置好的所有银行，客户选完银行后展示银行网银页面。
模式二：调接口时指定银行，通道方页面只显示指定的银行，用户按要求通过指定银行支付。

两种模式可通过接口请求参数的bank_id(付款方银行编码)区分，不上送bank_id代表模式一，商户获取通道方的银行选择页面URL；上送bank_id代表模式二，商户获取指定的银行网银页面URL。

可通过调用【4.35 网银支持银行列表查询】接口获取支持银行的最新数据。

交易请求报文

JSON:

{
    "request_type": "online_bankpay_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_bankpay_request": {
        "tx_amt": "1",
        "order_type": "P",
        "card_type": "D",
        "time_expire": "20221128235959",
        "goods_desc": "个人电脑",
        "gate_type": "01",
        "goods_short_name": "个人电脑",
        "gw_chnnl_tp": "01",
        "biz_tp": "100099",
        "bank_id": "01040000",
        "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_bankpay_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_bankpay_request>
        <tx_amt>1</tx_amt>
        <order_type>P</order_type>
        <card_type>D</card_type>
        <time_expire>20221128235959</time_expire>
        <goods_desc>个人电脑</goods_desc>
        <gate_type>01</gate_type>
        <goods_short_name>个人电脑</goods_short_name>
        <gw_chnnl_tp>01</gw_chnnl_tp>
        <biz_tp>100099</biz_tp>
        <bank_id>01040000</bank_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_bankpay_request>
</business_trans>

交易请求报文说明

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

goods_short_name 商品简称

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

front_url 页面跳转地址

1. front_url若传入：交易在通道提供的支付页未跳转至银行页出现失败，通道方将交易同步回调数据data通过支付结果页面，以form表单POST的请求方式提交，将data结果传给商户。
2. front_url若传入：银行处理完成后会提示“返回商户”，此时点击返回，通道方会回调跳转到商户指定的页面front_url。
3. 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"
            }
        ]
    }
}

交易返回报文

JSON:

{
    "response_type": "online_bankpay_response",
    "isspid": "39493002",
    "pos_id": "6666666666",
    "pos_seq": "2018121400000004",
    "trans_time": "20181214143516",
    "sys_seq": "0741136885a748c1",
    "form_url": "https://spin.cloudpnr.com/web/bankpay?templateId=1&hfSeqId=default220715",
    "result": {
        "id": "9998",
        "comment": "下单成功，等待用户支付"
    },
    "sign": "F6106656C20AB23B547B0C30DD819793"
}

XML:

<?xml version="1.0" encoding="GBK"?>
<business_trans>
    <response_type>online_bankpay_response</response_type>
    <isspid>39493002</isspid>
    <pos_id>1511300001</pos_id>
    <pos_seq>1511300000002</pos_seq>
    <sys_seq>0311095321465179</sys_seq>
    <trans_time>20160311095321</trans_time>
    <form_url><![CDATA[https://spin.cloudpnr.com/web/bankpay?templateId=1&hfSeqId=default220715]]></form_url>
    <result>
        <id>9998</id>
        <comment>下单成功，等待用户支付</comment>
    </result>
</business_trans>

交易返回报文说明

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

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