# 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 支付类型名