下单接口

1、接口说明：

该接口根据客户需要选定支付方式和支付金额，提交后生成订单号，可根据订单号获取支付支付收款码，后续通过该ID获取收款码或查询订单状态；

注：该接口有访问频次限制，最多1s/次，如果频繁访问与支持成功订单不匹配的，一旦发现恶意操作有被停用风险。 

2、接口地址：

POST:https://{url}/api/onlinepay/onlinepay_addorder
Content-Type:application/json

3、提交参数：

参数	是否必填	类型	描述
localusermark	是	str(50)	商户平台的用户唯一识别码，用于商户回调通知处理业务问题
username	否	str(50)	商户平台的用户识别名称，便于商户业务处理，例如a123456
paymentMethod	是	str(10)	可用支付方式，便于付款用户选择支付方式；该值通过配置接口获得，不正确填写会导致失败。使用返回数据的value提交.前往配置接口
price	是	int(8)	可充值金额，便于付款用户选择支付金额；该值通过配置接口获取，不正确填写会导致失败。使用返回数据的price提交.前往配置接口
orderid	是	str(50)	商户平台订单号，  用于商户回调通知处理业务问题
notifyUrl	否	str(255)	订单回调地址，提交后订单状态改变优先根据该地址回调通知商户系统
appid	是	str(15)	商户APPID
sign	是	str(32)	签名，签名算法见

示例:

array(
    'username' => 'xxx用户名称',  #商户平台内充值用户用户名称
    'localusermark' => '123', #本地平台用户标记  用于商户回调通知处理业务问题
    'paymentMethod' => 'zfb',#支付方式，该值通过配置接口活得，否则无效
    'price' => '50',#充值金额，该值通过配置接口获取，否则无效
    'orderid' => '20xxx3452012xxx',#商户业务系统订单号
    'appid' => $this->appid
)

4、返回参数：

返回参数	类型	描述
status	int(4)	1:获取成功，不等于1:获取失败
err/msg	int(50)	status为0时，返回该参数，错误描述
data	obj	status为1时，返回订单信息
data.ordersn	str(50)	订单号，50位以内的UUID

返回示例

{
    "status": 1,
    "data": {
        "data": {
            "ordersn": "R23T13***0PS385"
        }
    }
}

5、搭配接口说明

该接口需要搭配获取二维码接口使用，通过订单号定时请求获得支付二维码。

网络环境的好或负载不高的情况会再5秒内返回可获得支付收款码，详见：

https://www.crossingpay.com/devdocumentation/54.html