发版说明
发布日期: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