发版说明

2024-11-29 08:13

发布日期：2024年11月29日

新增

为提高使用万里汇账号编辑收款人及查询历史汇率的能力，新增以下接口：

修改

接口名

影响内容

inquiryRate

请求体：

新增以下字段：

customerId

更新代码示例

inquiryExchange

请求体：

新增以下字段：

customerId

更新代码示例

发布日期：2024年11月21日

修改

接口名	影响内容
inquiryBeneficiaryTemplate	请求体：修改以下字段： currency beneficiaryType 更新代码示例响应体：更新代码示例
bindBeneficiary	请求体：修改以下字段： currency 更新代码示例响应体：修改以下字段： beneficiary.currency 更新代码示例
inquiryBeneficiaryList	请求体：修改以下字段： currencyList 更新代码示例响应体：修改以下字段： beneficiaries.currency 更新代码示例
createPayout	请求体：修改以下字段： transferToDetails.purposeCode 响应体：修改以下字段： transferToDetails.purposeCode

发布日期：2024年11月06日

新增

为提高使用万里汇账号进行万里付卡管理的能力，新增以下接口：

接口名称	功能
queryContactList	可调用此接口查询企业联系人列表。
applyCard	可调用此接口，向万里汇申请万里付卡片。
queryCardList	集成商可调用此接口查询持有的所有万里付卡片。
queryCardDetail	集成商可调用此接口查询某一张万里付卡的详细信息。
queryCardSensitiveInfo	集成商可调用此接口查询万里付卡片的敏感信息。
updateCardStatus	集成商可调用此接口修改万里付卡片的状态，如冻结、解冻、删除卡片等。
notifyCardStatus	万里汇使用此接口向集成商返回万里付卡片的最终状态。
updateCardLimit	集成商可调用此接口更新万里付卡片限额。
queryBillList	集成商可调用此接口查询万里付卡片的交易记录。
notifyBillResult	万里汇会调用此接口将交易金额、交易结果等相关账单信息通知给集成商。

修改

接口名

影响内容

附录

TransactionType

新增以下枚举值：

CARD_PAYMENT
CARD_REFUND

发布日期：2024年9月24日

新增

为提高使用万里汇账号进行账单详情查询的能力，新增以下接口：

inquiryStatementDetail

修改

接口名	影响内容
inquiryAccount	请求体：修改以下字段： accountType 更新代码示例响应体：修改以下字段： customerId accountInfos affiliatedCustomer 更新代码示例
inquiryBeneficiaryList	请求体：新增以下字段： assetType accountName currencyList 修改以下字段： bankAccountNo 更新代码示例响应体：新增以下字段： beneficiaries.beneficiaryAlipayAccount 修改以下字段： beneficiaries.beneficiaryBankAccount beneficiaries.currency beneficiaries.beneficiaryType 更新代码示例
bindBeneficiary	请求体：新增以下字段： beneficiaryAlipayAccount 修改以下字段： beneficiaryType beneficiaryBankAccount countryCode currency beneficiaryNick 更新代码示例响应体：修改以下字段： beneficiaries.currency beneficiaries.beneficiaryType 更新代码示例
inquiryBeneficiaryTemplate	请求体：新增以下字段： beneficiaryType 修改以下字段： countryCode currency 更新代码示例响应体：新增以下字段： alipayTemplateData 修改以下字段： cardTemplateData
submitTradeOrder	请求体：新增以下字段： tradeOrders.buyer.buyerCountry
inquiryTradeOrder	响应体：新增以下字段： tradeOrderResults.orderType 更新代码示例
notifyTradeOrder	请求体：新增以下字段： tradeOrderResults.orderType 更新代码示例

发布日期：2024年8月15日

新增

为满足集成商提供打款证明以及财务合规备案的诉求，新增以下三个交易凭证下载接口：

修改

