Fund your Issued Cards
Unlike Debit Cards, which draw directly from a main account's available balance, Prepaid Cards operate on a pre-funded model. You manage the balance of a Prepaid Card through two distinct funding operations: Card Load (adding funds) and Card Unload (withdrawing funds).
Both operations utilize the exact same underlying transaction endpoint to move money between the master Passport account and the individual Prepaid Card.
Loading a Prepaid Card
A Card Load operation provisions funds for an employee's upcoming expenses. It debits the master Passport account and credits the target Prepaid Card, giving the user an immediate spendable balance. You can use the POST
| Field | Required | Description |
|---|---|---|
method | Mandatory | Payment method of transaction. In this case, it will always be BOOK. |
type | Optional | Type of send. REGULAR – Initiated by customer to payments. |
amount | Mandatory | The dollar value of the transaction. The amount must be greater than zero. |
purpose | Mandatory | Purpose of the transaction. All characters are allowed. |
source | Mandatory | The Passport account to be debited to process the transaction. |
source.account.id | Mandatory | Unique identifier assigned by Passport for the account entity. |
destination | Mandatory | The Prepaid card to be credited via transaction. |
destination.card.id | Mandatory | Unique identifier of the Prepaid Card issued to the authorized user to load the card with funds. |
metadata | Optional | A key-value pair to store additional information for the load transaction. |
tags | Optional | Labels/tags assigned to a transaction to load or unload a card. |
Unload a Prepaid Card
A Card Unload operation reclaims funds. If an employee returns from a trip with an unspent allowance or a card is being closed, this operation reverses the flow by debiting the Prepaid Card and crediting the money back to the master Passport Account.
| Field | Required | Description |
|---|---|---|
method | Mandatory | Payment method of transaction. In this case, it will always be BOOK. |
type | Optional | Type of send. Possible value: REGULAR – Initiated by customer to payments. |
amount | Mandatory | The dollar value of the transaction. The amount must be greater than zero. |
purpose | Mandatory | Purpose of the transaction. All characters are allowed. |
source | Mandatory | The Prepaid Card to be debited to process the transaction. |
source.card.id | Mandatory | Unique identifier assigned by Passport for the Prepaid Card. |
destination | Mandatory | The Passport Account to be credited via transaction. |
destination.account.id | Mandatory | Unique identifier assigned by Passport for the account entity that is to be credited with funds. |
metadata | Optional | A key-value pair to store additional information for the scheduled load card transaction. |
tags | Optional | Labels/tags assigned to a load card transaction. |
Updated about 13 hours ago