# 1、Create Payment in
This is used by merchants to initiate a payment request, returning a payment link or QR code for the user to complete the payment.
Request Method
- POST
URL:
/api/v3/ind/createCollectingOrder
Content-Type:
Content-Type: application/json; charset=utf-8
Request Header Parameters
| Parameter | Description | Example Value | Required |
|---|---|---|---|
| access_key | Merchant's backend access key | pFqV75X3 | ✅ |
| timestamp | Current timestamp (13 digits) | 1679724896223 | ✅ |
| nonce | Random UUID (v4) | 794c26b0-d33c-4394... | ✅ |
| sign | Signature result (see signing rules) | kAXyh+eerqref... | ✅ |
These parameters are passed as HTTP headers.
Request Body Data Example
{
"amount": "40.20",
"channelType": "BANK",
"externalOrderId": "716134866255702461",
"notifyUrl": "http://192.168.1.135:30001/",
"remark": "123",
"returnUrl": "http://192.168.1.135:30001"
}
Parameter Description:
| Parameter | Type | Description | Example Value | Required |
|---|---|---|---|---|
| amount | String | Payment amount, rounded to two decimal places | 40.2 | ✅ |
| channelType | String | Payment method: BANK | BANK | ✅ |
| externalOrderId | String | Merchant order ID (up to 64 characters) | 716134866255702461 | ✅ |
| notifyUrl | String | Callback URL (supports http/https) | http://xxx.com/notify | ❌ |
| remark | String | Remark (up to 255 characters) | 123 | ❌ |
| returnUrl | String | URL to redirect to after payment completion | http://192.168.1.135:30001 (opens new window) | ❌ |
Response Type
Header: { 'Content-Type': 'application/json;charset=utf-8'}
Response Parameters Example
{
"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\"}"
}
}
}
Response Parameter Description
| Parameter | Type | Description |
|---|---|---|
| cashierUrl | String | Payment page URL for the user to complete the payment |
| orderId | String | System-generated order ID |
| externalOrderId | String | Merchant's custom order ID |
| currency | String | Currency code (e.g., INR) |
| amount | String | Payment amount, supports two decimal places |
| tradeNote | String | Order remark information |
| payParam | String | Payment parameters, used for generating QR code (e.g., UPI standard code) |