The card management provides a suite of lifecycle actions and APIs for both debit and prepaid cards, ensuring you can instantly take action for real-world events like lost cards, card damage, or fraud.

Card Management Actions (Debit & Prepaid)

Through the Unified API, you can perform several state-management operations for both card types:

Freeze a Card:

A "soft lock" that temporarily pauses authorization requests if a card is misplaced or flagged for unusual velocity, protecting the underlying balance without closing the account. You can use the POST /v1/customer/id/{customer_id}/issuance/card/id/{card_id}/suspendincase you wish to freeze a Card. You will be required to add the reason and the freezeTill date until which you wish to freeze your account.

Unfreeze Card:

Reactivates a frozen card, restoring its status to ACTIVE if a lost card is found or a flagged transaction is verified as legitimate. Using thePOST /v1/customer/id/{customer_id}/issuance/card/id/{card_id}/unsuspendyou can unfreeze your card.

Terminate / Close / Cancel Card:

A terminal, irreversible action that permanently invalidates the card's Primary Account Number (PAN) when an employee leaves, a budget expires, or the card is permanently compromised. For Prepaid programs, remaining funds must be unloaded first. Using thePOST /v1/customer/id/{customer_id}/issuance/card/id/{card_id}/close (or "Cancel Prepaid Card" API).

Replace Card

Blocks the existing card and automatically triggers the issuance and shipment of a replacement card with a new PAN, CVV, and expiry date if the original is lost, stolen, or damaged.

• API: POST /v1/customer/id/{customer_id}/issuance/card/id/{card_id}/replace (or "Block & Replace Prepaid Card" API).
• PIN Management: Empowers users to securely self-serve PIN sets or resets for ATM and Point-of-Sale access, reducing support volume.
  • API: POST /v1/customer/id/{customer_id}/issuance/card/id/{card_id}/pin.

Viewing and Upgrading Cards

• List Cards: Retrieve a complete list of issued cards, filterable by type (Prepaid vs. Debit) and status.
  • API: POST /v1/customer/id/{customer_id}/issuance/card/list (or "List Prepaid Cards" API).
• Retrieve Specific Card: Fetch specific details of an issued card, including shipping and tracking info.
  • API: GET /v1/customer/id/{customer_id}/issuance/card/id/{card_id}.
• Retrieve Digital Card Image: Securely displays the sensitive card image in the user's browser using a JavaScript SDK, reducing PCI compliance scope.
• Issue & Enable Physical Cards: If a user with a virtual-only card requires a plastic card for in-person payments, you can order it and then activate it once received to unlock "Card Present" transactions.
  • Issue Physical API: POST /v1/customer/id/{customer_id}/account/id/{account_id}/debitCard/id/{card_id}/issuePhysicalCard.
  • Enable Physical API: POST /v1/customer/id/{customer_id}/account/id/{account_id}/debitCard/id/{card_id}/enablePhysicalCard.

Prepaid-Specific Management Actions Because prepaid cards operate on a pre-funded model rather than drawing directly from an account's available balance, they require distinct funding and spending controls:

• Load Card: Provisions funds from the master Passport account to the target Prepaid Card via a POST "Book" transfer, giving the user an immediate spendable balance.
  • API: Load Card API.
• Unload Card: Reverses the flow by reclaiming unused funds from the Prepaid Card and crediting them back to the master Passport Account.
  • API: Unload Card API.
• Spend Limits: Defines the maximum allowed spending amounts per customer or per card to enforce precise budget controls.
  • APIs: Card Spend Limit and Customer Spend Limit APIs.
• Transaction Activity: Tracks all card activity, including spending, authorizations, captures, reversals, and load/unload events, to monitor the true available balance.
  • API: Retrieve Card Transaction History API.