# 1、Create QR code for payment

Request Method

  • POST

URL

/api/v3/qr/createCollectingOrder

Content-Type

Content-Type: application/json; charset=utf-8

Header Parameters(Header)

Param Type Description Sample
access_key String Access key obtained from the merchant backend pFqV75X3
timestamp int64 Unix timestamp in milliseconds (13-digit) 1679724896223
nonce String UUID v4 random string 794c26b0-d33c-4394-b2bb-c485eca16d9e
sign String Signature calculated through signature algorithm kAXyh+eerqrefyaF8dyFB0M4FVo=

All the above parameters are passed as HTTP headers

Example of requesting body data

{
  "amount":"10.11",
  "channelType":"QRPay",
  "currencyType": "INR",
  "externalOrderId":"333333333333",
  "notifyUrl":"http://127.0.0.1",
  "remark":"wsxtest",
  "returnUrl": "http://127.0.0.1"
}

Parameter description:

Param Desc Require Sample
amount String required The receiving amount cannot exceed 2 decimal places.
channelType String required Channel type, Enum value: QRPay
currencyType String required Currency type, Enum values: INR, BRL
externalOrderId String(64) required Unique order number in the merchant system
notifyUrl String required Callback address after payment completion (server)
remark String optional Merchant customized note information
returnUrl String optional After successful payment, the user will be redirected to the front-end address

response type:

Header: { 'Content-Type': 'application/json;charset=utf-8'}

Create payment response instructions:

Example of Normal Response Data (HTTP 200)

