使用令牌进行购买
端点
https://ccapi.iotpaycloud.com/v3/cc_purchasewithtoken
方法
POST
头部
Content-Type: application/json;charset=UTF-8
请求
名称 | 必需 | 类型 | 示例 | 描述 |
---|---|---|---|---|
mchId | y | String(30) | 10000701 | 由 IOTPay 分配 |
loginName | y | String(12) | jack123 | 商户的登录名 |
currency | y | String(3) | CAD | 目前只支持 CAD |
mchOrderNo | y | String(30) | 1234567890abc | 由商户分配的订单号(不可重复) |
cardId | y | String(30) | 604567999 | 由商户分配的订单号(不可重复) |
amount | y | Int | 1500 | 以分为单位 |
subject | n | String(64) | ||
body | n | String(250) | ||
clientIp | n | String(50) | 192.77.33.56 | 消费者的 IP 地址,用于更好地跟踪交易 |
sign | y | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名算法 |
响应
名称 | 必需 | 类型 | 示例 | 描述 |
---|---|---|---|---|
retCode | y | String | SUCCESS 或 FAIL | |
retMsg | y | String | 如果失败,消息将包含失败的原因 | |
retData | y | JSON | 如果 retCode=SUCCESS,则返回卡信息 |
retData
包含订单信息:
名称 | 必需 | 类型 | 示例 | 描述 |
---|---|---|---|---|
payOrderId | y | String | PC20240101195511712374441010 | 由 IOTPay 生成的订单号 |
mchId | y | String | 10000701 | 由 IOTPay 分配 |
mchOrderNo | y | String | 1234567890abc | 由商户分配的订单号(不可重复) |
originalOrderId | y | String | 如果 payType=refund,则为原始支付订单 ID | |
amount | y | Int | 1500 | 以分为单位 |
currency | y | String | CAD | 目前只支持 CAD |
payType | y | String | pay or refund | 支付类型 |
refundable | y | Int | 1500 | 以分为单位的可退还金额 |
status | y | Int | 2 | 2 或 3 表示成功 |
paySuccTime | y | String | 2021-04-07 19:44:51 | 付款成功的时间戳 |
cardNum | y | String | 432567******2266 | 与令牌相关的卡号 |
expiryDate | y | String | 与令牌相关的卡的到期日期 | |
invoiceNum | y | String | ||
authNum | y | String | ||
transNum | y | String | ||
channel | y | String | PF_CC | PF_CC 或 UPI_EX |