接口名	影响内容
inquiryBeneficiaryList	请求体：将请求体中的customerId字段移除，并在请求头中替换为Connected-CustomerId字段更新了accessToken的使用条件响应体：更新了beneficiaryBankAccount字段的描述
bindBeneficiary	请求体：将请求体中的customerId字段移除，并在请求头中替换为Connected-CustomerId字段更新了accessToken的使用条件更新了beneficiaryBankAccount字段的描述响应体：更新了beneficiaryBankAccount字段的描述
removeBeneficiary	请求体：将请求体中的customerId字段移除，并在请求头中替换为Connected-CustomerId字段更新了accessToken的使用条件

发布日期：2024年7月15日

修改

接口名

影响内容

inquiryStatementList

请求体：

修改以下字段：

startTime
endTime
trasactionTypeList

响应体：

新增以下字段：

statementList.goodsName
statementList.goodsAmount
statementList.platformFeeAmount

修改以下字段：

statementList.transactionStatus

发布日期：2024年7月4日

修改

接口名	影响内容
inquiryBeneficiaryList	请求体：新增以下字段： relationStatusList 响应体：修改以下字段： beneficiaries.beneficiaryType beneficiaries.beneficiaryBankAccount.bankAccountNo beneficiaries.beneficiaryBankAccount.bankAccountIBAN
bindBeneficiary	请求体：修改以下字段： beneficiaryType beneficiaryBankAccount.bankAccountNo beneficiaryBankAccount.bankAccountIBAN 响应体：修改以下字段： beneficiaryType beneficiaries.beneficiaryBankAccount.bankAccountNo beneficiaries.beneficiaryBankAccount.bankAccountIBAN
inquiryPayout	请求体：新增以下字段： transferId 更新代码示例
inquiryStatementList	请求体：新增以下字段： fuzzyName 更新代码示例响应体：新增以下字段： statementList.accountingBizNo statementList.fundMoveDetail.payerBankName 更新代码示例
notifyVostro	请求体：修改以下字段： payerBankAccount.holderAddress
submitTradeOrder	请求体：修改以下字段： tradeOrders.paymentTime tradeOrders.orderTime

发布日期：2024年5月14日

新增

在inquiryAccount接口响应体中，新增如下参数：

customer.logonId
customer.verificationLevel

发布日期：2024年4月28日

为提高RA开户的集成体验，对集成指南：用户开通RA流程进行了如下变更：

新增

新增结果码： REQUEST_ID_IDEMPOTENT 和 REFERENCE_CUSTOMER_ID_OPENED_RA

修改

修改了requestId字段的使用条件。

发布日期：2024年4月11日

修改

为提高使用万里汇主子账号进行资金互转的操作效率，对以下内容进行变更：

接口名	影响内容
createTransfer	请求体：新增以下字段： businessSceneCode transferFromDetail.transferFromMethod.paymentMethodType transferFromDetail.transferFromMethod.customerId transferToDetail.needMigrateMaterial transferToDetail.transferToMethod.customerId 修改以下字段： transferToDetail.transferToMethod.paymentMethodType 更新代码示例响应体：新增以下字段： businessSceneCode transferToDetail.needMigrateMaterial transferToDetail.transferToMethod.customerId 修改以下字段： transferToDetail.transferToMethod.paymentMethodType 更新代码示例
inquiryTransfer	响应体：新增以下字段： businessSceneCode transferToDetail.needMigrateMaterial transferToDetail.transferToMethod.customerId 修改以下字段： transferToDetail.transferToMethod.paymentMethodType 更新代码示例
notifyTransfer	请求体：新增以下字段： businessSceneCode transferToDetail.needMigrateMaterial transferToDetail.transferToMethod.customerId 修改以下字段： transferToDetail.transferToMethod.paymentMethodType 更新代码示例

发布日期：2024年1月17日

修改

为提高使用万里汇查询VA账户信息的能力，对以下内容进行变更：

接口名

影响内容

inquiryAccount

响应体：

新增以下字段：

accountInfos.bankAccountList.bankRegion

修改以下字段：

