1.1 QR Code 创建

HTTP请求信息

URL

{domain}/open-api/v2/jt/qrcode

请求方式

POST

Content-Type

application/json

请求体参数

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

param 参数

参数名	是否必填	类型	说明
timestamp	是	long	当前时间戳
channelCode	是	string	渠道码，固定值 THAI_DYNAMIC_QR
mchOrderId	是	string	商户订单号，字母+数字，最大长度32
amount	是	integer	金额，多单COD总金额，单位分
businessType	否	integer	业务类型， 1、直营店（不传默认为-直营店） 2、加盟店
projectType	否	string	项目类型， PPCASH,VIP,HOME（不传默认为PPCASH）
notifyUrl	是	string	商户交易通知 URL
items	否	List	子订单详情
remark	否	string	备注

item 参数说明

参数名	必选	类型	description
subOrderId	是	string	子订单编号 格式：字母+数字，1-32位
customerName	否	string	用户姓名，格式：字母+空格，1-100位, "firstName middleName lastName" (middleName 非必填)
customerMobile	否	string	用户手机号(手机格式：06,08,09+8位数字（共10位）座机格式：02,03,04,05,07+7位数字（共9位）)
amount	是	int	金额必传例如500.10, 需要设置50010分
email	否	string	用户邮箱
regionNo	是	string	大区编码(1-50 位);支持大小写字母和数字
branchNo	是	string	网点编码(1-100 位);支持大小写字母和数字
courierNo	是	string	快递员编码(1-100 位);支持大小写字母和数字
courierName	否	string	快递员姓名(1-50 位)
courierMobile	否	string	快递员手机号(手机格式：06,08,09+8位数字（共10位）座机格式：02,03,04,05,07+7位数字（共9位）)

响应参数

参数名	类型	说明
mchOrderId	string	商户订单号，字母+数字，最大长度32
qrCodeId	string	QR Code 交易 ID
qrCodeContent	string	QR Code 内容
channelCode	string	渠道码
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更新时间
amount	integer	金额，多单COD总金额，单位分
fee	integer	手续费，单位分
totalAmount	integer	总金额（二维码金额），单位分
businessType	integer	业务类型， 1、直营店（不传默认为-直营店） 2、加盟店
projectType	string	项目类型， PPCASH,VIP,HOME（不传默认为PPCASH）
items	List	子订单详情

请求示例

param 内容

{
  "timestamp": 1676017834369,
  "channelCode": "THAI_DYNAMIC_QR",
  "mchOrderId": "PC880001",
  "businessType": 1,
  "projectType": "PPCASH",
  "amount": 140000,
  "notifyUrl": "https://example.com/",
  "items": [
    {
      "subOrderId": "PCW00000000003249",
      "customerName": "WalletUser Name",
      "customerMobile": "60128888888",
      "amount": 60000,
      "email": "example@example.com",
      "regionNo": "001",
      "branchNo": "F604602",
      "courierNo": "F6046024088",
      "courierName": "Courier Name",
      "courierMobile": "0912345678"
    },
    {
      "subOrderId": "PCW00000000003250",
      "customerName": "WalletUser Name",
      "customerMobile": "60128888888",
      "amount": 80000,
      "email": "example@example.com",
      "regionNo": "001",
      "branchNo": "F604602",
      "courierNo": "F6046024088",
      "courierName": "Courier Name",
      "courierMobile": "0912345678"
    }
  ],
  "remark": "remark"
}

如何构造请求体

请求体

{
  "appId": "c9b002aef1d7496c9df078d937896605",
  "sign": "tVa+aoAXH0ls1IoPznzkFyF+4v+iTZaCSttPWmYl1kCHeh8mwao8cqAD7Y7wdymcr9yavKh4bKT18KeLu27g7Q5GqhEQ0cm1dkARe+i2xoH32la4HAzBfPj9liULDawGoPbo739+FLgZnV79CLaiukvqtnkgI/Km6J/KccRPl2CtS4PUjxCyRicOAcv91KZiVOxyhoP9bKhvwtCkCIlkpBHKWskBPCxxfctoORjgXWj7FhRPLYBuRDaczfmr2um9aNXhVoH1XFZf7Gu67n6RmeB0kc2dHFPI89JEI0PwGq+bvbCAEUtHK4SlLexCtbMoCgGWKTJbSMDTvVF126jz8g==",
  "param": "{\"timestamp\":1676017834369,\"channelCode\":\"THAI_DYNAMIC_QR\",\"mchOrderId\":\"PC880001\",\"businessType\":1,\"amount\":140000,\"notifyUrl\":\"https://example.com/\",\"items\":[{\"subOrderId\":\"PCW00000000003249\",\"customerName\":\"WalletUser Name\",\"customerMobile\":\"09123456789\",\"amount\":60000,\"email\":\"pay@example.com\",\"regionNo\":\"001\",\"branchNo\":\"F604602\",\"courierNo\":\"F6046024088\",\"courierName\":\"Courier Name\",\"courierMobile\":\"09123456789\"},{\"subOrderId\":\"PCW00000000003250\",\"customerName\":\"WalletUser Name\",\"customerMobile\":\"09123456789\",\"amount\":80000,\"email\":\"pay@example.com\",\"regionNo\":\"001\",\"branchNo\":\"F604602\",\"courierNo\":\"F6046024088\",\"courierName\":\"Courier Name\",\"courierMobile\":\"09123456789\"}],\"remark\":\"remark\"}"
}

响应示例

响应码集合

{
  "code": 10000,
  "message": "Success",
  "data": {
    "mchOrderId": "PC880001",
    "qrcodeId": "QR1597145776390279168",
    "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": "THAI_DYNAMIC_QR",
    "notifyUrl": "https://example.com/",
    "createTime": "2022-07-02 18:12:46",
    "updateTime": null,
    "remark": "test qrcode",
    "transactionStatus": "PENDING",
    "qrStatus": "ACTIVE",
    "amount": 140000,
    "fee": 2000,
    "totalAmount": 142000,
    "businessType": 1,
    "projectType": "PPCASH",
    "items": [
      {
        "subOrderId": "PCW00000000003249",
        "customerName": "WalletUser Name",
        "customerMobile": "60128888888",
        "amount": 60000,
        "email": "example@example.com",
        "regionNo": "001",
        "branchNo": "F604602",
        "courierNo": "F6046024088",
        "courierName": "Courier Name",
        "courierMobile": "0912345678"
      },
      {
        "subOrderId": "PCW00000000003250",
        "customerName": "WalletUser Name",
        "customerMobile": "60128888888",
        "amount": 80000,
        "email": "example@example.com",
        "regionNo": "001",
        "branchNo": "F604602",
        "courierNo": "F6046024088",
        "courierName": "Courier Name",
        "courierMobile": "0912345678"
      }
    ],
    "warning": ""
  }
}