2.1 收款下单接口

简要描述

• 商户代付-收单接口

请求URL

• /api/v1/payment

请求方式

• POST

请求头

参数名	必选	类型	说明
Content-Type	mandatory	string	application/json

请求参数

参数名	必选	类型	长度限制	示例	说明
appId	是	string	-	-	应用APPID
appName	是	string	1-100	-	商户对接应用名称, 格式：字母+空格，1-100位
mchOrderId	是	string	1-32	CCP20220428011068111	商户订单id, 格式：字母+数字，1-32位
amount	是	int	100-5000000	50000	收款金额（单位为分） 例如PHP:500.10, 需要设置50010分
customerName	否	string	1-100	-	付款人姓名
channelCode	是	string	-	-	PayCools收单渠道Code
email	是	string	-	-	顾客邮箱，可能用于接收支付通知或展示于支付确认页，如无此信息，请上传商户邮箱。 格式：邮箱格式
mobile	是	string	11	-	顾客电话，可能用于接收支付通知或展示于支付确认页，如无此信息，请上传商户电话。 格式：09 开头，纯数字, 共11位
remark	否	string	-	-	收单备注
sign	是	string	-	45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892	签名
callbackUrl	是	string	1-100	-	回调地址，用于发送交易通知
redirectUrl	是	string	1-100	-	当交易完成后将跳转至此URL

返回示例

{
    "code": 1000,
    "message": "success",
    "data": {
        "redirectUrl": "https://a.api-uat.paycools.com/1L9zPnp",
        "transactionStatus": "PENDING",
        "transactionId": "C1175676368800878371"
    }
}

说明: redirectUrl字段对应的链接有效期为1小时，超过此时间，此链接将失效

返回失败案例 code参考列表 参考列表

{
    "code":1002,
    "message":"merchant white ip forbidden"
}