WorldFirst DocsWorldFirst Docs

发版说明

发布日期：2026年7月31日

新增

  • 卡管理模块新增 queryCardBinConfig 接口，以支持用户于开卡前查询卡 BIN 的能力。

修改

接口名

影响内容

applyCard

请求体

  • 新增以下参数：
    • binId
  • 更新示例代码

createCardholder

请求体

  • 为 identification.fileList.fileType 字段新增以下取值：
    • name
    • relationship
  • 更新示例代码

inquiryStatementList

请求体

  • 为 transactionTypeList 字段新增以下取值：
    • CARD_SERVICE_FEE
    • CARD_SERVICE_FEE_REFUND
  • 更新示例代码。

响应体

  • 为 statementList.transactionType 字段新增以下取值：
    • CARD_SERVICE_FEE
    • CARD_SERVICE_FEE_REFUND
  • 新增以下字段：
    • statementList.feeItemInfoList
    • statementList.feeItemInfoList.feeTypeCode
    • statementList.feeItemInfoList.feeTransStatus
    • statementList.feeItemInfoList.feeAmount
    • statementList.feeItemInfoList.feeAmount.value
    • statementList.feeItemInfoList.feeAmount.currency
  • 更新示例代码。

inquiryStatementDetail

响应体

  • 为 transactionType 字段新增以下取值：
    • CARD_SERVICE_FEE
    • CARD_SERVICE_FEE_REFUND
  • 为 combinedTransactionList.transactionType 字段新增以下取值：
    • CARD_SERVICE_FEE
    • CARD_SERVICE_FEE_REFUND
  • 新增以下字段：
    • feeItemInfoList
    • feeItemInfoList.feeTypeCode
    • feeItemInfoList.feeTransStatus
    • feeItemInfoList.feeAmount
    • feeItemInfoList.feeAmount.value
    • feeItemInfoList.feeAmount.currency
  • 更新示例代码。

queryBillList

响应体

  • 新增以下字段：
    • billList..feeItemInfoList
    • billList.feeItemInfoList.feeTypeCode
    • billList.feeItemInfoList.feeTransStatus
    • billList.feeItemInfoList.feeAmount
    • billList.feeItemInfoList.feeAmount.value
    • billList.feeItemInfoList.feeAmount.currency
  • 更新示例代码。

notifyBillResult

请求体

  • 新增以下字段：
    • feeItemInfoList
    • feeItemInfoList.feeTypeCode
    • feeItemInfoList.feeTransStatus
    • feeItemInfoList.feeAmount
    • feeItemInfoList.feeAmount.value
    • feeItemInfoList.feeAmount.currency
  • 更新示例代码。

附录

更新 transactionType 枚举值列表：

  • 新增以下取值：
    • CARD_SERVICE_FEE
    • CARD_SERVICE_FEE_REFUND

发布日期：2026年7月13日

修改

接口名

影响内容

applyCard

请求体

  • 新增以下字段：
    • budgetAccountId
  • 更新代码示例

发布日期：2026年5月26日

新增

  • 为优化 queryContactList 能力，新增以下附件及持卡人管理接口：

修改

为提升卡管理接口能力，将以下接口升级为 V2 版本：

发布日期：2026年1月19日

修改

接口名

影响内容

queryBillList

请求体

  • 新增以下字段：
    • assetId
  • 更新代码示例

响应体

  • 新增以下字段：
    • billList.assetId
  • 更新代码示例

发布日期：2025年9月11日

修改

接口名

影响内容

applyCard

请求体

  • 新增以下字段：
    • perCardLimitMax
  • 更新代码示例

updateCardLimit

请求体

  • 更新以下字段的传参条件：
    • dailyLimitMax
    • monthlyLimitMax
    • perTransactionLimitMax
  • 更新代码示例

发布日期：2025年6月27日

新增

为了提高集成商利用万里付卡的能力，新增以下接口：

修改

接口名

影响内容

queryBillList

请求体：

  • 新增以下字段：
    • budgetAccountIdList
  • 更新代码示例

响应体：

  • 新增以下字段：
    • billList.billFailReason
    • billList.payerBalanceType
    • billList.payerBudgetAccountId
  • 更新代码示例

notifyBillResult

请求体：

  • 新增以下字段：
    • billFailReason
    • balanceType
    • budgetAccountId
  • 更新代码示例

inquiryBalance

请求体：

  • 新增以下取值：
    • balanceTypes = BUDGET_BALANCE
  • 新增以下字段：
    • budgetAccountId

响应体：

  • 新增以下取值：
    • balanceTypes = BUDGET_BALANCE

inquiryStatementList

请求体：

  • 新增以下取值：
    • balanceTypes = BUDGET_BALANCE
  • 新增以下字段：
    • budgetAccountIds

响应体：

  • 新增以下取值：
    • balanceType = BUDGET_BALANCE

inquiryStatementDetail

响应体：

  • 新增以下取值：
    • balanceType = BUDGET_BALANCE

applyCard

请求体：

  • 新增以下字段：
    • budgetAccountId
  • 更新代码示例

queryCardList

请求体：

  • 新增以下字段：
    • budgetAccountId

响应体：

  • 新增以下字段：
    • cardList.budgetAccountId
    • cardList.budgetAccountName
  • 更新代码示例

queryCardDetail

响应体：

  • 新增以下字段：
    • budgetAccountId
    • budgetAccountName
  • 更新代码示例

notifyCardStatus

请求体：

  • 新增以下字段：
    • budgetAccountId

附录

TransactionType

  • 新增以下枚举值：
    • FUND_PURCHASE_REFUND
    • SETTLEMENT_COLLECTION_REFUND
    • CREDIT_DRAW_DOWN
    • CREDIT_REPAY
    • PAY_FROM_TRADE

发布日期：2025年3月6日

修改

接口名

影响内容

queryBillList

请求体：

  • 修改以下字段：
    • startTime
    • endTime

发布日期：2025年2月7日

修改

接口名

影响内容

updateCardLimit

请求体：

  • 新增以下字段：
    • perCardLimitMax
  • 更新代码示例

queryCardList

响应体：

  • 新增以下字段：
    • cardList.cardLimitDetail.perCardLimit
  • 更新代码示例

queryCardDetail

响应体：

  • 新增以下字段：
    • cardLimitDetail.perCardLimit
  • 更新代码示例

发布日期: 2024年11月20日

发布本文档的第一版。