使用令牌进行购买

信息

此端点允许商户使用通过添加卡端点（直接令牌化，重定向）创建的令牌化的卡处理交易。该令牌关联着被安全存储的客户付款信息。

端点

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`