https://www.wandipay.com/do.htm
同时支持GET
或POST
请求,由于移动浏览器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 | 时间戳错误,请提交十位时间戳。 |