WorldFirst DocsWorldFirst Docs

Release notes

Release date: July 31, 2026

Added

  • A new queryCardBinConfig API has been added to the card management module, empowering users to query card BIN information before applying card.

Modified

API name

Impacts

applyCard

Request body

  • Added the following parameter:
    • binId
  • Updated the code sample

createCardholder

Request body

  • Added the following input values for the parameter identification.fileList.fileType:
    • name
    • relationship
  • Updated the code sample

inquiryStatementList

Request body

  • Added the following input values for the parameter transactionTypeList:
    • CARD_SERVICE_FEE
    • CARD_SERVICE_FEE_REFUND
  • Updated the code sample

Response body

  • Added the following input values for the parameter statementList.transactionType:
    • CARD_SERVICE_FEE
    • CARD_SERVICE_FEE_REFUND
  • Added the following new parameters:
    • statementList.feeItemInfoList
    • statementList.feeItemInfoList.feeTypeCode
    • statementList.feeItemInfoList.feeTransStatus
    • statementList.feeItemInfoList.feeAmount
    • statementList.feeItemInfoList.feeAmount.value
    • statementList.feeItemInfoList.feeAmount.currency
  • Updated the code sample

inquiryStatementDetail

Response body

  • Added the following input values for the parameter transactionType:
    • CARD_SERVICE_FEE
    • CARD_SERVICE_FEE_REFUND
  • Added the following input values for the parameter combinedTransactionList.transactionType:
    • CARD_SERVICE_FEE
    • CARD_SERVICE_FEE_REFUND
  • Added the following new parameters:
    • feeItemInfoList
    • feeItemInfoList.feeTypeCode
    • feeItemInfoList.feeTransStatus
    • feeItemInfoList.feeAmount
    • feeItemInfoList.feeAmount.value
    • feeItemInfoList.feeAmount.currency
  • Updated the code sample

queryBillList

Response body

  • Added the following new parameters:
    • billList..feeItemInfoList
    • billList.feeItemInfoList.feeTypeCode
    • billList.feeItemInfoList.feeTransStatus
    • billList.feeItemInfoList.feeAmount
    • billList.feeItemInfoList.feeAmount.value
    • billList.feeItemInfoList.feeAmount.currency
  • Updated the code sample

notifyBillResult

Request body

  • Added the following new parameters:
    • feeItemInfoList
    • feeItemInfoList.feeTypeCode
    • feeItemInfoList.feeTransStatus
    • feeItemInfoList.feeAmount
    • feeItemInfoList.feeAmount.value
    • feeItemInfoList.feeAmount.currency
  • Updated the code sample

Appendix

Updated the enumerations for transactionType

  • Added the following field input values:
    • CARD_SERVICE_FEE
    • CARD_SERVICE_FEE_REFUND

Release date: July 13, 2026

Modified

API name

Impacts

applyCard

Request body

  • Added the following parameter:
    • budgetAccountId
  • Updated the code sample

Release date: May 26, 2026

Added

  • To enhance the queryContactList capability, the following attachment and cardholder management APIs have been added:

Modified

To improve the card management API capabilities, the following APIs have been upgraded to V2 version:

Release date: Jan 19, 2026

Modified

API name

Impacts

queryBillList

Request body

  • Added the following parameter:
    • assetId
  • Updated the code sample

Response body

  • Added the following parameter:
    • billList.assetId
  • Updated the code sample

Release date: September 11, 2025

Modified

API name

Impacts

applyCard

Request body

  • Added the following parameter:
    • perCardLimitMax
  • Updated the code samples

updateCardLimit

Request body

  • Updated the rule of passing conditions for the following parameter:
    • dailyLimitMax
    • monthlyLimitMax
    • perTransactionLimitMax
  • Updated the code samples

Release date: June 27, 2025

Added

Added the following APIs:

Modified

API name

Impacts

queryBillList

Request body

  • Added the following parameter:
    • budgetAccountIdList
  • Updated the code samples

Response body

  • Added the following parameter:
    • billList.billFailReason
    • billList.payerBalanceType
    • billList.payerBudgetAccountId
  • Updated the code samples

notifyBillResult

Request body

  • Added the following parameter:
    • billFailReason
    • balanceType
    • budgetAccountId
  • Updated the code samples

inquiryBalance

Request body

  • Added the following parameter:
    • balanceTypes = BUDGET_BALANCE
    • budgetAccountId 

Response body

  • Added the following parameter:
    • balanceTypes = BUDGET_BALANCE

inquiryStatementList

Request body

  • Added the following parameter:
    • balanceTypes = BUDGET_BALANCE
    • budgetAccountIds

Response body

  • Added the following parameter:
    • balanceTypes = BUDGET_BALANCE

inquiryStatementDetail

Response body

  • Added the following parameter:
    • balanceTypes = BUDGET_BALANCE

applyCard

Request body

  • Added the following parameter:
    • budgetAccountId
  • Updated the code samples

queryCardList

Request body

  • Added the following parameter:
    • budgetAccountId

Response body

  • Added the following parameter:
    • cardList.budgetAccountId
    • cardList.budgetAccountName
  • Updated the code samples

queryCardDetail

Response body

  • Added the following parameter:
    • budgetAccountId
    • budgetAccountName
  • Updated the code samples

notifyCardStatus

Request body

  • Added the following parameter:
    • budgetAccountId

Appendix

TransactionType

  • Added the following value:
    • FUND_PURCHASE_REFUND
    • SETTLEMENT_COLLECTION_REFUND
    • CREDIT_DRAW_DOWN
    • CREDIT_REPAY
    • PAY_FROM_TRADE

Release date: Mar 6, 2025

Modified

API name

Impacts

queryBillList

Request body

  • Modified the following parameter:
    • startTime
    • endTime

Release date: Feb 7, 2025

Modified

API name

Impacts

updateCardLimit

Request body

  • Added the following parameter:
    • perCardLimitMax

Updated the code samples

queryCardList

Response body

  • Added the following parameter:
    • cardList.cardLimitDetail.perCardLimit

Updated the code samples

queryCardDetail

Response body

  • Added the following parameter:
    • cardLimitDetail.perCardLimit

Updated the code samples

Release date: Nov 21, 2024

The first version of this documentation is released.