VIRTUAL · PHYSICAL
•••• 4412
Visa
Visa programs
Card creation, status, controls, and transaction visibility where the program enables them.
Exploratory — confirmed during program design
CARD ISSUING INFRASTRUCTURE
Build card issuing capabilities into your wallet, exchange, or fintech application. Connect card creation, card management, transaction events, and operational controls through a structured API integration.
Designed for businesses building branded virtual and physical card experiences through approved issuing and processing partners.
/v1/cardsIllustrative API example{"customer_id": "cust_8f42…","card_type": "virtual","program_id": "prog_…","idempotency_key": "req_01J…"}
{"card_id": "card_5d21…","status": "pending_issuance","card_type": "virtual","last4": "•• 4412"}
•••• •••• •••• 4412
CARDHOLDERissuing
Card creation requested — status returns to your backend.
Final issuance outcome is determined by the issuing partner.
CARD NETWORK OPTIONS
Explore virtual and physical card program options across eligible networks and issuing partners. Network availability, supported regions, and card capabilities depend on the approved program structure.
VIRTUAL · PHYSICAL
•••• 4412
Visa
Card creation, status, controls, and transaction visibility where the program enables them.
Exploratory — confirmed during program design
PROGRAM OPTION
•••• 4412
Mastercard
Card creation, status, controls, and transaction visibility where the program enables them.
Exploratory — confirmed during program design
VIRTUAL · PHYSICAL
•••• 4412
Discover
Card creation, status, controls, and transaction visibility where the program enables them.
Exploratory — confirmed during program design
PROGRAM OPTION
•••• 4412
UnionPay
Card creation, status, controls, and transaction visibility where the program enables them.
Exploratory — confirmed during program design
Network names are shown for program exploration only. Availability is verified with the issuing partner for your markets before any commitment.
HOW IT WORKS
Your application connects to the card platform through supported APIs. Card creation, lifecycle updates, and transaction events are coordinated through the relevant issuing and processing integrations.
STEP 1 OF 5
Collect the required customer information and complete applicable identity verification before card issuance, according to the approved program requirements.
request direction response / event
customer = collect_application()verification = check_status(customer)if verification == "approved":enable_card_creation(customer)
API ARCHITECTURE
Build your customer-facing experience while connecting the required card operations to approved issuing and processing systems. Keep responsibilities clear across your application, integration services, and regulated program partners.
LAYER A
LAYER B
LAYER C
Final architecture and responsibilities depend on the selected issuing partner and commercial program arrangement.
INTERACTIVE API EXPLORER
Understand the typical integration workflows behind card creation, management, and transaction visibility.
Submit a card creation request after the customer has completed the required onboarding and verification steps. The issuing partner determines the final issuance outcome.
/v1/cardsIllustrative API example| Parameter | Type | Notes |
|---|---|---|
| customer_id | string | Verified customer reference from your system. |
| card_type | enum | virtual or physical, where supported. |
| program_id | string | Approved program configuration to issue under. |
| idempotency_key | string | Prevents duplicate cards on safe retries. |
{"customer_id": "cust_8f42…","card_type": "virtual","program_id": "prog_…","idempotency_key": "req_01J…"}
{"card_id": "card_5d21…","status": "pending_issuance","card_type": "virtual"}
Errors & edge cases
Handle validation errors per-field, treat timeouts as unknown outcomes (query status before retrying), and never create a second card for the same idempotency key.
Card lifecycle
none → pending_issuance → active / declined (issuer decision)
CARD LIFECYCLE
Support the card experiences your business needs, from digital-first card access to physical card programs, where supported by your issuing arrangement.
YOUR APP
VIRTUALACTIVE
•••• •••• •••• 4412
Coffee ••••$4.80
Transit ••••$2.40
Cloud ••••$19.00
Offer eligible customers a digital card experience inside your application, with supported card controls, transaction visibility, and account management.
PHYSICAL CARDYOUR BRAND
•••• •••• •••• 4412
CARDHOLDER NAMEVALID ••/••
Ordered — Card produced under the approved program
Dispatched — Delivery status tracked operationally
Delivered — Cardholder confirms receipt
Activated — Activation workflow completed in-app
Explore physical card issuance with supported card artwork, delivery workflows, activation processes, and card lifecycle management.
SECURITY & TESTING
Card issuing integrations require careful handling of customer information, authenticated requests, event delivery, and operational permissions. Design your integration around clear access boundaries and robust failure handling.
Request authentication flow
Webhook validation flow
Protect API access using the authentication methods supported by the integration, secure credential storage, restricted permissions, and controlled backend access.
Minimize exposure of payment credentials. Use approved tokenization and secure card-data handling mechanisms where required by the issuing arrangement.
Validate event authenticity, handle retries, prevent duplicate processing, and maintain reliable event delivery records.
Use available test environments to validate card creation, lifecycle updates, transaction handling, error scenarios, and webhook processing before production rollout.
Track integration errors, processing failures, request outcomes, and operational exceptions to support reliable day-to-day management.
CAPABILITIES MATRIX
| Capability | Typical use case | Integration approach | Availability / dependency |
|---|---|---|---|
| Customer onboarding integration | Collect applications inside your app | Your UI + verification handoff | Program dependent |
| Card creation | Issue virtual/physical cards | API request via integration layer | Issuer dependent |
| Card status retrieval | Show live card state to users | API read / event sync | Supported where enabled |
| Card freeze / unfreeze | User & operator card controls | Control API actions | Issuer dependent |
| Virtual card management | Digital-first card access | In-app card experience | Supported where enabled |
| Physical card workflows | Order, deliver, activate cards | Fulfilment workflow + API status | Program dependent |
| Transaction history | Spending views & notifications | API reads + webhook events | Supported where enabled |
| Webhook notifications | React to events in real time | Signed event delivery | Requires confirmation |
| Operational reporting | Ops visibility & reconciliation | Reports / admin tooling | Program dependent |
| Cardholder management | Support & lifecycle operations | Admin workflows | Supported where enabled |
| Funding workflow integration | Connect balances to card spend | Conversion & settlement arrangement | Requires confirmation |
| Role-based administration | Control team permissions | Admin roles & audit trail | Program dependent |
Availability labels are deliberately conservative: final capability depends on the issuing partner and program configuration confirmed for your business.
USE CASES
Extend an exchange experience with branded card functionality, subject to supported funding, conversion, and issuing arrangements.
Give wallet users access to supported card experiences through integrated card management and transaction visibility.
Add card issuing capabilities to a broader financial application while maintaining a consistent customer interface and operational workflow.
IMPLEMENTATION SUPPORT
Discuss your existing application, API requirements, card products, target markets, and operational needs with the Nadcab team.
Talk to an Integration SpecialistWhat the first technical review covers
Potentially, yes. Supported APIs can connect card-related functionality to an existing wallet application. The integration scope depends on your wallet architecture, funding workflows, and the selected issuing partner.
READY TO INTEGRATE?
Tell us what you're building. We'll help you evaluate the available API capabilities, integration requirements, issuing dependencies, and implementation approach.
Explore More Solutions
From launching your own branded cards to integrating issuing APIs and digital payment infrastructure, explore the solutions that help you build and scale your card business.
Card Programs
Explore the complete branded crypto card program — issuing, funding, platform, compliance, and operations in one place.
Card Programs
Launch virtual and physical crypto cards under your own brand with customizable cardholder experiences and program management tools.
Card Customization
Create a card experience that reflects your business identity with branded designs and configurable cardholder features.
Card Products
Offer digital cards for online spending and physical cards for in-store purchases and ATM access where supported.
Payment Infrastructure
Accept supported cryptocurrency payments through flexible integrations, transaction monitoring, and settlement workflows.
Digital Commerce
Integrate digital gift card purchasing, delivery, and order management into your wallet, exchange, or fintech platform.