1. QR Code 创建

HTTP请求信息

URL

{domain}/open-api/qr/generate

请求方式

POST

Content-Type

application/json

请求参数

参数名	是否必填	类型	length	说明
timestamp	是	long	-	当前时间戳
channelCode	是	string	-	渠道码，参考QR渠道码列表
mchOrderId	是	string	1-32	商户订单号，字母+数字，最大长度32
amount	是	integer	-	金额，单位分
notifyUrl	是	string	1-256	商户交易通知 URL
customerName	否	string	1-128	用户名，最大长度100
email	否	string	1-128	用户邮箱
mobile	否	string	10-11	用户手机号 01开头 长度最大10位
remark	否	string	1-256	备注
expireSeconds	否	integer	-	过期时间，单位秒，范围30～3600，默认3600

响应参数

参数名	是否必填	类型	说明
mchOrderId	是	string	商户订单号，字母+数字，最大长度32
transactionId	否	string	QR Code 交易 ID
qrCodeContent	是	string	QR Code 内容
channelCode	是	string	渠道码，参考QR渠道码列表
notifyUrl	是	string	商户交易通知 URL
remark	否	string	备注
qrStatus	是	string	QR Code 状态 (ACTIVE, INACTIVE, CANCELLED)
transactionStatus	是	string	交易状态 (PENDING, COMPLETED, FAILED)
qrLink	否	string	用户还款指引
createTime	否	string	QR Code创建时间
updateTime	否	string	QR Code更新时间
expiresTime	是	string	过期时间

请求示例

param 内容

{
  "timestamp": 1676017834369,
  "channelCode": "DUITNOW_DYNAMIC_QR",
  "mchOrderId": "PC880001",
  "amount": 1000,
  "notifyUrl": "https://example.com/",
  "customerName": "Raja",
  "email": "raja@example.com",
  "mobile": "60128888888",
  "remark": "example",
  "expireSeconds": 300
}

如何构造请求体

请求体

{
  "appId": "c9b002aef1d7496c9df078d937896605",
  "sign": "tVa+aoAXH0ls1IoPznzkFyF+4v+iTZaCSttPWmYl1kCHeh8mwao8cqAD7Y7wdymcr9yavKh4bKT18KeLu27g7Q5GqhEQ0cm1dkARe+i2xoH32la4HAzBfPj9liULDawGoPbo739+FLgZnV79CLaiukvqtnkgI/Km6J/KccRPl2CtS4PUjxCyRicOAcv91KZiVOxyhoP9bKhvwtCkCIlkpBHKWskBPCxxfctoORjgXWj7FhRPLYBuRDaczfmr2um9aNXhVoH1XFZf7Gu67n6RmeB0kc2dHFPI89JEI0PwGq+bvbCAEUtHK4SlLexCtbMoCgGWKTJbSMDTvVF126jz8g==",
  "param": "{\"timestamp\":1676017834369,\"channelCode\":\"DUITNOW_DYNAMIC_QR\",\"mchOrderId\":\"PC880001\",\"amount\":1000,\"notifyUrl\":\"https://example.com/\",\"customerName\":\"Raja\",\"email\":\"raja@example.com\",\"mobile\":\"60128888888\",\"remark\":\"example\",\"expireSeconds\":300}"
}

响应示例

响应码集合

{
  "code": 10000,
  "message": "Success",
  "data": {
    "mchOrderId": "PC880001",
    "transactionId": "C1051669624201385891",
    "qrCodeContent": "iVBORw0KGgoAAAANSUhEUgAAAGQAAABkCAIAAAD/gAIDAAAACXBIWXMAAA7EAAAOxAGVKw4bAAACV0lEQVR4nO2cwY7CMAwF6Wr//5fZW1WJbOKx3QDSzBHatHpyzIsTfDyfz4fE+Hn3C3wTigVQLIBiARQL8Pv60XEcXaOfP7XnmPEf3+FrzG+/482vGFkAxQIoFmCQs64k/P0811y/HX7Y9Rpdb37FyAIoFmAxDU+6ZsrysuEF86cX/UR8whpZAMUCKBYgmrOKDJc78TXQh1QojSyAYgE2TcO4WU8UG7ZhZAEUC6BYgGjO6soaQ+sQZ1i0iD+xiJEFUCzAYhp2bQEkNiyWXn8+ZuPmxYmRBVAsgGIBjs0riXjdMuES7sbIAigWIDoNi/t9xVrC3DrEB4y7Dc86VFEsQGkhHQ/7+GWVOZ77AY17fSMLoFgAxQJEj0nGawBzirWEBMuEGM+SRhZAsQCZfcPKWjc3KeaGe/7openROtyCYgEUC5Ap/sWtQ+UA4x3rlWKWNLIAigXIFP+GVKzD8kHBmdLlNv7DyAIoFkCxAIuqw3ytMMwvxUMGibXLnMaDmUYWQLEAC+sQN9mViuBy8OGAc+swHyeHkQVQLIBiAQY5q7HC/0ouzXUdhIwnaK1DFcUCbDr5124sriQmV+5UhJEFUCzApi5HxeVxcBbnin8upG9BsQCKBdjU5WiYLNpdS7HlwfJ2IwugWIDdXY5yD7q16h/HyAIoFkCxAB/XXuX1ltyV/kf6zSgWYHezsSE52zFv3Bx3G578uwXFAigWYFOXo1v7uHf9w8KqQyeKBdjU5Wg4YHA747HaaOhqla516ESxAIoF2N3l6KsxsgCKBVAsgGIBFAugWIA/BQySrn6cOmYAAAAASUVORK5CYII=",
    "channelCode": "DUITNOW_DYNAMIC_QR",
    "notifyUrl": "https://example.com/",
    "remark": "example",
    "qrStatus": "ACTIVE",
    "transactionStatus": "PENDING",
    "qrLink": null,
    "createTime": "2022-11-28 16:30:01",
    "updateTime": null,
    "expiresTime": "2023-12-31 23:00:00"
  }
}