# 1、创建二维码
请求方式
- POST
URL:
/api/v3/qr/createCollectingOrder
- Content-Type:
Content-Type: application/json; charset=utf-8
请求头参数(Header)
Param | Type | Description | Sample |
---|---|---|---|
access_key | String | 商户后台获取的访问密钥 | pFqV75X3 |
timestamp | int64 | Unix 毫秒时间戳(13 位) | 1679724896223 |
nonce | String | UUID V4 随机字符串 | 794c26b0-d33c-4394-b2bb-c485eca16d9e |
sign | String | 通过签名算法计算的签名 | kAXyh+eerqrefyaF8dyFB0M4FVo= |
上述参数全部作为 HTTP Header 传入
请求体数据示例
{
"amount":"10.11",
"channelType":"QRPay",
"currencyType": "INR",
"externalOrderId":"333333333333",
"notifyUrl":"http://127.0.0.1",
"remark":"wsxtest",
"returnUrl": "http://127.0.0.1"
}
参数说明:
参数名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
amount | String | 是 | 收款金额,小数点不能超过 2 位。 |
channelType | String | 是 | 渠道类型,枚举值:QRPay |
currencyType | String | 是 | 币种类型,枚举值:INR BRL |
externalOrderId | String(64) | 是 | 商户系统中的唯一订单编号 |
notifyUrl | String | 是 | 支付完成后回调地址(服务端) |
remark | String | 否 | 商户自定义备注信息 |
returnUrl | String | 否 | 用户支付成功后跳转地址(前端) |
响应类型:
Header: { 'Content-Type': 'application/json;charset=utf-8'}
创建收款响应说明:
正常响应数据示例(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"
}
}
}
响应参数说明
参数名 | 类型 | 描述 |
---|---|---|
cashierUrl | String | 收银台链接,用户跳转至此完成付款 |
currency | String | 币种编码(如 INR) |
orderId | String | 系统订单 ID,由平台生成 |
externalOrderId | String | 商户自定义的订单 ID |
amount | String | 收款金额,支持两位小数 |
tradeNote | String | 订单备注信息 |
payTypeName | String | 支付类型名 |