跨越支付 开发文档

线上支付创建预支付单

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、返回参数

返回参数描述
status1:获取成功,不等于1:获取失败
err/msgstatus为0时,返回该参数,错误描述
datastatus1时,返回订单信息
data.ordersn订单号,50位以内的UUID


4、返回示例

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


5、搭配接口说明

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

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

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