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