跳转到内容

版本记录

版本号日期版本内容修订人
V1.0.02024/3/7中文首版发布Jorg.Li
V1.1.02024/3/19增加线上接口接入指引Jorg.Li
V1.2.02024/3/22增加支持国密算法
1. SM2withSM3 签名算法
2. 卡信息 SM2 加密算法
3. PIN SM4 加密算法
Jorg.Li
V1.3.02024/4/11. 补充 SM2 加密算法的密文顺序
2. 补充验签说明
3. 补充 ZPK 有效机制
Jorg.Li
V1.3.12024/4/91. 应答码表中补充中文描述
2. 补充 ZPK 接口返回的密文格式及样例
3. 移除以下应答码
B0019、B0020、B0039、B0040、B0044、B0052、B0053、B0094、P0040、P0059、I0008
4. 增加以下应答码
P0013
Jorg.Li
V1.4.02024/4/161.修改 ZPK 的有效机制
2. 在 pin 结构体下增加 checkValue 字段,当使用 SM4 算法加密密码时必送
Jorg.Li
V1.4.12024/4/231. 修改国密加密时的 PIN Block 的格式
2. 国密的 PIN Block 密文样例长度改为 32 位
3. 修改 Offline 接口规范,pspInfo 结构体改为必填
4. 修改 checkValue 字段的校验条件
Jorg.Li
V1.4.22024/5/201. 删除线上接口中以下字段
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 PaymentPOST 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.02024/7/26移除 SecurePlus 相关内容Jorg.Li
V1.5.12024/11/211. 增加 Recapture 相关内容Alice.xu
V1.5.22024/11/23增加 PaymentInstrument 相关内容
1. 应答码 增加 B0112
2. 线上支付场景 更新绑卡的描述
3. Online API Specification
(1) 增加 PaymentInstrument【POST/PUT/GET/DEL】
(2) AsynchronousNotification 增加 PaymentInstrument 异步通知
Kyra.ze
V1.5.32024/12/11GET PaymentInstrument 接口中,应答的 paymentMethod.card.issuingBank 字段长度由 16 改为 256
Kyra.ze
V1.6.02024/12/12Offline API 增加循环支付相关内容
1. 线上支付场景增加循环支付
2. Online API Specification:Payment
(1)POST 请求中增加paymentMethod.recurringProcessingModel
(2)在 POST/GET 应答中增加paymentMethod.recurringReference
(3)在 Payment 异步通知接口中,增加paymentMethod.recurringReference
Iris.Gao
V1.6.12024/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.22024/12/27Online 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