accountInfos.bankAccountList.bankAccountNo
accountInfos.bankAccountList.bankName
accountInfos.bankAccountList.routingNumber
accountInfos.bankAccountList.bankBIC
accountInfos.bankAccountList.bankAccountIBAN
accountInfos.bankAccountList.bankAccountBSB
accountInfos.bankAccountList.accountCreationDate
accountInfos.bankAccountList.bankCode
accountInfos.bankAccountList.branchCode
accountInfos.bankAccountList.wireRoutingNumber
accountInfos.bankAccountList.sortCode

inquiryStore

响应体：

新增以下字段：

accountInfos.bankAccountList.bankRegion
statementList.receiveAmount

修改以下字段：

accountInfos.bankAccountList.bankAccountNo
accountInfos.bankAccountList.bankName
accountInfos.bankAccountList.routingNumber
accountInfos.bankAccountList.bankBIC
accountInfos.bankAccountList.bankAccountIBAN
accountInfos.bankAccountList.bankAccountBSB
accountInfos.bankAccountList.accountCreationDate
accountInfos.bankAccountList.bankCode
accountInfos.bankAccountList.branchCode
accountInfos.bankAccountList.wireRoutingNumber

发布日期：2023年11月17日

修改

针对 submitTradeOrder API:

修改了 tradeOrders.shipping.wayBillInfos.shippingOrderReferenceNo 字段的描述。

发布日期：2023年11月3日

修改

为提高OAuth能力，在以下API中，将INVALID_ACCESS_TOKEN 全部修改为 AUTHORIZATION_NOT_EXIST：

发布日期：2023年10月30日

为提高万里汇主子账号查询、订单查询的能力，对以下内容进行变更：

新增

新增transactionType枚举：DEPOSIT_PURCHASE
在inquirySubuser响应体中新增字段：primaryUserInformation

发布日期：2023年9月22日

为提高万里汇订单提交、订单查询的能力，对以下内容进行变更：

新增

新增transactionType枚举：BALANCE_TO_BALANCE
新增Goods模型相关字段：

goodsUnit
goodsCnName

修改

在submitTradeOrder请求体中修改以下字段描述：

tradeOrders.referenceOrderNo
tradeOrders.transAmount
tradeOrders.tradeAmount
tradeOrders.orderType
tradeOrders.merchant
tradeOrders.attachmentDesc
tradeOrders.shipping.wayBillInfos.shippingProofAttachmentList
tradeOrders.goods.goodsCategory
tradeOrders.goods.goodsQuantity
tradeOrders.goods.storeUrl

发布日期：2023年9月8日

修改

接口名

影响内容

inquiryStatementList

请求体：修改以下字段描述

pageSize
pageNumber

发布日期：2023年9月4日

修改

为提高万里汇账单查询、订单关联以及结汇等场景下的能力，对以下接口进行变更：

接口名	影响内容
inquiryAccount	请求体：修改accountType使用条件错误码新增`AUTHORIZATION_NOT_EXIST` 新增`ACCESS_TOKEN_EXPIRED`
inquiryStatementList	响应体：新增以下字段 statementList.netAmount statementList.receiveAmount statementList.fundMoveDetail.payerUserId statementList.fundMoveDetail.paymentExplanation statementList.fundMoveDetail.paymentSubject statementList.fundMoveDetail.paymentVoucherNo 更新代码示例
submitTradeOrder	请求体：新增tradeOrders.logisticsMode字段
notifyAssociationResult	请求体：新增以下字段 notificationType referenceOrderNo
createPayout	请求体与响应体：修改transferToAmount.transferToRemark至transferToAmount.transferRemark 错误码：新增`AVAILABLE_QUOTA_NOT_ENOUGH`
枚举值	新增 `accountType.VIRTUAL_ACCOUNT` `accountType.ALIPAY_WALLET` `transactionType.CASH_BACK` `transactionType.VENDOR_COLLECTION_PAYMENT`

发布日期：2023年8月8日

修改

为提高集成商通过万里汇进行收款和结汇的能力，对以下接口进行变更：

