Card API Overview

Issue and manage corporate virtual cards tied to a NadaPay wallet. Cards support online and POS payments.

What's in this section

GuidePurpose
Issue CardCreate a new virtual card
List CardsView all cards under your organization
Get CardFetch metadata for one card
Get Secure Card DetailsRetrieve full PAN and CVV (server-only)
Set Card PINSet the PIN and activate a card
Switch Card AccountReassign a card to a different wallet

Card lifecycle

  1. Issue the card — it starts inactive
  2. Set a PIN — this activates the card
  3. Use Get Card for safe display metadata; use Get Secure Card Details only when you need the full PAN/CVV
  4. Optionally reassign the card to a different wallet later via Switch Card Account

Security — read this first

  • Get Secure Card Details returns the full PAN and CVV. Call it only from a secure backend, and never log the response.
  • Get Card is the safe endpoint for anything customer- or dashboard-facing — it never exposes PAN or CVV.
  • PINs must be a 4-digit numeric value and should be collected and transmitted only through a tightly scoped, PCI-aware flow on your frontend.


Did this page help you?