发版说明
发布日期：2025年9月23日
修改
接口名 | 影响内容 |
响应体
| |
请求体：
| |
响应体：
| |
请求体：
响应体：
| |
请求体 & 响应体：
| |
请求体 & 响应体：
| |
响应体：
| |
请求体：
| |
响应体：
| |
响应体：
| |
为以下字段值输入新增 电子钱包品牌名称
|
发布日期：2025年6月20日
新增
- 新增银行列表和提示信息，以提醒客户正确输入以下字段值：
- bankLocalName
- bankName
修改
接口名 | 影响内容 |
响应体
更新卡信息要素列表
| |
请求体
| |
请求体
响应体
| |
请求体
响应体
| |
响应体
| |
请求体
| |
响应体：
| |
响应体：
| |
请求体：
| |
新增主体校验集成方案 | |
为以下字段值输入新增银行列表：
|
发布日期：2025年6月6日
新增
为更好地提升使用万里汇账号管理动帐消息的能力，新增以下接口：
新增以下集成文档：
修改
接口名 | 影响内容 |
请求体：
响应体：
| |
响应体：
| |
请求体：
响应体：
|
发布日期：2025年5月14日
新增
为更好地提升使用万里汇进行申请、使用VC授信的能力，新增以下接口：
- queryCreditQuota
- consultLoan
- applyLoan
- queryLoanList
- queryLoanDetail
- queryRepaymentList
- queryRepaymentDetail
修改
接口名 | 影响内容 |
响应体：
| |
响应体：
| |
响应体：
| |
响应体：
| |
响应体：
| |
请求体：
|
发布日期：2025年4月21日
修改
接口名 | 影响内容 |
响应体：
| |
响应体：
| |
响应体：
| |
响应体：
| |
响应体：
| |
请求体：
|
发布日期：2025年3月28日
新增
为更好地提升使用万里汇进行申请、查询授信额度的能力，新增以下接口：
新增以下集成文档：
修改
接口名 | 影响内容 |
请求体：
|
发布日期：2025年3月17日
新增
为更好地提升使用万里汇账号管理收款人的能力，新增以下接口：
修改
接口名 | 影响内容 |
请求体：
| |
请求体&响应体：
| |
请求体&响应体：
| |
响应体：
| |
请求体：
|
发布日期：2025年2月25日
修改
接口名 | 影响内容 |
请求体：
响应体：
|
发布日期：2024年12月13日
删除
为更好地提升万里付卡相关API的集成能力，将万里付卡管理相关API从万里付企业解决方案中删除。
关于万里付卡API具体功能详见：万里付卡解决方案。
发布日期：2024年11月29日
新增
为提高使用万里汇账号编辑收款人及查询历史汇率的能力，新增以下接口：
修改
接口名 | 影响内容 |
请求体：
| |
请求体：
|
发布日期：2024年11月21日
修改
接口名 | 影响内容 |
请求体：
响应体：
| |
请求体：
响应体：
| |
请求体：
响应体：
| |
请求体：
响应体：
|
发布日期：2024年11月06日
新增
为提高使用万里汇账号进行万里付卡管理的能力，新增以下接口：
接口名称 | 功能 |
可调用此接口查询企业联系人列表。 | |
可调用此接口，向万里汇申请万里付卡片。 | |
集成商可调用此接口查询持有的所有万里付卡片。 | |
集成商可调用此接口查询某一张万里付卡的详细信息。 | |
集成商可调用此接口查询万里付卡片的敏感信息。 | |
集成商可调用此接口修改万里付卡片的状态，如冻结、解冻、删除卡片等。 | |
万里汇使用此接口向集成商返回万里付卡片的最终状态。 | |
集成商可调用此接口更新万里付卡片限额。 | |
集成商可调用此接口查询万里付卡片的交易记录。 | |
万里汇会调用此接口将交易金额、交易结果等相关账单信息通知给集成商。 |
修改
接口名 | 影响内容 |
|
发布日期：2024年9月24日
新增
为提高使用万里汇账号进行账单详情查询的能力，新增以下接口：
修改
接口名 | 影响内容 |
请求体：
响应体：
| |
请求体：
响应体：
| |
请求体：
响应体：
| |
请求体：
响应体：
| |
请求体：
| |
响应体：
| |
请求体：
|
发布日期：2024年8月15日
新增
为满足集成商提供打款证明以及财务合规备案的诉求，新增以下三个交易凭证下载接口：
修改
接口名 | 影响内容 |
请求体：
响应体：
| |
请求体：
响应体：
| |
请求体：
|
发布日期：2024年7月15日
修改
接口名 | 影响内容 |
请求体：
响应体：
|
发布日期：2024年7月4日
修改
接口名 | 影响内容 |
请求体：
响应体：
| |
请求体：
响应体：
| |
请求体：
| |
请求体：
响应体：
| |
请求体：
| |
请求体：
|
发布日期：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日
修改
为提高使用万里汇主子账号进行资金互转的操作效率，对以下内容进行变更：
接口名 | 影响内容 |
请求体：
响应体：
| |
响应体：
| |
请求体：
|
发布日期：2024年1月17日
修改
为提高使用万里汇查询VA账户信息的能力，对以下内容进行变更：
接口名 | 影响内容 |
响应体：
accountInfos.bankAccountList.bankRegion
| |
响应体：
|
发布日期：2023年11月17日
修改
针对 submitTradeOrder API:
修改了 tradeOrders.shipping.wayBillInfos.shippingOrderReferenceNo 字段的描述。
发布日期：2023年11月3日
修改
为提高OAuth能力，在以下API中，将INVALID_ACCESS_TOKEN 全部修改为 AUTHORIZATION_NOT_EXIST：
- revokeToken
- inquiryDeal
- createDeal
- notifyDeal
- unwindDeal
- inquiryStore
- inquirySubuser
- inquiryExchange
- createExchange
- inquiryBalance
- inquiryStatementList
发布日期：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日
修改
接口名 | 影响内容 |
请求体：修改以下字段描述
|
发布日期：2023年9月4日
修改
为提高万里汇账单查询、订单关联以及结汇等场景下的能力，对以下接口进行变更：
接口名 | 影响内容 |
| |
| |
请求体：新增tradeOrders.logisticsMode字段 | |
请求体：新增以下字段
| |
| |
新增
|
发布日期：2023年8月8日
修改
为提高集成商通过万里汇进行收款和结汇的能力，对以下接口进行变更：
接口名 | 影响内容 |
| |
响应体：新增以下字段
| |
| |
| |
响应体：新增以下字段的枚举值 transferToDetail.transferToMethod.paymentMethodMetaData.bankAccountPaymentMethodDetail.bankLocalName | |
请求体：新增以下字段的枚举值 transferToDetail.transferToMethod.paymentMethodMetaData.bankAccountPaymentMethodDetail.bankLocalName |
发布日期：2023年7月28日
修改
为加强集成商使用万里汇进行交易管理的能力，对以下接口进行变更：
接口名 | 影响内容 |
|
发布日期：2023年7月24日
修改
对于所有的 transfer 和 payout接口，从TransferToDetail 对象中删除feeMode 字段。
发布日期：2023年7月17日
修改
为加强集成商使用万里汇进行多币种收款的能力。为了支持多币种收款能力，对inquireStore接口进行以下了变更：
接口名 | 影响内容 |
|
发布日期：2023年6月13日
支持OAuth授权，新增和修改以下API。
新增
- applyToken API
- refreshToken API
- revokeToken API
- inquirySubuser API
- inquiryStore API
修改
章节名 | 影响内容 |
部分API的请求头包含 Access-Token 参数，用于OAuth授权。 | |
| |
发布日期：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日
修改
为加强集成商通过万里汇进行结汇的能力，对以下接口进行修改：
接口名 | 影响内容 |
| |
| |
| |
|
发布日期：2023年5月29日
新增
- 为支持集成商通过万里汇完成单据支付，新增 createInvoice 和 notifyInvoice 接口。
- 为支持集成商通过万里汇查询可用结汇额度，新增 inquiryAvailableQuota 接口。
修改
为加强集成商通过万里汇的交易和转账能力，对以下接口进行修改：
接口名 | 影响内容 |
| |
| |
响应体：将 transferFromDetail.availableQuota 字段层级上移，变更为 availableQuota 字段 |
发布日期：2023年4月28日
新增
- 从风险管控的角度出发，为了支撑客户，尤其是对于 CN HK EC (E-commerce) 的客户, 在不同业务场景下，可使用不同的余额类型对资金余额做分隔管理, 设计核心字段 balanceTypes 来实现此能力。
接口名 | 影响内容 |
inquiryBalance |
|
inquiryStatementList |
|
- 为加强外汇的即期交易能力，修改以下接口：
接口名 | 影响内容 |
inquiryAvailableCalendar | 请求体：增加 exchangeTradeType 字段 |
createQuote |
|
createDeal | 请求体：增加 exchangeTradeType 字段 |
notifyExchange |
|
createExchange |
|
inquiryExchange | 请求体：增加 exchangeUnfundedInfo 字段 |
Data Dictionary | 为 QuoteForwardInfo 模型增加 settlementTimeType 字段 |
修改
为加强外汇的即期交易能力，修改以下接口：
接口名 | 影响内容 |
inquiryAvailableCalendar | 将 forwardType 字段从 |
createQuote |
|
createDeal |
|
createExchange |
|
Data Dictionary |
|
发布日期：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) 模块。
接口名称 | 功能 |
查询转账到户相关信息 | |
可调用本接口进行资金转账到户操作 | |
查询转账到户结果 | |
接收转账到户结果通知 | |
查询转账到卡相关信息 | |
可调用本接口进行资金转账到卡操作 | |
查询转账到卡结果 | |
接收转账到卡结果通知 |
发布日期：2023年2月22日
新增
submitTradeOrder 接口：
- 新增 resultCode:
REGULATED_COUNTRY_NOT_SUPPORTED
修改
submitTradeOrder 接口：
- 修改 tradeOrders.bizContractInfo.tradeCountry 和 tradeOrders.bizContractInfo.deliverCountry 的字段描述、字段必填条件
发布日期：2022年12月8日
新增”上传交易信息”相关接口
接口名称 | 功能 |
可使用本接口进行交易信息上传。本接口所需上传的附件，需要调用 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