统一下单接口


网关地址

https://www.wandipay.com/do.htm

请求参数

同时支持GETPOST请求,由于移动浏览器POST至新窗口可能导致参数丢失,建议使用GET方式。

参数名 必填 类型 说明 示例
app_id String 商户编号,开通商户后可见 2021061953971009
out_trade_no String[10,50] 商户订单号 2021051053501015
total_fee String / Array 支付金额,String单位:分,Array单位:元 100 / [10,30,50,100,"*,5"]
subject String[1,80] 订单标题 某网-账户充值
return_url string[10,300] 同步跳转地址
notify_url string[10,300] 异步回调地址
timestamp string[10] 当前时间戳(十位) 1622458399
scene_id string[0,20] 支付场景 A网站支付 / B网站支付
remark string[0,32] 附加数据,原样回调 {"uid":6}

请求参数详细说明

参数名 详细说明
app_id 商户编号,开通商户后可见。
out_trade_no 商户订单号,可在异步回调中通过订单号处理业务逻辑(也可以使用附加数据),如留空,则自动生成。
total_fee 支付金额,支持传入固定金额,金额组,或留空。
    1. 留空,需要支付者手动输入付款金额,确认后进入付款页。
    2. 固定金额,单位为:分,直接进入付款页。
    3. 金额数组,单位为:元,URLEncode utf-8编码,用户需要选择某个金额付款,例:[10,30,50,"*,5"] ,"*,5" 表示支持手动输入,最低5元。
subject 订单标题,URLEncode utf-8编码,用于在支付页展示给用户,如留空,则使用签约时的商户名称(简称)。
notify_url 异步通知地址,用户支付完毕后,万迪支付通过POST方式将支付参数异步反馈至此地址,商户可根据异步消息处理业务逻辑,异步通知必须经过签名验证,防止伪造数据。如未设置,则不进行异步通知。此地址不支持传入GET参数。
正确示例:https: //www.xxx.com/notify.htm
错误示例:https: //www.xxx.com/notify.htm?id=666
return_url 同步跳转地址,用户支付完毕后展示账单页,账单页底部的返回按钮将会已GET方式携带支付参数跳转到同步地址,如未设置,则不跳转。此地址不支持传入GET参数。
正确示例:https: //www.xxx.com/return.htm
错误示例:https: //www.xxx.com/return.htm?id=666
timestamp 当前时间戳(十位)
scene_id 支付场景,多站使用同一APPID时,做数据区分。URLEncode utf-8编码
remark 附加数据,原样回调,URLEncode utf-8编码

错误码表

错误码 内容
APPID_ERR APPID错误。
OUT_TRADE_NO_ERR 订单号长度不符。
TOTAL_FEE_ERR 支付金额有误。
SUBJECT_ERR 订单标题长度不符。
NOTIFY_URL_ERR 异步回调地址有误。
RETURN_URL_ERR 同步跳转地址有误。
TIMESTAMP_ERR 时间戳错误,请提交十位时间戳。