{
    "code":"200",
    "success":true,
    "msg":"成功",
    "msgEn":"SUCCESS",
        "data":{
        "cashierUrl":"https://qrpay-rupayal.hambit.io/OCURRPAID202504290230071745893807185HAMBIT-U0000000201297532?data=JTdCJTIyY2FzaGllckN1cnJlbmN5QW1vdW50JTIyJTNBMTAwLjExMCUyQyUyMmNhc2hpZXJFeHBp\ncmVUaW1lJTIyJTNBMTc0NTg5NTYwNzIwMSUyQyUyMmNhc2hpZXJJZCUyMiUzQSUyMk9DVVJSUEFJ\nRDIwMjUwNDI5MDIzMDA3MTc0NTg5MzgwNzE4NUhBTUJJVC1VMDAwMDAwMDIwMTI5NzUzMiUyMiUy\nQyUyMmNhc2hpZXJVcmwlMjIlM0ElMjJodHRwcyUzQSUyRiUyRnFycGF5LXJ1cGF5YWwuaGFtYml0\nLmlvJTJGT0NVUlJQQUlEMjAyNTA0MjkwMjMwMDcxNzQ1ODkzODA3MTg1SEFNQklULVUwMDAwMDAw\nMjAxMjk3NTMyJTIyJTJDJTIyY3VycmVuY3klMjIlM0ElMjJJTlIlMjIlMkMlMjJjdXJyZW5jeU9y\nZGVyVm8lMjIlM0ElN0IlMjJhbW91bnQlMjIlM0ExMDAuMTElMkMlMjJjaGFubmVsQmFua0FjY291\nbnROdW1iZXIlMjIlM0FudWxsJTJDJTIyY2hhbm5lbEJhbmtBY2NvdW50VHlwZSUyMiUzQW51bGwl\nMkMlMjJjaGFubmVsQmFua0NvZGUlMjIlM0FudWxsJTJDJTIyY2hhbm5lbEJhbmtOYW1lJTIyJTNB\nbnVsbCUyQyUyMmNoYW5uZWxJZCUyMiUzQTE5MTIwNDc2NDYxOTI5Nzk5NjklMkMlMjJjdXJyZW5j\neSUyMiUzQSUyMklOUiUyMiUyQyUyMmV4dGVybmFsT3JkZXJJZCUyMiUzQSUyMjIwMjUwNDI5MTAz\nMDA1NzcyMDY3JTIyJTJDJTIybWVyY2hhbnRBdmF0YXIlMjIlM0FudWxsJTJDJTIybWVyY2hhbnRO\nYW1lJTIyJTNBJTIyeXVyaTAwMSUyMiUyQyUyMm9yZGVyQWN0dWFsQW1vdW50JTIyJTNBMCUyQyUy\nMm9yZGVySWQlMjIlM0ElMjJPQ1VSUlBBSUQyMDI1MDQyOTAyMzAwNzE3NDU4OTM4MDcyNTVIQU1C\nSVQtVTAwMDAwMDA0MDEyOTc1MzMlMjIlMkMlMjJvcmRlclN0YXR1cyUyMiUzQSUyMkF3YWl0aW5n\nK1BheW1lbnQlMjIlMkMlMjJvcmRlclN0YXR1c0NvZGUlMjIlM0ExJTJDJTIyb3JkZXJUaW1lJTIy\nJTNBMTc0NTg5MzgwNzI0MCUyQyUyMnBheVBhcmFtJTIyJTNBJTIyUXJDb2RlUGF5bWVudCU0MEJ6\nS0l3dlZKRlhCQzNDdkRDY3JNMldraUM3V2V1TGFmRXZYMlFfNTlaXzlWYmJiVVJKSTQtMG5aVTRR\nUVN6empzY3JkbHlsbEt1UUVTMzRvaVdqTHVRJTNEJTNEJTIyJTJDJTIycGF5VHlwZSUyMiUzQTEy\nNyUyQyUyMnBheVR5cGVOYW1lJTIyJTNBJTIycXJjb2RlJTIyJTJDJTIycGF5VXJsJTIyJTNBbnVs\nbCUyQyUyMnBheW1lbnRWb3VjaGVyJTIyJTNBbnVsbCUyQyUyMnJldHVyblVybCUyMiUzQW51bGwl\nMkMlMjJ0cmFkZU5vdGUlMjIlM0ElMjIlMjIlMkMlMjJ1c2VySW5mb05vJTIyJTNBbnVsbCU3RCUy\nQyUyMmlzQ3JlYXRlT3JkZXIlMjIlM0F0cnVlJTJDJTIyaXNIaWRkZW5NZXJjaGFudExvZ28lMjIl\nM0FudWxsJTJDJTIyaXNIaWRkZW5NZXJjaGFudE5hbWUlMjIlM0FudWxsJTJDJTIybWVyY2hhbnRB\ndmF0YXIlMjIlM0FudWxsJTJDJTIybWVyY2hhbnRJZCUyMiUzQTE4OTI5MDcwNTEzMjMyOTc3OTMl\nMkMlMjJtZXJjaGFudE5hbWUlMjIlM0FudWxsJTJDJTIycGF5VHlwZSUyMiUzQTEyNyUyQyUyMnJl\ndHVyblVybCUyMiUzQW51bGwlMkMlMjJ1c2VySW5mb05hbWUlMjIlM0FudWxsJTJDJTIydXNlcklu\nZm9ObyUyMiUzQW51bGwlMkMlMjJ1c2VySW5mb1R5cGUlMjIlM0FudWxsJTJDJTIydmVyc2lvbiUy\nMiUzQSUyMnYxJTIyJTdE",
        "currency":"INR",
        "currencyOrderVo":{
        "orderId":"OCURRPAID202504290230071745893807255HAMBIT-U0000000401297533",
        "externalOrderId":"20250429103005772067",
        "currency":"INR",
        "amount":"100.11",
        "tradeNote":"",
        "payTypeName":"qrcode"
        }
    }
}

Response parameter description

Parameter Name Type Description
cashierUrl String Cashier page link, where the user is redirected to complete the payment
currency String Currency code (e.g., INR)
orderId String System-generated order ID
externalOrderId String Merchant-customized order ID
amount String Payment amount, supports two decimal places
tradeNote String Order remark information
payTypeName String Payment type name