版本记录
| 版本号 | 日期 | 版本内容 | 修订人 |
|---|---|---|---|
| V1.0.0 | 2024/3/7 | 中文首版发布 | Jorg.Li |
| V1.1.0 | 2024/3/19 | 增加线上接口接入指引 | Jorg.Li |
| V1.2.0 | 2024/3/22 | 增加支持国密算法 1. SM2withSM3 签名算法 2. 卡信息 SM2 加密算法 3. PIN SM4 加密算法 | Jorg.Li |
| V1.3.0 | 2024/4/1 | 1. 补充 SM2 加密算法的密文顺序 2. 补充验签说明 3. 补充 ZPK 有效机制 | Jorg.Li |
| V1.3.1 | 2024/4/9 | 1. 应答码表中补充中文描述 2. 补充 ZPK 接口返回的密文格式及样例 3. 移除以下应答码 B0019、B0020、B0039、B0040、B0044、B0052、B0053、B0094、P0040、P0059、I0008 4. 增加以下应答码 P0013 | Jorg.Li |
| V1.4.0 | 2024/4/16 | 1.修改 ZPK 的有效机制 2. 在 pin 结构体下增加 checkValue 字段，当使用 SM4 算法加密密码时必送 | Jorg.Li |
| V1.4.1 | 2024/4/23 | 1. 修改国密加密时的 PIN Block 的格式 2. 国密的 PIN Block 密文样例长度改为 32 位 3. 修改 Offline 接口规范，pspInfo 结构体改为必填 4. 修改 checkValue 字段的校验条件 | Jorg.Li |
| V1.4.2 | 2024/5/20 | 1. 删除线上接口中以下字段 authentication.deliveryAddress.houseNumberOrName authentication.deliveryAddress.street authentication.accountInfo.homePhone authentication.accountInfo.mobilePhone authentication.accountInfo.workPhone authentication.accountInfo.city authentication.accountInfo.country authentication.accountInfo.houseNumberOrName authentication.accountInfo.postalCode authentication.accountInfo.stateOrProvince authentication.accountInfo.street authentication.merchantRiskIndicator.addressMatch authentication.billingAddress.houseNumberOrName authentication.billingAddress.street 2. 修改线上接口中以下字段 authentication.accountInfo.accountChangeDate（修改字段格式） authentication.accountInfo.accountCreationDate（修改字段格式） authentication.accountInfo.passwordChangeDate（修改字段格式） authentication.accountInfo.passwordChangeDateIndicator（增加枚举值 notApplicable）authentication.accountInfo.purchasesLast6Months （修改字段最大长度限制） authentication.accountInfo.addCardAttemptsDay（修改字段最大长度限制） authentication.accountInfo.pastTransactionsDay（修改字段最大长度限制） authentication.accountInfo.pastTransactionsYear（修改字段最大长度限制） authentication.accountInfo.paymentAccountAge（修改字段格式） authentication.accountInfo.deliveryAddressUsageDate（修改字段格式） authentication.merchantRiskIndicator.deliveryEmail（ 修改字段最大长度限制） authentication.merchantRiskIndicator.giftCardAmount（修改字段最大长度限制） authentication.merchantRiskIndicator.giftCardCount（修改字段最大长度限制） authentication.merchantRiskIndicator.preOrderDate tradeInfo.tradeType（增加枚举值 Wallet_Transfer）3. 线上 POST Payment 和 POST PaymentMethod 接口中新增以下字段 authentication.deliveryAddress.addressLine1 authentication.deliveryAddress.addressLine2 authentication.deliveryAddress.addressLine3 authentication.accountInfo.shippingNameIndicator authentication.accountInfo.homePhone（结构体） authentication.accountInfo.mobilePhone（结构体） authentication.accountInfo.workPhone（结构体） authentication.merchantRiskIndicator.giftCardCurrency（修改字段最大长度限制） authentication.billingAddress.addressLine1 authentication.billingAddress.addressLine2 authentication.billingAddress.addressLine3 transInitiator.deviceID authentication.threeDS.cardholderAccountIdentifier | Jorg.Li |
| V1.5.0 | 2024/7/26 | 移除 SecurePlus 相关内容 | Jorg.Li |
| V1.5.1 | 2024/11/21 | 1. 增加Recapture相关内容 | Alice.xu |
| V1.5.2 | 2024/11/23 | 增加 PaymentInstrument 相关内容 1. 应答码 增加B0112 2. 线上支付场景 更新绑卡的描述 3. Online API Specification （1） 增加PaymentInstrument【POST/PUT/GET/DEL】 （2） AsynchronousNotification 增加PaymentInstrument异步通知 | Kyra.ze |
| V1.5.3 | 2024/12/11 | GET PaymentInstrument 接口中，应答的 paymentMethod.card.issuingBank 字段长度由16改为256 | Kyra.ze |
| V1.6.0 | 2024/12/12 | Offline API增加循环支付相关内容 1. 线上支付场景增加循环支付 2. Online API Specification：Payment （1）POST请求中增加 paymentMethod.recurringProcessingModel（2）在POST/GET应答中增加 paymentMethod.recurringReference（3）在Payment异步通知接口中，增加 paymentMethod.recurringReference | Iris.Gao |
| V1.6.1 | 2024/12/26 | 以下接口中，应答的 paymentMethod.card.issuingBank 字段长度由16改为256 1、Online API Specification： （1）paymentMethod【POST/PUT/GET/DEL】 （2）Payment【POST/PUT/GET】 （3）Capture【POST/GET】 （4）Refund【POST/GET】 （5）Merchandise Credit【POST/GET】 （6）CancelOrRefund【POST/GET】 （7）Cryptogram【POST/GET/PUT】 （8）Notification（Payment，Refund，MerchandiseCredit，Capture，PaymentMethod，Cryptogram，StandaloneCapture，MultipleCapture，Recapture，Network Token 更新通知，Network Token 认证完成通知） （9）Multiple Capture【POST/GET】 （10）Standalone Capture【POST/GET】 （11）Recapture【POST/GET】 2、Offline API Specification： （1）Payment【POST/GET】 （2）Capture【POST/GET】 （3）Refund【POST/GET】 （4）Merchandise Credit【POST/GET】 （5）Notification（Payment，Refund，MerchandiseCredit，Capture，StandaloneCapture，MultipleCapture） （6）Standalone Capture【POST/GET】 （7）Multiple Capture【POST/GET】 | Kyra.ze |
| V1.6.2 | 2024/12/27 | Online API修改Visa AFT相关内容 1. 移除以下结构体和字段在 tradeInfo.tradeType=Funding_Transfer 条件下的必填校验 recipientInfo recipientInfo.name recipientInfo.accountNumber recipientInfo.accountType userInfo userInfo.name userInfo.address 2. 新增以下字段的条件必填描述 pspInfo.postCode tradeInfo.purposeOfPayment recipientInfo.name.firstName recipientInfo.name.lastName recipientInfo.address.street recipientInfo.address.city recipientInfo.address.stateOrProvince recipientInfo.address.country recipientInfo.accountNumber userInfo.name.firstName userInfo.name.middleName userInfo.name.lastName userInfo.address.street userInfo.address.city userInfo.address.stateOrProvince userInfo.address.country 3. 新增应答码 B1003 | Flora.Ren |
| V1.6.3 | 2025/05/06 | 在以下API的响应中添加paymentMethod.paymentAccountReference。 1、Online API Specification： （1）paymentMethod【POST/PUT/GET】 （2）Payment【POST/PUT/GET】 （3）Capture【POST/GET】 （4）Refund【POST/GET】 （5）Merchandise Credit【POST/GET】 （6）CancelOrRefund【POST/GET】 （7）Notification【PaymentMethod/Payment/Capture/Refund/MerchandiseCredit】 2、Offline API Specification： （1）Payment【POST/GET】 （2）Capture【POST/GET】 （3）Refund【POST/GET】 （4）Merchandise Credit【POST/GET】 （5）Notification【Payment/Capture/Refund/MerchandiseCredit】 | Kyra.ze |