接口名	影响内容
bindBeneficiary	请求体：新增以下字段 beneficiaryBankAccount.beneficiaryTIN beneficiaryBankAccount.beneficiaryDepositType beneficiaryBankAccount.bankCountryCode beneficiaryBankAccount.bankLocalName beneficiaryBankAccount.localBeneficiaryAddress beneficiaryBankAccount.beneficiaryPostalCode beneficiaryBankAccount.beneficiaryState beneficiaryBankAccount.beneficiaryCity 响应体：新增以下字段 beneficiaryBankAccount.beneficiaryTIN beneficiaryBankAccount.beneficiaryDepositType beneficiaryBankAccount.bankCountryCode beneficiaryBankAccount.bankLocalName beneficiaryBankAccount.localBeneficiaryAddress beneficiaryBankAccount.beneficiaryPostalCode beneficiaryBankAccount.beneficiaryState beneficiaryBankAccount.beneficiaryCity 更新代码示例
inquiryBeneficiary	响应体：新增以下字段 beneficiaryBankAccount.beneficiaryTIN beneficiaryBankAccount.beneficiaryDepositType beneficiaryBankAccount.bankCountryCode beneficiaryBankAccount.bankLocalName beneficiaryBankAccount.localBeneficiaryAddress beneficiaryBankAccount.beneficiaryPostalCode beneficiaryBankAccount.beneficiaryState beneficiaryBankAccount.beneficiaryCity
consultPayout	请求体：新增以下字段的枚举值transferToDetail.transferToMethod.paymentMethodMetaData.bankAccountPaymentMethodDetail.bankLocalName 响应体：新增以下字段的枚举值transferToDetail.transferToMethod.paymentMethodMetaData.bankAccountPaymentMethodDetail.bankLocalName
createPayout	请求体：新增以下字段的枚举值transferToDetail.transferToMethod.paymentMethodMetaData.bankAccountPaymentMethodDetail.bankLocalName 响应体：新增以下字段的枚举值transferToDetail.transferToMethod.paymentMethodMetaData.bankAccountPaymentMethodDetail.bankLocalName
inquiryPayout	响应体：新增以下字段的枚举值 transferToDetail.transferToMethod.paymentMethodMetaData.bankAccountPaymentMethodDetail.bankLocalName
notifyPayout	请求体：新增以下字段的枚举值 transferToDetail.transferToMethod.paymentMethodMetaData.bankAccountPaymentMethodDetail.bankLocalName

发布日期：2023年7月28日

修改

为加强集成商使用万里汇进行交易管理的能力，对以下接口进行变更：

接口名	影响内容
submitTradeOrder	请求体：新增extendInfo字段错误码：新增`FUND_ORDER_RELATED_MANUALLY` 更新代码示例

发布日期：2023年7月24日

修改

对于所有的 transfer 和 payout接口，从TransferToDetail 对象中删除feeMode 字段。

发布日期：2023年7月17日

修改

为加强集成商使用万里汇进行多币种收款的能力。为了支持多币种收款能力，对inquireStore接口进行以下了变更：

接口名

影响内容

inquiryStore

响应体

新增以下字段

storeInformation.accountInformation.bankAccountList.currencyList
storeInformation.accountInformation.bankAccountList.holderAccountType
storeInformation.accountInformation.bankAccountList.routingNumber
storeInformation.accountInformation.bankAccountList.bankAddress
storeInformation.accountInformation.bankAccountList.bankAccountIBAN
storeInformation.accountInformation.bankAccountList.bankAccountBSB
storeInformation.accountInformation.bankAccountList.accountCreationDate
storeInformation.accountInformation.bankAccountList.bankCode
storeInformation.accountInformation.bankAccountList.branchCode
storeInformation.accountInformation.bankAccountList.bankAccountType
storeInformation.accountInformation.bankAccountList.collectionArea
storeInformation.accountInformation.bankAccountList.wireRoutingNumber

删除了以下字段

