Issue a card
Last updated: June 4, 2025
You can create physical cards or virtual cards to issue to an individual or a business using the Dashboard or the API. All cards are linked to a card product you configured when setting up your card program.
Information
All cards have a maximum lifetime of three years from creation by default. You can set a set shorter maximum lifetime during your Issuing onboarding.
- You must have completed your Issuing onboarding.
- For physical and tokenized cards, Checkout.com and the card scheme must have approved your card design.
- You must have funded your Issuing balance.
- You must have created a cardholder to issue the card to.
You need the Admin role, or a custom role with the Create and edit cards and cardholders; Simulate transactions user permission.
- Sign in to the Dashboard.
- Go to Issuing > Cards > Create card.
- Select the type of card you want to create.
- In the Cardholder dropdown, select the cardholder you want to issue the card to.
- Optionally, enter a Display name to show on the card, and your Reference to help you identify the card.
- In the Card product dropdown, select the card product you want to link the card to, if your entity has more than one configured.
- Select Create card.
You need the Admin role or a custom role with the View all transactions, cards, cardholders, and card products permission.
You must first retrieve the identifier for the card product you want to link the card to in the Dashboard:
- Sign in to the Dashboard.
- Go to Issuing > Card products.
- Select the required card product.
- In the Card product details page, copy the Card product ID value.
Then, call the Create a card endpoint and always provide the following:
type
field – Set the card type to eitherphysical
orvirtual
.cardholder_id
field – Provide the cardholder's unique identifier returned in the Create a cardholder response.card_product_id
field – Provide the identifier of the card product you want to link the card to, if your entity has more than one configured.
post
https://api.checkout.com/issuing/cards
1{2"type": "physical",3"cardholder_id": "crh_d3ozhf43pcq2xbldn2g45qnb44",4"lifetime": {5"unit": "Months",6"value": 67},8"reference": "Your-card-reference",9"revocation_date": "2027-03-12",10"card_product_id": "pro_7syjig3jq3mezlc3vjrdpfitl4",11"display_name": "John Smith",12"shipping_instructions": {13"shipping_recipient": "John Paul Smith",14"shipping_address": {15"address_line1": "Checkout.com",16"address_line2": "90 Tottenham Court Road",17"city": "London",18"state": "London",19"zip": "W1T 4TJ",20"country": "GB"21}22}23}
1{2"id": "crd_fa6psq242dcd6fdn5gifcq1491",3"display_name": "John Smith",4"last_four": "1234",5"expiry_month": 5,6"expiry_year": 2025,7"billing_currency": "GBP",8"issuing_country": "GB",9"reference": "X-123456-N11",10"created_date": "2019-09-10T10:11:12Z",11"_links": {12"self": {13"href": "https://api.checkout.com/issuing/cards/crd_fa6psq42dcdd6fdn5gifcq1491"14},15"credentials": {16"href": "https://api.checkout.com/issuing/cards/crd_fa6psq42dcdd6fdn5gifcq1491/credentials"17},18"revoke": {19"href": "https://api.checkout.com/issuing/cards/crd_fa6psq42dcdd6fdn5gifcq1491/revoke"20}21}22}
A successful response returns the card id
.
Information
For security purposes, the card's credentials are not returned in the response.
Note
If you receive a card_product_required
response error, you may have more than one card product configured.
You must provide a card_product_id
in your request.
After you've created a card, you can use the API to: