Create a virtual card
POST/api/v1/cards/virtual
Creates a virtual card without requiring a card order. Virtual cards are free and activated immediately. No shipping address or payment validation is required.
Card Limits: Users can have a maximum of 10 active cards (physical + virtual combined). Active cards exclude voided, lost, and stolen cards.
Responses
- 201
- 401
- 409
- 422
- 500
Virtual card created successfully
Unauthorized Error
User already has a card or card order in progress
Unprocessable Entity - User validation failed. Possible reasons:
- User has reached the maximum number of active cards (10)
- User needs to complete KYC successfully
- User has incompatible risk score
- User does not have a verified phone number
- User's name is not set or contains invalid characters
- User's address is not set
- User's country is not supported
- Could not create virtual card due to safe misconfiguration
Internal server error