Choose the Documentation MX Merchant MX Connect

Fund your Issued Cards

Make funds available for card usage—based on how your cards are configured.

Once a card is issued, it must have access to funds before it can be used for transactions.

How funding works depends on the card type:

Debit Cards
Transactions draw funds directly from the linked account balance in real time. Ensure the account has sufficient funds before usage.
Prepaid Cards
Cards must be pre-funded before use. Funds are loaded onto the card and deducted from the source account.

Funding Debit Cards

Debit cards do not require a separate funding step at the card level. Instead, you need to ensure that the linked account has sufficient balance.

Move funds between entities within the platform using the BOOK method. This is typically used to:

  • Allocate funds across accounts
  • Instantly make funds available for debit card usage

Use the POST /v1/customer/id/{id}/transaction API to add funds to the account linked to the card.

ParameterRequiredValue
methodBOOK
source.account.idAccount to be debited
destination.account.idAccount to be credited
amountAmount to be transferre

Funding Prepaid Cards

Prepaid cards require explicit funding before they can be used. You manage the card balance using two operations:

Load Funds to a Prepaid Card

Add funds to a prepaid card using the POST /v1/customer/id/{id}/transaction API, along with following key parameters:

ParameterRequiredValue
methodBOOK
source.account.idAccount to be debited
destination.card.idCard to be credited
amountAmount to load
💡

Funds are deducted from the account and made available on the card.

Unload Funds from a Card

Move unused funds back to the account using the POST /v1/customer/id/{id}/transaction API, along with following key parameters:

ParameterRequiredValue
methodBOOK
source.card.idCard to be debited
destination.account.idAccount to be credited
amountAmount to unload
💡

Funds are removed from the card and returned to the account.