storeInformation.accountInformation.bankAccountList.bankRegion

修改了以下字段的使用条件

storeInformation.accountInformation.currencyList

修改了以下字段的命名

storeInformations 修改为：storeInformation
storeInformations.accountInfos 修改为：storeInformation.accountInformation
storeInformations.accountInfos.bankAccount 修改为：storeInformation.accountInformation.bankAccountList
storeInformations.accountInfos.bankAccount.accountNo 修改为：storeInformation.accountInformation.bankAccountList.bankAccountNo

修改了以下字段的数据类型

storeInformation.accountInformation.bankAccountList 从原来的BankAccount对象修改为数组<BankAccount>对象

更新代码示例

发布日期：2023年6月13日

支持OAuth授权，新增和修改以下API。

新增

修改

章节名	影响内容
OAuth授权	部分API的请求头包含 Access-Token 参数，用于OAuth授权。
inquiryBalance	请求头中传入Access-Token 参数增加以下 result code: `ACCESS_TOKEN_EXPIRED` `INVALID_ACCESS_TOKEN`
inquiryStatementList

发布日期：2023年6月9日

新增

为加强集成商通过万里汇完成单据支付的能力，新增 queryInvoice 接口，用于查询单据支付结果。

修改

为加强集成商通过万里汇完成单据支付的能力，对 createInvoice 接口进行以下修改：

将 invoice.bill.billSender.userName 和 invoice.bill.billReceiver.userName 字段的数据类型从字符串改为 UserName 对象。
将 invoice.bill.billSender.userAddress 和 invoice.bill.billReceiver.userAddress 字段的数据类型从字符串改为 Address 对象。
在响应体中新增结果码： UNSUPPORTED_BUSINESS
更新代码示例。

发布日期：2023年6月6日

修改

为加强集成商通过万里汇进行结汇的能力，对以下接口进行修改：

接口名	影响内容
consultPayout	请求体和响应体: 新增以下字段: transferFromDetail.transferFromMethod.paymentMethodMetaData.AlipayAccountPaymentMethodDetail 修改了以下字段的使用条件: transferFromDetail.transferFromMethod.paymentMethodType transferFromDetail.transferFromMethod.paymentMethodId transferFromDetail.transferFromMethod.paymentMethodMetaData transferToDetail.transferToMethod.paymentMethodType transferToDetail.transferToMethod.paymentMethodId transferToDetail.transferToMethod.paymentMethodMetaData
createPayout	请求体和响应体: 新增以下字段: transferFromDetail.transferFromMethod.paymentMethodMetaData.AlipayAccountPaymentMethodDetail transferOrderAddition.disPlayTitle 修改了以下字段的使用条件: transferFromDetail.transferFromMethod.paymentMethodType transferFromDetail.transferFromMethod.paymentMethodId transferFromDetail.transferFromMethod.paymentMethodMetaData transferToDetail.transferToMethod.paymentMethodType transferToDetail.transferToMethod.paymentMethodId transferToDetail.transferToMethod.paymentMethodMetaData
inquiryPayout	响应体: 新增以下字段: transferFromDetail.transferFromMethod.paymentMethodMetaData.AlipayAccountPaymentMethodDetail transferOrderAddition.disPlayTitle 修改了以下字段的使用条件: transferFromDetail.transferFromMethod.paymentMethodType transferFromDetail.transferFromMethod.paymentMethodId transferFromDetail.transferFromMethod.paymentMethodMetaData transferToDetail.transferToMethod.paymentMethodType transferToDetail.transferToMethod.paymentMethodId transferToDetail.transferToMethod.paymentMethodMetaData
notifyPayout	请求体: 新增以下字段: transferFromDetail.transferFromMethod.paymentMethodMetaData.AlipayAccountPaymentMethodDetail transferOrderAddition.disPlayTitle 修改了以下字段的使用条件: transferFromDetail.transferFromMethod.paymentMethodType transferFromDetail.transferFromMethod.paymentMethodId transferFromDetail.transferFromMethod.paymentMethodMetaData transferToDetail.transferToMethod.paymentMethodType transferToDetail.transferToMethod.paymentMethodId transferToDetail.transferToMethod.paymentMethodMetaData

