# 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)