交易请求报文

JSON:

{
    "request_type": "unifiedorder_request",
    "isspid": "39493002",
    "pos_id": "1511300001",
    "store_id": "1511300001",
    "pos_seq": "1511300000002",
    "user_id": "user01",
    "system_id": "8888",
    "device_ip": "127.0.0.1",
    "memo": "订单备注",
    "unifiedorder_request": {
        "pay_type": "515",
        "trade_type": "JSAPI",
        "tx_amt": "1",
        "buyer_id": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
        "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"
            }
        ],
        "notify_url": "http://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": "59B62BEBCA649C24DC25C44706677423"
}

XML:

<?xml version="1.0" encoding="GBK"?>
<business_trans>
    <request_type>unifiedorder_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>
    <unifiedorder_request>
        <pay_type>515</pay_type>
        <trade_type>JSAPI</trade_type>
        <tx_amt>1</tx_amt>
        <buyer_id>oUpF8uMuAJO_M2pxb1Q9zNjWeS6o</buyer_id>
        <goods_detail><![CDATA[商品信息(JSON)]]></goods_detail>
        <notify_url><![CDATA[http://www.baidu.com/]]></notify_url>
        <extend_params><![CDATA[扩展参数]]></extend_params>
    </unifiedorder_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 样例：

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

交易返回报文

{
    "response_type": "unifiedorder_response",
    "isspid": "39493002",
    "pos_id": "1511300001",
    "pos_seq": "1511300000002",
    "sys_seq": "0311095321465179",
    "trans_time": "20160311095321",
    "pay_type": "515",
    "pay_id": "wx1712341601086258515448c31980502232",
    "nonce_str": "lj1v8w5rqdiftm8zst5gwhjbvebcvyhl",
    "time_stamp": "1571286856",
    "sign_type": "MD5",
    "pay_sign": "9280696fced8329af66d7be472f9e7f6",
    "result": {
        "id": "9998",
        "comment": "下单成功,等待用户支付"
    },
    "sign": "D2E991C64AE4B6AD857A94904BDDB608"
}

<?xml version="1.0" encoding="GBK"?>
<business_trans>
    <response_type>unifiedorder_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>515</pay_type>
    <pay_id>wx1712341601086258515448c31980502232</pay_id>
    <nonce_str>lj1v8w5rqdiftm8zst5gwhjbvebcvyhl</nonce_str>
    <time_stamp>1571286856</time_stamp>
    <sign_type>MD5</sign_type>
    <pay_sign><![CDATA[9280696fced8329af66d7be472f9e7f6]]></pay_sign>
    <result>
        <id>9998</id>
        <comment>下单成功,等待用户支付</comment>
    </result>
</business_trans>

交易返回报文说明

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

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

服务商模式的微信小程序调用支付特别说明

由于微信小程序支付在服务商模式下，在小程序调起支付API时计算签名字段(paySign)必须使用服务商的key，因此由服务商计算好入参与签名后返回给商户进行调用。

小程序调起支付API微信官方文档

调用wx.requestPayment(OBJECT)发起微信支付，Object参数取值说明：

timeStamp 取【统一下单交易】返回的 time_stamp （当接口返回整型时，请先转为字符串后调用微信api）

nonceStr 取【统一下单交易】返回的 nonce_str

package 中 prepay_id 取【统一下单交易】返回的 pay_id，格式如：prepay_id=wx1712341601086258515448c31980502232

paySign 取【统一下单交易】返回的pay_sign

signType 取【统一下单交易】返回的sign_type

以返回报文为例的示例代码：

wx.requestPayment(
{
'timeStamp': '1571286856',
'nonceStr': 'lj1v8w5rqdiftm8zst5gwhjbvebcvyhl',
'package': 'prepay_id=wx1712341601086258515448c31980502232',
'signType': 'MD5',
'paySign': '9280696fced8329af66d7be472f9e7f6',
'success':function(res){},
'fail':function(res){},
'complete':function(res){}
})