发布日期：2023年5月29日

新增

为支持集成商通过万里汇完成单据支付，新增 createInvoice 和 notifyInvoice 接口。
为支持集成商通过万里汇查询可用结汇额度，新增 inquiryAvailableQuota 接口。

修改

为加强集成商通过万里汇的交易和转账能力，对以下接口进行修改：

接口名	影响内容
submitTradeOrder	请求体：新增以下字段： quotaAccumulationId tradeOrders.market trandeOrder.revenueShare 删除以下字段： transferId referenceBatchNo tradeOrders.tradeBizType tradeOrders.sellerAccount tradeOrders.sellerAccount.bankAccountNo tradeOrders.sellerAccount.receivingAccount 修改以下字段的使用条件： tradeOrders tradeOrders.tradeAmount tradeOrders.isUsedForExchange tradeOrders.bizContractInfo tradeOrders.shipping.wayBillInfos tradeOrders.shipping.isShipped tradeOrders.shipping.isDeclared tradeOrders.shipping.isNewBuyer tradeOrders.shipping.declarationInfos tradeOrders.shipping.expectedShippingDate tradeOrders.shipping.inquiryChatRecordAttachmentList tradeOrders.shipping.logisticsChatRecordAttachmentList tradeOrders.shipping.tradeTerms tradeOrders.shipping.wayBillInfos.shippingOrderReferenceNo tradeOrders.shipping.wayBillInfos.shippingMethod tradeOrders.shipping.wayBillInfos.shippingProofAttachmentList tradeOrders.shipping.wayBillInfos.logisticsCompany tradeOrders.shipping.declarationInfos.declarationOrderReferenceNo tradeOrders.shipping.declarationInfos.supervisionMethod tradeOrders.shipping.declarationInfos.customsDeclarationAttachmentList 修改以下字段的枚举值： quotaAccumulationMethod：新增枚举值 `TRANSFER_ID` 和 `COLLECTION_ID` sceneCode：将原枚举值 `CREATE_ORDERS_AND_ASSOCIATE` 和 `CREATE_ORDER_AND_ASSOCIATE_BIG_MERCHANT` 合并为 `CREATE_B2B_ORDERS` tradeOrders.orderType：将原枚举值 `PAYMENT` 更新为 `LOAN` 响应体：新增结果码 `REPEAT_REQ_INCONSISTENT` 修改 acceptOrderId 字段的使用条件更新代码示例
inquiryTradeOrder	请求体：新增以下字段： sceneCode quotaAccumulationMethod quotaAccumulationId tradeType 删除 sellerUserId 字段将 sceneCode 字段的枚举值 `CREATE_ORDERS_AND_ASSOCIATE` 和 `CREATE_ORDER_AND_ASSOCIATE_BIG_MERCHANT` 合并为 `CREATE_B2B_ORDERS` 响应体：新增结果码 `ACCOUNT_NOT_EXIST` 新增结果码 `ORDER_NOT_EXIST` 更新代码示例
consultPayout	响应体：将 transferFromDetail.availableQuota 字段层级上移，变更为 availableQuota 字段

发布日期：2023年4月28日

新增

从风险管控的角度出发，为了支撑客户，尤其是对于 CN HK EC (E-commerce) 的客户, 在不同业务场景下，可使用不同的余额类型对资金余额做分隔管理, 设计核心字段 balanceTypes 来实现此能力。

接口名

影响内容

inquiryBalance

请求体：增加 balanceTypes 字段
响应体：

增加 balanceTypes 字段
在 accountBalance 模型中增加 balanceTypes 字段

inquiryStatementList

请求体：增加 balanceTypes 字段
响应体：在 statementList 里增加 balanceTypes 和 description 字段

为加强外汇的即期交易能力，修改以下接口：

