直接支付
直接方法允许您进行购买或令牌化卡，而无需涉及任何 UI，只需一个 API 调用。
先决条件
为了向此 API 发送请求，必须证明您已符合支付卡行业数据安全标准 (PCI DSS)
直接用信用卡购买
端点
https://ccapi.iotpaycloud.com/v3/cc_directpurchase
方法
POST
头部
Content-Type: application/json;charset=UTF-8
! 提示
在收到访问凭证（商户 ID、登录名、商户密钥）之后， 您可以按照演示进行操作直接支付 这可能在阅读文档时对您有所帮助。
请求
| 名称 | 必需 | 类型 | 示例 | 描述 |
|---|---|---|---|---|
| mchId | y | String(30) | 10000701 | 由 IOTPay 分配 |
| loginName | y | String(12) | jack123 | 商户登录名 |
| channel | y | String | PF_CC | PF_CC 或 UPI_EX |
| currency | y | String | CAD | 仅支持 'CAD' |
| mchOrderNo | y | String(30) | 604567999 | 由商户分配的订单号（不可重复） |
| amount | y | Int | 1500 | 以分为单位 |
| cardNum | y | String | 432567******2266 | 卡号 |
| expiryDate | y | String | 0725 | 有效期 |
| holder | y | String | test | 持卡人姓名 |
| cvv | y | String | 786 | 卡的 CVV |
| 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 中返回所有字段 |
retData 包含订单信息：
| 名称 | 必需 | 类型 | 示例 | 描述 |
|---|---|---|---|---|
| payOrderId | y | String | PC20240101231256043886634219 | IOTPay 生成的 |
| mchId | y | String | 10000701 | 由 IOTPay 分配 |
| mchOrderNo | y | String | 604567999 | 由商户分配的订单号（不可重复） |
| originalOrderId | n | String | 退款的原始支付订单 ID | |
| currency | y | String | CAD | 仅支持 'CAD' |
| amount | y | Int | 1500 | 以分为单位 |
| payType | y | String | pay 或 refund | |
| refundable | y | Int | 1500 | 可退款金额，以分为单位 |
| status | y | Int | 0,1,2,9 | 0 = 待定订单，1 = 未知，2 = 成功，9 = 失败 |
| paySuccTime | y | String | 2021-04-07 19:44:51 | 支付成功时的时间戳 |
| cardNum | y | String | 432567******2266 | 用于购买的卡的卡号 |
| expiryDate | y | String | 0725 | 用于购买的卡的有效期 |
| invoiceNum | y | String | ||
| authNum | y | String | ||
| transNum | y | String | ||
| channel | y | String | PF_CC | PF_CC 或 UPI_EX |
直接使信用卡令牌化
端点
https://ccapi.iotpaycloud.com/v3/cc_directaddcard
方法
POST
头部
Content-Type: application/json;charset=UTF-8
先决条件
为了向此 API 发送请求，必须证明您已符合 支付卡行业数据安全标准 (PCI DSS)
请求
| 名称 | 必需 | 类型 | 示例 | 描述 |
|---|---|---|---|---|
| mchId | y | String(30) | 10000701 | 由 IOTPay 分配 |
| loginName | y | String(12) | jack123 | 商户登录名 |
| channel | y | String | PF_CC | PF_CC 或 UPI_EX |
| cardId | y | String(30) | 604567999 | 由商户分配的订单号（不可重复） |
| cardNum | y | String | 432567******2266 | 卡号 |
| expiryDate | y | String | 0725 | 格式：MMYY |
| holder | y | String | test | 持卡人姓名 |
| cvv | y | String | 786 | 卡的 CVV |
| sign | y | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名算法 |
响应
| 名称 | 必需 | 类型 | 示例 | 描述 |
|---|---|---|---|---|
| retCode | y | String | SUCCESS 或 FAIL | |
| retMsg | y | String | ||
| retData | y | JSON | 如果 retCode=SUCCESS，则在 retData 中返回卡的详细信息以及令牌 |
retData 包含卡信息：
| 名称 | 必需 | 类型 | 示例 | 描述 |
|---|---|---|---|---|
| cardId | y | String | 604567999 | 由商户分配的订单号（不可重复） |
| cardNum | y | String | 432567******2266 | 已添加的卡的卡号 |
| expiryDate | y | String | 0725 | 已添加的卡的有效期 |
| holder | y | String | test | 已添加的卡的持卡人 |
| cvv | y | String | 786 | 已添加的卡的 CVV |
您现在可以使用 cardId 进行购买
如果需要查看卡信息，可以调用查询卡端点。
要使用令牌化的卡进行购买，请使用令牌购买端点。