README

ComfortPay

ChargeRequest

使用注册卡创建交易的方法。

参数

• transactionId (必需) - 交易的唯一 ID
• parentTransactionId (可选) - 父交易的唯一 ID。对于交易类型 PREAUTH-CONFIRM、PREAUTH-CANCEL 和 CHARGEBACK 是必需的
• transactionType (必需) - 交易类型，允许的选项：PURCHASE、PREAUTHORIZATION、PREAUTH-CONFIRM、PREAUTH-CANCEL、CHARGEBACK
• referedCardId (必需) - 卡的注册 ID
• ws (必需) - 商户 ID
• terminalId (必需) - 终端 ID
• amount (必需) - 交易金额
• currency (必需) - 交易的货币（ISO 4217 货币代码）
• vs (如果 e2eReference 为空则必需) - 可变符号
• ss (如果 e2eReference 为空则必需) - 特定符号
• e2eReference (如果 vs 和 ss 都为空则必需) - E2E 参考
• submerchantId (仅在发送 IPSPS 数据时必需) - IPSP 数据 - 子商户 ID
• location (仅在发送 IPSPS 数据时必需) - IPSP 数据 - 位置，字符串最大长度 25 个符号
• city (仅在发送 IPSPS 数据时必需) - IPSP 数据 - 城市，字符串最大长度 13 个符号
• alpha2CountryCode (仅在发送 IPSPS 数据时必需) - IPSP 数据 - ISO 3166-1 alpha-2 代码

返回

CardTransactionResponse

• transactionId - 交易的唯一 ID
• transactionStatus - 交易状态代码（参见交易的代码状态）
• transactionApprova - 授权代码

CheckCardRequest

检查注册卡状态的方法。

参数

• idOfCard - 卡的注册 ID

返回

CheckCardResponse

• status - (OK, FAIL, UNKNOWN)

TransactionStatusRequest

检查交易状态的方法。

参数

• transactionId - 交易的唯一 ID

返回

CardTransactionResponse

• transactionId - 交易的唯一 ID
• transactionStatus - 交易状态代码（参见交易的代码状态）
• transactionApproval - 授权代码

ListOfExpiredRequest

获取请求后到期日期之后的过期卡列表的方法。

参数

• expDate (必需) - 到期日期（格式：YYYYMMDD）

返回

ListOfExpiredResponse

• list - 卡 ID 数组

ListOfExpiredPerIdRequest

获取请求中指定的卡的到期日期的方法。

参数

• listOfIdCards - 卡注册 ID 数组（最多 1000 个）

返回

ListOfExpiredPerIdResponse

• listOfIdCards - 包含 idOfCard 和到期日期的配对数组

交易状态代码