接口名	影响内容
inquiryAvailableCalendar	请求体：增加 exchangeTradeType 字段
createQuote	请求体：增加 quoteUnfundedInfo 字段为 exchangeTradeType 字段新增枚举值 `UNFUNDED_SPOT` 响应体：增加 quoteUnfundedInfo 字段
createDeal	请求体：增加 exchangeTradeType 字段
notifyExchange	请求体：增加 exchangeUnfundedInfo 字段为 exchangeTradeType 字段增加枚举值 `UNFUNDED_SPOT`
createExchange	请求体：增加 exchangeUnfundedInfo 字段为 exchangeTradeType 字段增加枚举值 `UNFUNDED_SPOT` 响应体：新增 exchangeUnfundedInfo 字段
inquiryExchange	请求体：增加 exchangeUnfundedInfo 字段
Data Dictionary	为 QuoteForwardInfo 模型增加 settlementTimeType 字段

修改

为加强外汇的即期交易能力，修改以下接口：

接口名	影响内容
inquiryAvailableCalendar	将 forwardType 字段从`必填`改为`选填`
createQuote	请求体：删除 quoteForwardInfo 字段响应体：删除 quoteForwardInfo 字段
createDeal	将 marginCurrency 字段从`必填`改为`选填` 将 forwardType 字段从`必填`改为`选填`
createExchange	请求体：删除 exchangeForwardInfo 字段响应体：删除 exchangeForwardInfo 字段
Data Dictionary	从 QuoteForwardInfo 模型中删除 forwardType 字段在 QuoteForwardInfo 模型中将 marginCurrency 字段从`必填` 改为`选填`

发布日期：2023年4月13日

修改

在 inquiryBalance 接口修改：

请求头: 添加 Connected-CustomerId 字段
请求体: 删除 customerId 和 accessToken 字段
更新请求体范例、请求代码范例和响应体范例

发布日期：2023年4月10日

修改

在 inquiryStatementList 接口修改：

请求头中添加 Connected-CustomerId 字段
请求体中删除 customerId 和 accessToken 字段
更新请求体范例、请求代码范例和响应体范例

发布日期：2023年4月7日

新增

新增 inquiryTradeOrder 和 notifyTradeOrder 接口。
在 submitTradeOrder 接口中：

为 sceneCode 字段新增枚举值：PAY_INTO_CHINA
为 B2C 场景新增以下请求体字段：

quotaAccumulationMethod
referenceBatchNo
tradeOrders.orderType
tradeOrders.merchant
tradeOrders.seller
tradeOrders.buyer
tradeOrders.sellerAccount
tradeOrders.seller.referenceCustomerId
tradeOrders.goods.goodsCategory
tradeOrders.shipping.wayBillInfos.shippingAddress

在响应体中新增 tradeOrderResult 字段。
为 B2C 场景新增 2 个代码示例。

修改

在 submitTradeOrder 接口中：

修改以下请求体字段的描述：

tradeOrders
platform
transferId
tradeOrders.transAmount
tradeOrders.isUsedForExchange
tradeOrders.bizContractInfo
tradeOrders.seller.customerId
tradeOrders.shipping.isShipped
tradeOrders.shipping.isDeclared
tradeOrders.shipping.isNewBuyer
tradeOrders.shipping.wayBillInfos
tradeOrders.shipping.declarationInfos
tradeOrders.shipping.expectedShippingDate
tradeOrders.shipping.inquiryChatRecordAttachmentList
tradeOrders.shipping.logisticsChatRecordAttachmentList
tradeOrders.shipping.tradeTerms
tradeOrders.shipping.wayBillInfos.shippingOrderReferenceNo
tradeOrders.shipping.wayBillInfos.shippingMethod
tradeOrders.shipping.wayBillInfos.shippingProofAttachmentList
tradeOrders.shipping.wayBillInfos.logisticsCompany
tradeOrders.shipping.declarationInfos.declarationOrderReferenceNo
tradeOrders.shipping.declarationInfos.supervisionMethod
tradeOrders.shipping.declarationInfos.customsDeclarationAttachmentList

