Partner API
  1. API References
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Get Balances
      • Get Transaction History
      • Retrieve Exchange Rate and Create a Lock
      • Create and Finalize an Exchange
      • Create Crypto Withdrawal
      • Create a SEPA Transfer
      • Get SEPA Transfer Details
    • User Accounts with KYC
      • Create User Account and Generate Balances
      • Add KYC File
      • Add POA File
      • Add User Verification
      • Update Existing User
      • Delete User
      • Suspend User
      • Unsuspend User
      • Get User Balances
      • Get User Transaction History
    • User Accounts without KYC
      • Create User Account and Generate Balances Without KYC
      • Update Existing User
      • Delete User
      • Suspend User
      • Unsuspend User
      • Get User Balances
      • Get User Transaction History
    • KYC by P100
      • Creating KYC Verification
      • Redirect to Verification
      • Get KYC Status
    • Currency Exchange
      • Retrieve Exchange Rate
      • Retrieve Exchange Rate and Create a Lock
      • Create and Finalize an Exchange
      • Retrieve Detailed Exchange Infromation
    • Crypto Deposits
      • Update Travel Rule
    • Crypto Withdrawals
      • Get Network Fee
      • Create Crypto Withdrawal
      • Get Crypto Withdrawal Details
    • Internal Transfers
      • Create a Transfer
      • Get Transfer Details
    • Virtual Cards
      • Create Virtual Card
      • Get All User Cards
      • Get Card Details
      • Update Card PIN
      • Block Card
      • Unblock Card
      • Get Card Limits
      • Update Card Limits
      • Delete Card
    • Custom Fiat Operations
      • SEPA Deposit & Withdrawal
  • Integration
    • SDKs & Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • User & KYC Webhooks
        • User Balance Generation
        • KYC File Added
        • POA Verification Status
        • KYC Verification Status
      • Transfers & Payments Webhooks
        • P2P Transfer Webhook
        • SEPA Transfer
        • SEPA Deposit
        • Crypto Withdrawal
        • Crypto Deposit
        • Exchange
        • Card Transaction
      • Card Webhooks
        • Card 3DS Code
        • Card Activation Code
  • Reference
    • Supported Countries
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. API References

Virtual Cards

This module contains endpoints for creating and managing virtual cards.
Access and Supported Countries
This module is available only for users with completed KYC.
Partners using the non-KYC user model do not have access to card-related functionality.
The list of countries for which virtual card generation is supported is available in
Supported Countries

Core endpoints#

Create Virtual Card
Issue a new virtual card for a KYC-verified user.
Get All User Cards
Retrieve a list of all virtual cards associated with a user.
Get Card Details
Fetch the sensitive details of a specific virtual card.
Update Card PIN
Set or change the Personal Identification Number (PIN) for a card.
Block Card
Temporarily block a virtual card to prevent any transactions.
Unblock Card
Reactivate a previously blocked virtual card.
Get Card Limits
Retrieve the current spending limits for a specific virtual card.
Update Card Limits
Modify the spending limits for a specific virtual card.
Delete Card
Permanently delete a virtual card, making it unusable.

Card Limits#

The following limits apply to virtual cards for each user:
Maximum cards per user:
A user can have up to 10 active or locked cards at any given time. This includes all cards, regardless of their status (active, locked, etc.).
If a user attempts to create a new card while already having 10, the request will be rejected.
Example: If a user has 8 active cards and 2 locked cards, they cannot create another card until one is deleted.
Card creation rate limits:
5 cards per 24 hours: A user can create up to 5 new cards within any rolling 24-hour period.
10 cards per 30 days: A user can create up to 10 new cards within any rolling 30-day period.
20 cards per year: A user can create up to 20 new cards within any rolling 12-month period.
These limits help prevent abuse and ensure fair usage.
Example: If a user creates 5 cards today, they must wait until at least one of those cards is older than 24 hours before creating another.
All limits are enforced at the API level. Attempts to exceed any limit will result in an error response.
Previous
Get Transfer Details
Next
Create Virtual Card
Built with