Skip to main content

API Changelog - 2026-06-24: Summary

FPX bank codes have been unified: new _business-suffixed codes are now available for all supported banks, six legacy B2B codes have been replaced by their _business equivalents, and the commercialTransactionType field is deprecated because the bank code itself now encodes whether a transaction is B2B or B2C.


POST /v1/payments — Create Payment

The paymentMethod.fpx.bank.code enum has been expanded with new _business-suffixed codes covering B2B transactions for all supported banks. Six legacy B2B codes — affin_max, bnp_paribas, citibank, deutsche_bank, public_bank_enterprise, and united_overseas_bank_regional — have been removed from the enum and replaced by their _business equivalents. Integrations using any of the removed codes must migrate to the corresponding _business code.

The paymentMethod.fpx.commercialTransactionType field is now deprecated. The bank code already encodes the transaction type (B2B or B2C), so this field is no longer required and will be removed in a future release.

PropertyDetails
NamepaymentMethod.fpx.bank.code
LocationRequest body
Typestring
RequiredYes
FormatEnum — _business codes added; 6 removed
Example"maybank_business"
PropertyDetails
NamepaymentMethod.fpx.commercialTransactionType
LocationRequest body
Typestring
RequiredNo (optional)
FormatEnum (b2c, b2b) — deprecated
Example"b2b"

GET /v1/payments — Get All Payments

The paymentMethod.fpx.bank.code field in the response now reflects the updated set of FPX bank codes, including new _business-suffixed codes. Responses for payments initiated with a legacy B2B code will return the corresponding _business code.

PropertyDetails
NamepaymentMethod.fpx.bank.code
LocationResponse body (data[])
Typestring
RequiredYes
FormatEnum — _business codes addedmodified
Example"cimb_bank_business"

GET /v1/payments/{paymentId} — Get Payment by ID

The paymentMethod.fpx.bank.code field in the response now reflects the updated set of FPX bank codes, including new _business-suffixed codes.

PropertyDetails
NamepaymentMethod.fpx.bank.code
LocationResponse body
Typestring
RequiredYes
FormatEnum — _business codes addedmodified
Example"rhb_bank_business"

GET /v1/transactions — Get All Transactions

The paymentMethod.fpx.bank.code field in the response now reflects the updated set of FPX bank codes, including new _business-suffixed codes.

PropertyDetails
NamepaymentMethod.fpx.bank.code
LocationResponse body (data[])
Typestring
RequiredYes
FormatEnum — _business codes addedmodified
Example"hsbc_bank_business"

GET /v1/transactions/{transactionId} — Get Transaction by ID

The paymentMethod.fpx.bank.code field in the response now reflects the updated set of FPX bank codes, including new _business-suffixed codes.

PropertyDetails
NamepaymentMethod.fpx.bank.code
LocationResponse body
Typestring
RequiredYes
FormatEnum — _business codes addedmodified
Example"alliance_bank_business"