Create card

POST 
/card/v1/cards

Creates a new virtual card linked to a specified BVNK wallet. The card is issued in a CREATED state and transitions to ACTIVE once provisioning is complete.

You must specify the ledger configuration to determine which wallet funds the card. Three wallet types are supported:

• BVNK_ACCOUNT_WALLET: linked to a specific account. Only one active card is allowed per customer.
• BVNK_EPC_WALLET: tied to a customer reference. Only one active card is allowed per customer with this wallet type.
• BVNK_EMBEDDED_COLLATERAL_WALLET: uses a merchant funding source for transaction authorizations. Multiple active cards allowed.

The customer must pass eligibility requirements before a card can be issued. Use the Check eligibility status endpoint to verify eligibility.

Request

Responses

• 201
• 202
• 400

Card created successfully. The card is in CREATED state and will transition to ACTIVE once provisioning is complete.