1、基本内容
接口地址:
/api/onlinepay/onlinepay_addorder
请求类型:POST
接口说明:线上支付方式,提交用户充值订单,提交后返回订单id,便于后续通过该ID获取收款码或查询订单状态;
注:该接口有访问频次限制,最多5s/次,如果频繁访问与支持成功订单不匹配的,有被停用风险。
2、提交参数
参数 | 是否必填 | 描述 |
username | 否 | 客户平台用户名,例如a123456 |
localusermark | 是 | 本地平台用户标记 用于商户回调通知处理业务问题 |
paymentMethod | 是 | 已有支付方式,该值通过配置接口获得,不正确填写会导致失败。使用返回数据的value提交.前往配置接口 |
price | 是 | 需充值金额,该值通过配置接口获取,不正确填写会导致失败。使用返回数据的price提交.前往配置接口 |
orderid | 是 | 商户平台订单号, 用于商户回调通知处理业务问题 |
appid | 是 | 商户APPID |
sign | 是 | 签名 |
示例:
array( 'username' => 'xxx用户名称', #商户平台内充值用户用户名称 'localusermark' => '123', #本地平台用户标记 用于商户回调通知处理业务问题 'paymentMethod' => 'zfb',#支付方式,该值通过配置接口活得,否则无效 'price' => '50',#充值金额,该值通过配置接口获取,否则无效 'orderid' => '20xxx3452012xxx',#商户业务系统订单号 'appid' => $this->appid )
3、返回参数
返回参数 | 描述 |
status | 1:获取成功,不等于1:获取失败 |
err/msg | status为0时,返回该参数,错误描述 |
data | status为1时,返回订单信息 |
data.ordersn | 订单号,50位以内的UUID |
4、返回示例
{ "status": 1, "data": { "data": { "ordersn": "R23T13***0PS385" } } }
5、搭配接口说明
该接口需要搭配获取二维码接口使用,通过订单号定时请求获得支付二维码。
网络环境的好或负载不高的情况会再5秒内返回可获得支付收款码,详见:
https://www.crossingpay.com/devdocumentation/47.html