发版说明

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

新增

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

修改

接口名

影响内容

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_IDEMPOTENTREFERENCE_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.transferToRemarktransferToAmount.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

  1. 请求头中传入Access-Token 参数
  2. 增加以下 result code: 
    • ACCESS_TOKEN_EXPIRED
    • INVALID_ACCESS_TOKEN

inquiryStatementList

发布日期:2023年6月9日

新增

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

修改

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

  • invoice.bill.billSender.userNameinvoice.bill.billReceiver.userName 字段的数据类型从字符串改为 UserName 对象。
  • invoice.bill.billSender.userAddressinvoice.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日

新增

修改

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

接口名

影响内容

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_IDCOLLECTION_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_ASSOCIATECREATE_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 字段
  • 请求体: 删除 customerIdaccessToken 字段
  • 更新请求体范例、请求代码范例和响应体范例

发布日期:2023年4月10日

修改

inquiryStatementList 接口修改:

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

发布日期:2023年4月7日

新增

    • 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 个代码示例。

修改

    • 修改以下请求体字段的描述:
      • 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 的描述。
    • 请求头中添加 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.tradeCountrytradeOrders.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 接口:

  • BankAccountPaymentMethodDetailholderAccountName 字段改名为: bankAccountName

发布日期: 2022年9月28日

新增

inquiryStatementList 接口

  • 增加 statementList.fundMoveDetail.receiveAccount 字段

删除

createTransfer 接口

  • 删除 transferToDetail.transferToAmount.value 字段

发布日期:2022年8月31日

新增

inquiryAccount 接口

发布日期: 2022年8月26日

新增

inquiryAvailableCalendar 接口:

  • 增加字段 ForwardType 

@2024 WorldFirst