删除以下请求体字段：

tradeOrders.purposeCode
tradeOrders.goods.goodsCnName
tradeOrders.goods.goodsUnit
tradeOrders.goods.storeUrl
tradeOrders.goods.goodsUnitAmount
tradeOrders.shipping.wayBillInfos.logisticsCompanyName

修改响应字段 acceptOrderId 的描述。

在 createQuote 接口中修改：

请求头中添加 Connected-CustomerId 字段
请求体中删除 customerId 和 accessToken 字段
响应体中删除 customerId 和 accessToken 字段
添加请求头授权字段范例
更新请求体范例和响应体范例

发布日期：2023年3月31日

新增

在 consultPayout 接口和 createPayout 接口新增：

businessSceneCode 字段
2 个结汇场景下的示例

在 BankAccountPaymentMethodDetail 模型中新增：

beneficiaryType 字段
bankAccountLocalName 字段
bankLocalName 字段

在 TransferToDetail (适用于“转账到卡/payout”) 模型中新增：

arrivalType 字段
fvtPayment 字段

在 TransferFromDetail 模型中新增：

transferLimitInfo 字段
availableQuota 字段

新增 TransferLimitInfo (适用于“转账到卡/payout”) 模型

修改

在 BankAccountPaymentMethodDetail 模型中修改：

bankCountryCode 字段：增加使用条件。
routingNumber 字段：增加使用条件。

在 TransferToDetail (适用于“转账到卡/payout”) 模型中修改：

transferToAmount 字段：新增赋值说明。

在 TransferFromDetail 模型中修改：

transferFromAmount 字段：新增赋值说明。

发布日期：2023年3月28日

新增

新增转账到户 (Transfer) 和转账到卡 (Payout) 两个模块，替换原转账代发 (Transfer) 模块。

接口名称	功能
consultTransfer	查询转账到户相关信息
createTransfer	可调用本接口进行资金转账到户操作
inquiryTransfer	查询转账到户结果
notifyTransfer	接收转账到户结果通知
consultPayout	查询转账到卡相关信息
createPayout	可调用本接口进行资金转账到卡操作
inquiryPayout	查询转账到卡结果
notifyPayout	接收转账到卡结果通知

发布日期：2023年2月22日

新增

submitTradeOrder 接口：

新增 resultCode: REGULATED_COUNTRY_NOT_SUPPORTED

修改

submitTradeOrder 接口：

修改 tradeOrders.bizContractInfo.tradeCountry 和 tradeOrders.bizContractInfo.deliverCountry 的字段描述、字段必填条件

发布日期：2022年12月8日

新增”上传交易信息”相关接口

接口名称	功能
submitTradeOrder	可使用本接口进行交易信息上传。本接口所需上传的附件，需要调用 submitAttachment 接口上传。
submitAttachment	调用此API上传 submitTradeOrder接口所需的附件。
receiveAssociationResultNotification	万里汇收到交易信息上传（submitTradeOrder）请求、处理请求后，会调用本接口发送结果通知。

发布日期：2022年10月24日

修改

inquiryStatementList 接口：

transactionType 类型增加枚举值：PAYMENT, FX_ADJUSTMENT, FX_FEE, REFUND

发布日期：2022年10月24日

新增

createTransfer 接口：

增加 BankAccountPaymentMethodDetail.beneficiaryAddress 字段

修改

createTransfer 接口：

BankAccountPaymentMethodDetail下holderAccountName 字段改名为： bankAccountName

发布日期: 2022年9月28日

新增

inquiryStatementList 接口

增加 statementList.fundMoveDetail.receiveAccount 字段

删除

createTransfer 接口

删除 transferToDetail.transferToAmount.value 字段

发布日期：2022年8月31日

新增

inquiryAccount 接口

发布日期: 2022年8月26日

新增

inquiryAvailableCalendar 接口：

增加字段： ForwardType