# 1、创建收款
请求方式
- POST
请求 URL:
/api/v3/ind/createCollectingOrder
Content-Type:
Content-Type: application/json; charset=utf-8
请求头参数
参数名 | 描述 | 示例值 | 必填 |
---|---|---|---|
access_key | 商户后台获取的密钥 | pFqV75X3 | ✅ |
timestamp | 当前时间戳(13位) | 1679724896223 | ✅ |
nonce | 随机 UUID(v4) | 794c26b0-d33c-4394... | ✅ |
sign | 签名结果(见签名规范) | kAXyh+eerqref... | ✅ |
上述参数全部作为 HTTP Header 传入
请求体数据示例
{
"amount": "40.20",
"channelType": "BANK",
"externalOrderId": "716134866255702461",
"notifyUrl": "http://192.168.1.135:30001/",
"remark": "123",
"returnUrl": "http://192.168.1.135:30001"
}
参数说明:
参数名 | 类型 | 描述 | 示例值 | 必填 |
---|---|---|---|---|
amount | String | 收款金额,保留两位小数 | 40.2 | ✅ |
channelType | String | 支付方式:BANK / UPI | BANK | ✅ |
externalOrderId | String | 商户订单号(最大64位) | 716134866255702461 | ✅ |
notifyUrl | String | 回调地址(支持 http/https) | http://xxx.com/notify | ❌ |
remark | String | 备注信息(最多255字符) | 123 | ❌ |
returnUrl | String | 支付完成后跳转地址 | http://192.168.1.135:30001 | ❌ |
响应类型
Header: { 'Content-Type': 'application/json;charset=utf-8'}
响应参数
{
"code": "200",
"success": true,
"msg": "成功",
"msgEn": "SUCCESS",
"data": {
"cashierUrl": "http://192.168.1.74:88/OCURRPAID202308220659471692687587416DOCK02OO0000000200003651?data=eyJjYXNoaWVyQ3VycmVuY3lBbW91bnQiOjQwLjIwLCJjYXNoaWVyRXhwaXJlVGltZSI6MTY5MjY4OTM4NzY1OCwiY2FzaGllcklkIjoiT0NVUlJQQUlEMjAyMzA4MjIwNjU5NDcxNjkyNjg3NTg3NDE2RE9DSzAyT08wMDAwMDAwMjAwMDAzNjUxIiwiY2FzaGllclVybCI6Imh0dHA6Ly8xOTIuMTY4LjEuNzQ6ODgvT0NVUlJQQUlEMjAyMzA4MjIwNjU5NDcxNjkyNjg3NTg3NDE2RE9DSzAyT08wMDAwMDAwMjAwMDAzNjUxIiwiY3VycmVuY3kiOiJJTlIiLCJjdXJyZW5jeU9yZGVyVm8iOnsiYW1vdW50Ijo0MC4yMCwiY3VycmVuY3kiOiJJTlIiLCJleHRlcm5hbE9yZGVySWQiOiI3MTYxMzQ4NjYyNTU3MDI0NjEiLCJtZXJjaGFudE5hbWUiOiJhYXJvbiIsIm9yZGVySWQiOiJPQ1VSUlBBSUQyMDIzMDgyMjA2NTk0NzE2OTI2ODc1ODc2OTFET0NLMDJPTzAwMDAwMDA0MDAwMDM2NTIiLCJvcmRlclN0YXR1cyI6IldhaXQgcGF5Iiwib3JkZXJTdGF0dXNDb2RlIjoxLCJvcmRlclRpbWUiOjE2OTI2ODc1ODc2ODEsInBheVBhcmFtIjoiaHR0cHM6Ly9yYXJwYXkudGVzdC5yYXJwYXkuY29tL2luZGV4L3BheS9tY2h0ZXN0cGFnZS90cC9kZC9vcmRlcm51bS8yMzA4MjIxNzAyNjFMWHZEWU0iLCJwYXlUeXBlIjoxMDIsInBheVR5cGVOYW1lIjoiQkFOSyIsInBheVVybCI6Imh0dHBzOi8vcmFycGF5LnRlc3QucmFycGF5LmNvbS9pbmRleC9wYXkvbWNodGVzdHBhZ2UvdHAvZGQvb3JkZXJudW0vMjMwODIyMTcwMjYxTFh2RFlNIiwidHJhZGVOb3RlIjoiMTIzIn0sImlzQ3JlYXRlT3JkZXIiOnRydWUsIm1lcmNoYW50SWQiOjE2NjMzNzEzOTk3MTAyMTYxOTQsInBheVR5cGUiOjEwMiwicmV0dXJuVXJsIjoiaHR0cDovLzE5Mi4xNjguMS4xMzU6MzAwMDEiLCJ2ZXJzaW9uIjoidjEifQ==\u0026pm=W3siY3VycmVuY3lUeXBlIjoiTVhOIiwicGF5VHlwZXMiOlt7ImNvZGUiOjEwMiwidmFsdWUiOiJCQU5LIn1dfSx7ImN1cnJlbmN5VHlwZSI6IlBFTiIsInBheVR5cGVzIjpbeyJjb2RlIjoxMDIsInZhbHVlIjoiQkFOSyJ9XX0seyJjdXJyZW5jeVR5cGUiOiJJTlIiLCJwYXlUeXBlcyI6W3siY29kZSI6MTAyLCJ2YWx1ZSI6IkJBTksifV19LHsiY3VycmVuY3lUeXBlIjoiQlJMIiwicGF5VHlwZXMiOlt7ImNvZGUiOjEwMSwidmFsdWUiOiJQSVgifV19XQ==",
"currency": "INR",
"currencyOrderVo": {
"orderId": "OCURRPAID2023xxxxxxx",
"externalOrderId": "716134866255702461",
"currency": "INR",
"amount": "40.2",
"tradeNote": "123",
"payParam":"{\"channelBankCode\":\"-\",\"channelBankName\":\"yy\",\"channelBankAccountNumber\":\"yyyy\"}"
}
}
}
响应参数说明
参数名 | 类型 | 描述 |
---|---|---|
cashierUrl | String | 收银台链接,用户跳转至此完成付款 |
orderId | String | 系统订单 ID,由平台生成 |
externalOrderId | String | 商户自定义的订单 ID |
currency | String | 币种编码(如 INR) |
amount | String | 收款金额,支持两位小数 |
tradeNote | String | 订单备注信息 |
payParam | String | 支付参数,可用于生成二维码(如 UPI 标准码) |