全部文档

微信-预下单

请求

POST http://order.hsifue.cn/payment/provider/weixin/unifiedorder

说明

该接口封装微信统一下单功能， 接入方可以通过该接口完成微信APP、H5、JSAPI等支付产品的部分服务端逻辑

参数

参数名

参数类型

参数含义

是否必填

inputCharset

String(8)

字符编码, 固定为UTF-8

是

signType

String(8)

签名算法, 可选择SHA-256, SHA-1, MD5, 推荐使用SHA-256

是

appKey

String(32)

应用Key

是

outOrderId

String(100)

应用的订单标识

是

extra

String(255)

自定义参数, 支付完成后, 支付中心会在回调消息中原样回传

否

dealPrice

Integer

成交价格, 以分为单位

是

subject

String(40)

商品名称

是

product

Integer

支付产品 401:微信Native 402: 微信H5 403: 微信JSAPI 404: 微信APP 405: 微信小程序

是

openid

String(128)

product=403时（即JSAPI支付），此参数必传，此参数为微信用户在商户对应appid下的唯一标识, 获取方式参考微信官方

否

g_signature

String

签名

是

请求示例

 curl -X POST -d "inputCharset=UTF-8&gVersion=1&signType=SHA-256&appKey=KEkEp0AzKhHrbtMMJm0DofCyMDGHk1dj&outOrderId=outOrderId112401&extra=extra&dealPrice=100&subject=中文&g_signature=0290d6015148886a6bb8bd369f1378e8f90a72a7ae4c810d7d8cb3b90c2b574f&product=401" http://order-test.hsifue.cn/payment/provider/weixin/unifiedorder

响应示例

{
    "code": "000000",
    "data": {
        "appId": "wxf0410136c0ed422f",
        "mchId": "1234542402",
        "tradeType": "APP",
        "prepayId": "wx25145815669241633b5d8b7d2147570000",
        "mwebUrl": "http://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx0710432597188431f8ada874ed1cc20000&package=798262050",
        "codeUrl": "weixin://wxpay/bizpayurl?pr=jM4HO6700",
        "appPay": {
            "sign": "1A10AA708FF6D14FD27D5454789F02DD",
            "appid": "wxf0410136c0ed422f",
            "partnerid": "1234542402",
            "prepayid": "wx08103256567401db068a4504e673fa0000",
            "package": "Sign=WXPay",
            "noncestr": "4fbba90f56384cb0a551e0d4eabf234a",
            "timestamp": "1599532376",
        },
        "jsapiPay": {
            "appId": "wx1aa6ac63508f5657",
            "timeStamp": "1616134567",
            "nonceStr": "e9045ccd017341fa90f00b393cb5c86d",
            "signType": "MD5",
            "paySign": "F4356AD4B88B3F2FE4CF96DF7BF3D931",
            "package": "prepay_id=wx19141606992356156df5bde0aee2e50000"
        }
    },
    "message": "成功"
}

响应报文

参数名

参数含义

data.appId

微信应用ID

data.mchId

微信商户号

data.tradeType

微信交易类型， JSAPI: JSAPI支付、NATIVE: Native支付、APP: app支付，MWEB: H5支付

data.prepayId

微信预支付交易会话标识

data.mwebUrl

支付跳转链接， 当支付产品为微信H5时存在

data.codeUrl

二维码链接, 当支付产品为Native时存在

data.appPay

APP端调起支付请求实体, APP端可直接复用该实体做APP支付唤醒调用, 支付类型为微信APP支付时存在

data.jsapiPay

JSAPI支付的请求实体, 产品端可直接复用该实体做JSAPI支付唤醒调用, 支付类型为微信JSAPI或小程序支付时存在

业务状态码

code

message

备注

000000

成功

-

999999

系统异常

-

000008

签名不存在

-

000006

签名非法

-

000002

数据不存在

应用不存在

100003

订单状态不正确

订单状态非待支付