交易请求报文

JSON:

{
    "request_type": "scanpay_jsapi_request",
    "isspid": "39493002",
    "pos_id": "1511300001",
    "store_id": "1511300001",
    "pos_seq": "2018121400000004",
    "user_id": "user01",
    "system_id": "8888",
    "device_ip": "127.0.0.1",
    "memo": "订单备注",
    "scanpay_jsapi_request": {
        "pay_type": "502",
        "tx_amt": "1",
        "buyer_id": "2088102838029704",
        "pay_code": "",
        "notify_url": "http://www.baidu.com/",
        "goods_detail": [
            {
                "goods_id": "apple-01",
                "payment_goods_id": "20010001",
                "goods_name": "ipad",
                "quantity": 1,
                "price": 200000,
                "goods_category": "34543238",
                "body": "特价手机",
                "show_url": "http://www.alipay.com/xxx.jpg"
            },
            {
                "goods_id": "apple-02",
                "payment_goods_id": "20010002",
                "goods_name": "ipad2",
                "quantity": 1,
                "price": 200000,
                "goods_category": "34543239",
                "body": "特价手机2",
                "show_url": "http://www.alipay.com/xxx2.jpg"
            }
        ],
        "extend_params": {
            "hb_fq_num": "3",
            "hb_fq_seller_percent": "100",
            "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": "59B62BEBCA649C24DC25C44706677423"
}

XML:

<?xml version="1.0" encoding="GBK"?>
<business_trans>
    <request_type>scanpay_jsapi_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_ip>127.0.0.1</device_ip>
    <memo>订单备注</memo>
    <scanpay_jsapi_request>
        <pay_type>502</pay_type>
        <tx_amt>1</tx_amt>
        <buyer_id>2088************</buyer_id>
        <pay_code></pay_code>
        <notify_url><![CDATA[http://www.baidu.com/]]></notify_url>
        <goods_detail><![CDATA[商品信息(JSON)]]></goods_detail>
        <extend_params><![CDATA[扩展参数]]></extend_params>
    </scanpay_jsapi_request>
</business_trans>

交易请求报文说明

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

goods_detail 商品信息 (JSONArray)

goods_detail 样例：

[
    {
        "goods_id" : "apple-01",
        "payment_goods_id" : "20010001",
        "goods_name" : "ipad",
        "quantity" : 1,
        "price" : 200000,
        "goods_category" : "34543238",
        "body" : "特价手机",
        "show_url" : "http://www.alipay.com/xxx.jpg"
    },
    {
        "goods_id" : "apple-02",
        "payment_goods_id" : "20010002",
        "goods_name" : "ipad2",
        "quantity" : 1,
        "price" : 200000,
        "goods_category" : "34543239",
        "body" : "特价手机2",
        "show_url" : "http://www.alipay.com/xxx2.jpg"
    }
]

extend_params 扩展参数 (JSON)

分账业务相关的特别说明：
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 样例：

{
    "hb_fq_num": "3",
    "hb_fq_seller_percent": "100",
    "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": "scanpay_jsapi_response",
    "isspid": "39493002",
    "pos_id": "1511300001",
    "pos_seq": "1511300000002",
    "trans_time": "20190904100824",
    "sys_seq": "ff7267efe2ecd9d6",
    "pay_type": "503",
    "pay_id": "wx1416111889934939a66b0e29d91ac20000",
    "pay_info": "{\"appId\":\"wx688b665e1384f3d4\",\"nonceStr\":\"8lpqpovx2sg0q7d82yeg7ffwjiwlt4uc\",\"package\":\"prepay_id=wx1416111889934939a66b0e29d91ac20000\",\"signType\":\"MD5\",\"timeStamp\":1639469478,\"paySign\":\"B7666B47E178D9D675296C7FB5034E89\"}",
    "extend": "",
    "result": {
        "id": "9998",
        "comment": "下单成功，等待用户支付"
    },
    "sign": "F7FF3C26E8AB1D4B6EC382B90D6F7DEA"
}

XML:

<?xml version="1.0" encoding="GBK"?>
<business_trans>
    <response_type>scanpay_jsapi_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>
    <pay_type>503</pay_type>
    <pay_id>wx14161130144714e11437d2e74409780000</pay_id>
    <pay_info><![CDATA[{"appId":"wx688b665e1384f3d4","nonceStr":"587im0sil2i4eo5uqscw64hz4mmjqent","package":"prepay_id=wx14161130144714e11437d2e74409780000","signType":"MD5","timeStamp":1639469490,"paySign":"E39B34536B8597B3970DECEA3A6A2FD4"}]]></pay_info>
    <extend><![CDATA[扩展字段(json格式)]]></extend>
    <result>
        <id>9998</id>
        <comment>下单成功,等待用户支付</comment>
    </result>
</business_trans>

交易返回报文说明

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

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

pay_info 支付信息 (JSON字符串)

支付宝：

返回范例：

...
"pay_info": "{\"tradeNo\":\"2021121422001429701447645503\"}"
...

附1：调用支付宝JS支付文档：https://myjsapi.alipay.com/jsapi/native/trade-pay.html
附2：调用支付宝小程序支付文档：https://opendocs.alipay.com/mini/05xhsr

微信：

返回范例：

...
"pay_info": "{\"appId\":\"wx688b665e1384f3d4\",\"nonceStr\":\"8lpqpovx2sg0q7d82yeg7ffwjiwlt4uc\",\"package\":\"prepay_id=wx1416111889934939a66b0e29d91ac20000\",\"signType\":\"MD5\",\"timeStamp\":1639469478,\"paySign\":\"B7666B47E178D9D675296C7FB5034E89\"}",
...

附：调用微信JS支付文档：https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_4.shtml
无需计算签名，仅需把接口返回的pay_info中字段直接调用微信api即可

银联二维码：

pay_info节点直接返回一个银联支付页的重定向URL

返回范例：

...
"pay_info": "https://qr.95516.com/UP03/qrcGtwWeb-web/front/confirmOrder?sessionId=f6eaaf224bb54b8d837c29a839f1939b",
...

聚分期：

pay_info节点直接返回一个聚分期支付页的重定向URL

返回范例：

...
"pay_info": "https://qr.95516.com/UP03/qrcGtwWeb-web/front/confirmOrder?sessionId=f6eaaf224bb54b8d837c29a839f1939b",
...

使用翼码提供的H5页面唤起支付的方法

以下是使用翼码提供的H5页面唤起支付的调用方法，请按需使用。
如果是自行开发唤起支付的页面只需要看前文中对pay_info的详细描述，有各个支付方式的唤起方式，不需要看以下内容。

测试环境跳转H5支付页面URL：https://ipos-sa.imageco.cn/jsapi_pay

生产环境跳转H5支付页面URL：https://ipos-sa-std.wangcaio2o.com/jsapi_pay

请求方式：GET

中文字符编码：UTF-8

请求参数：

参数名注意大小写，严格区分大小写，参数值注意使用urlencode处理。

调用范例：

https://ipos-sa.imageco.cn/jsapi_pay?pay_id=2018122923011429700544283355&payment_process=02&subject=%e6%94%b6%e6%ac%be%e6%a0%87%e9%a2%98&payee=%E6%94%B6%E6%AC%BE%E6%96%B9%E5%90%8D%E7%A7%B0

页面范例：