提交订单
请求地址
--POST {api_domain}/order/bizOrder
签名验证
请参考签名机制
请求参数
| 参数名 | 必填 | 类型 | 长度 | 说明 | 范例 |
|---|---|---|---|---|---|
| appid | Y | String | 64 | 商户appid | "D09981FB1FE711EAA3B900163E0820B1" |
| client_sn | Y | String | 32 | 商户订单号,同一个商户保持唯一 | "201912111812550055378428" |
| amount | Y | Int | 11 | 付款金额,单位分 | 1000 |
| return_url | Y | String | 128 | 页面跳转同步通知页面路径, 处理完请求后,当前页面自动跳转到商户网站里指定页面的http路径 | "https://www.wtpay8.com" |
| notify_url | N | String | 128 | 服务器异步回调 url | "https://www.wtpay8.com" |
| payway | N | String | 1 | 支付方式。根据传入的支付类型选择支付渠道,如果商户不具有传入类型的支付方式会自动选择其他支付方式的渠道。如果具有默认渠道,将忽略次参数。支付方式见附录 | "1" |
| client_ip | Y | String | 128 | 实际支付终端的IP,要求为ipv4格式,暂不支持ipv6。如果IP与实际发起支付终端IP不符,则可能导致支付失败。 | “8.8.8.8" |
| payer_id | Y | string | 128 | 实际支付用户在商户内的唯一识别码,如果商户开启限制用户多次重复下单功能,则必须传入此参数,未开启时可忽视此参数 | "1263761123" |
返回参数
| 参数名 | 必填 | 类型 | 长度 | 说明 | 范例 |
|---|---|---|---|---|---|
| result_code | Y | String | 16 | 返回SUCCESS成功,其他表示失败 | SUCCESS |
| return_msg | N | String | 128 | 返回信息,如非空,为错误原因 | 参数错误 |
- 以下字段在return_code为SUCCESS的时候有返回
| 参数名 | 必填 | 类型 | 长度 | 说明 | 范例 |
|---|---|---|---|---|---|
| appid | Y | String | 32 | 商户 appid | "D09981FB1FE711EAA3B900163E0820B1" |
| client_sn | Y | String | 32 | 商户订单号,同一个商户保持唯一 | "201912111812550055378428" |
| amount | Y | Int | 11 | 商户付款金额,实际支付金额以异步回调amount为准,单位分 | 10000 |
| actual_amount | Y | Int | 11 | 调整后的订单金额,实际支付金额以异步回调amount为准,单位分 | 10000 |
| fee | Y | Int | 11 | 订单手续费,单位分 | 1000 |
| sn | Y | String | 32 | 系统内部唯一订单号 | "668DC0281BFC11EAADB400163E0820B1" |
| pay_url | Y | String | 255 | 支付页面链接 | "https://www.wtpay8.com" |