Create Card
POST/api/cards
Create a card under a specified card program and affiliated with a Funding Source. Returns an ID with which to retrieve card details.
Request
Responses
- 200
- 400
- 403
Successful operation
Request fields are invalid, or the request could not be processed for the reason stated in the message
SHIPPING_ADDRESS_REQUIRED Card program is configured for physical cards but no shipping address was provided.
User is not allowed to perform the action with the reason stated in the message
FORBIDDEN Insufficient permissions to perform the action.
LIVENESS_MISMATCH Card program or cardholder have the wrong liveness for the request.
CARD_PROGRAM_INVALID Card program does not belong to a partner this cardholder is associated with.
FUNDING_CHANNEL_INVALID Funding channel cannot be used with this card program.
KYC_REQUIRED KYC profile is missing, does not have PASSED status, or does not match card program region. Use the spending prerequisites endpoint for more details.
CONTACT_EMAIL_REQUIRED Cardholder does not have a contact email.
CONTACT_PHONE_REQUIRED Cardholder does not have a contact phone.
EXPECTED_SPEND_PREREQ_REQUIRED Cardholder has not completed the required expected spend prerequisite.
MAX_CARDS_EXCEEDED Cardholder has reached the maximum number of cards allowed.
MAX_ACTIVE_CARDS_EXCEEDED Cardholder has reached the maximum number of active cards allowed.
SHIPPING_COUNTRY_UNSUPPORTED The shipping country is not supported for physical card creation.