1 QR Code 创建

HTTP请求信息

URL

{domain}/open-api/qr/generate

请求方式

POST

请求头

参数名	必选	类型	说明
Content-Type	mandatory	string	application/json

请求体参数

参数名	必选	类型	长度限制	示例	说明
appId	是	string	-	-	应用APPID
param	是	string	-	-	参数体
sign	是	string	-	45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892	签名

请求参数

参数名	是否必填	类型	说明
timestamp	是	long	当前时间戳
channelCode	是	string	渠道码
mchOrderId	是	string	商户订单号，字母+数字，最大长度32
amount	否	long	金额，动态码必传，范围：1-10,000,000
notifyUrl	是	string	商户交易通知 URL
mobile	否	string	用户手机号
customerName	否	string	用户名，最大长度100
email	否	string	用户邮箱
remark	否	string	备注

channelCode 参考此列表

响应参数

参数名	类型	说明
mchOrderId	string	商户订单号，字母+数字，最大长度32
qrCodeId	string	QR Code 交易 ID
qrCodeContent	string	QR Code 内容
channelCode	string	渠道码
notifyUrl	string	商户交易通知 URL
remark	string	备注
qrStatus	string	交易状态(ACTIVE,INACTIVE, CANCELLED)
createTime	string	QR Code创建时间
updateTime	string	QR Code更新时间

请求示例

param 内容

动态码

{
  "timestamp": 1676017834369,
  "channelCode": "QRIS_DYNAMIC_QR",
  "mchOrderId": "OrderM000100075",
  "amount": 20000,
  "notifyUrl": "https://example.com/",
  "customerName": "user01",
  "email": "platform@gmail.com",
  "mobile": "09123456786",
  "remark": "TEST"
}

静态码

{
  "timestamp": 1676017834369,
  "channelCode": "QRIS_STATIC_QR",
  "mchOrderId": "OrderM000100075",
  "notifyUrl": "https://example.com/",
  "customerName": "user01",
  "email": "platform@gmail.com",
  "mobile": "09123456786",
  "remark": "TEST"
}

如何构造请求体

请求体

{
  "appId": "cbce490e82f841f2b3162a8dd27e9fd1",
  "sign": "*********************",
  "param": "{\"mchOrderId\":\"OrderM000100075\",\"amount\":20000,\"customerName\":\"user01\",\"channelCode\":\"QRIS_DYNAMIC_QR\",\"remark\":\"TEST\",\"email\":\"platform@gmail.com\",\"mobile\":\"09123456786\",\"notifyUrl\":\"https://example.com/\",\"timestamp\":1676017834369"
}

响应示例

响应码集合

{
  "code": 10000,
  "message": "Success",
  "data": {
    "mchOrderId": "OrderM000100075",
    "qrCodeId": "QR1702212882214817792",
    "qrCodeContent": "MDAwMjAxMDEwMjEyMjY3MzAwMjFDT00uR1VEQU5HVk9VQ0hFUi5XV1cwMTE4OTM2MDA5MTYzMDA0MDczNDAzMDIxNUdWMjEwMDAwNDA3MzQwMzAzMDNVQkU1MTQ1MDAxNUlELk9SLkdQTlFSLldXVzAyMTVJRDIwMjMyNjI4ODQ3NzgwMzAzVUJFNTIwNDY1MzM1MzAzMzYwNTQwNTIwMDAwNTgwMklENTkwNkJsdWV6aTYwMTNKQUtBUlRBIEJBUkFUNjEwNTExNjMwNjIzMzAxMDgwNDI4MDExMTA1MTcyMzA3MDYxNDU5NDV0VFNFcTYzMDRGOERC",
    "channelCode": "QRIS_DYNAMIC_QR",
    "notifyUrl": "https://example.com/",
    "remark": "TEST",
    "qrStatus": "ACTIVE",
    "createTime": "2023-09-14 14:49:11"
  }
}