1. 统一下单

接口描述

业务通过统一下单接口可以发起任意三方支付渠道的支付订单。业务系统不必关心该如何调用三方支付，统一下单接口会根据业务系统选择的支付渠道ID，选择对应支付渠道的支付产品，发起下单请求，然后响应给业务系统支付请求所需参数。

业务流程

接口链接

测试URL地址：http://api.xxpay.org/api/pay/create_order

注意：以上测试地址为XxPay官方提供，可通过测试商户，去三方支付渠道下单。

测试商户：

请求参数

extra参数说明

当请求参数channelId = WX_JSAPI （微信公众号支付）时，openId参数必填，对应用户所在微信公众号的openId。

{"openId":"o2RvowBf7sOVJf8kJksUEMceaDqo"}

当请求参数channelId = WX_NATIVE （微信原生扫码支付）时，productId参数必填，对应业务系统定义的商品ID。

{"productId":"120989823"}

当请求参数channelId = ALIPAY_WAP （支付宝WAP支付）时，可传参数ali_show_url，表示用户付款中途退出返回商户网站的地址。不传默认地址为：www.xxpay.org。

{"ali_show_url":"http://www.xiaoshuding.com"}

当请求参数channelId = ALIPAY_PC （支付宝PC支付）时，可传参数qr_pay_mode、qrcode_width。

{"qr_pay_mode":"4", "qrcode_width":"200"}

qr_pay_mode：扫码支付的方式，支持前置模式和跳转模式(4：直接显示二维码，2：跳转模式)默认为4。
qrcode_width：当qr_pay_mode=4时，该参数生效，表示二维码宽度。

返回结果

以下字段在retCode为SUCCESS的时候有返回

以下字段在retCode和resCode都为SUCCESS的时候有返回

当请求参数channelId=WX_JSAPI（微信公众号支付）时，回JSON格式数据，如：

{
    "sign": "24F5916D6B1AB64918B3BF7250693813", 
    "payOrderId": "P2016081612553098759124940", 
    "retCode": "SUCCESS", 
    "retMsg": "", 
    "resCode": "SUCCESS", 
    "prepayId": "wx201608161255321fc59e085b0578219742",
    "payParams": {
        "appId": "wx0ab67caf7f591834", 
        "timeStamp": 1471323332, 
        "signType": "MD5", 
        "package": "prepay_id=wx201608161255321fc59e085b0578219742", 
        "nonceStr": "08s06nujam43aot3tbl555lavvydl178", 
        "paySign": "21E6BF4984030DBD2DB191F676A47DA2"
    }
}

当请求参数channelId=WX_NATIVE（微信公众号扫码支付）时，回JSON格式数据，如：

{
    "sign": "3424ED83034B20CF17961720FE272A94", 
    "payOrderId": "pay2016081613050939023127932", 
    "retCode": "SUCCESS", 
    "retMsg": "", 
    "codeUrl": "weixin://wxpay/bizpayurl?pr=sHYHnns", 
    "resCode": "SUCCESS", 
    "payItemId": "6020007", 
    "prepayId": "wx20160816130510b9688b1a720825571177"
}

当请求参数channelId=WX_APP（微信APP支付），返回JSON格式数据，如：

{
    "sign": "37343EE31A118185337D0ECA502B33D5", 
    "payOrderId": "pay2016081611532546033924463", 
    "retCode": "SUCCESS", 
    "retMsg": "", 
    "resCode": "SUCCESS", 
    "prepayId": "wx2016081611532915ae15beab0167893571", 
    "payParams": {
        "sign": "159ABABAE6F8A0F4641A34A38251E7BB", 
        "timestamp": 1471319614, 
        "noncestr": "mhctew72bf3kfrr4jmv79zigbpgrmv5h", 
        "partnerid": "1367655402", 
        "prepayid": "wx2016081611532915ae15beab0167893571", 
        "package": "Sign=WXPay", 
        "appid": "wxa095d1d71c33c151"
    }
}