After you create an account holder and a balance account, you can start issuing virtual or physical cards. The cards have to be associated with a Visa or Mastercard pre-approved use case, called a scheme program. By default, Adyen handles the scheme program for you in the background.
PCI compliance
The scope for PCI compliance depends on your use case, that is, the type of cards you'll issue and how the cards will be used. To know whether PCI compliance requirements apply to your use case, reach out to your Adyen contact.
Visual design for physical cards
Before you can create physical cards in the live environment, you must have a design for the card itself and the mailer it is sent in. Each card design must be approved by Visa or Mastercard.
Your Adyen contact will help you complete and specify the designs.
Create a card
To issue a card, create a paymentInstrument resource. In the request, specify whether the card is:
- Virtual: A card that has no physical form, and can only be used online. You receive the card details in the API response.
- Physical: A card that is printed and shipped to the user. You do not receive the card details in the API response. Sending a request to create a physical card also starts an order to manufacture the card.
When creating a physical card, you must include additional information, such as the card manufacturing profile and the delivery details.
To create a physical card, make a POST /paymentInstruments request specifying:
| Parameter | Required | Description |
|---|---|---|
| type |  |
The payment instrument type, set to card. |
| balanceAccountId | |
The balance account ID that should be associated with the card. You can also update the balance account associated with a card at a later time as long as the card status is inactive. |
| card.formFactor | |
The form factor of the card, set to physical. |
| card.cardholderName | |
The name of the cardholder. |
| card.brand | |
The card brand. |
| card.brandVariant | |
The brand variant of the card. |
| card.configuration | |
Object that contains the settings for the physical card, including design and the configurationProfileId. |
| status | By default, cards are created with an active status. We recommended that you create physical cards with inactive status to keep them secure until they are delivered to the cardholder. |
In your request, you can also include optional parameters such as a human-readable description to help your staff differentiate between multiple cards under one balance account.
Here is how you would create a physical card linked to a balance account with id BA1234123412341234. In this example, we create a card with inactive status.
curl https://balanceplatform-api-test.adyen.com/bcl/v2/paymentInstruments \
-H "x-API-key: YOUR_X-API-KEY" \
-H "content-type: application/json" \
-d '{
"type": "card",
"issuingCountryCode": "NL",
"balanceAccountId": "BA1234123412341234",
"status": "inactive",
"card": {
"formFactor": "physical",
"brand": "mc",
"brandVariant": "mcdebit",
"cardholderName": "Sam Hopper",
"deliveryContact": {
"address": {
"city": "Amsterdam",
"country": "NL",
"stateOrProvince": "NH",
"line1": "274 Brannan Street, Suite 600",
"line2": "50",
"postalCode": "1020CD"
},
"name": {
"firstName": "Sam",
"lastName": "Hopper"
}
},
"configuration": {
"configurationProfileId": "YOUR_CONFIGURATION_PROFILE_ID"
},
"expiry": {
"month": 8,
"year": 2024
}
},
"description": "{hint:Your human-readable description for the card.}S. Hopper - Main card{/hint}"
}'The response returns the paymentInstrument resource, identified by its unique id.
{
"balanceAccountId": "BA1234123412341234",
"description": "S.Hopper - Main card",
"issuingCountryCode": "NL",
"status": "inactive",
"type": "card",
"card": {
"brand": "mc",
"brandVariant": "mcdebit",
"cardholderName": "Sam Hopper",
"configuration": {
"configurationProfileId": "YOUR_CONFIGURATION_PROFILE_ID"
},
"deliveryContact": {
"address": {
"city": "Amsterdam",
"country": "NL",
"stateOrProvince": "NH",
"line1": "274 Brannan Street, Suite 600",
"line2": "50",
"postalCode": "1020CD"
},
"name": {
"firstName": "Sam",
"lastName": "Hopper"
}
},
"formFactor": "physical",
"bin":"555544",
"expiration":{
"month":"08",
"year":"2024"
},
"lastFour":"1589"
},
"id": "PI3227C223222B5BPCMFXD2XG"
}In the test environment, you can create physical cards but you will not receive them.
Multiple cardholders under one balance account
This use case is only allowed in specific circumstances. Check with your Adyen contact if this is a functionality you can use.
Some business cases might require having multiple cardholders under one balance account, for example:
- Creating named cards for multiple employees in one company.
- Creating additional cards for a spouse or children.
Only the main account holder must go through the verification process. After the verification is complete, you can start creating cards for additional cardholders by making another POST /paymentInstruments request.
Here is how you would create another virtual card linked to the same balance account BA1234123412341234 for a different cardholder:
{
"type": "card",
"description": "{hint:Your human-readable description for this card}Supplementary card{/hint}",
"balanceAccountId": "BA1234123412341234",
"issuingCountryCode": "NL",
"card": {
"cardholderName": "Jean Hopper",
"brand": "{hint:Card scheme: mc or visa}mc{/hint}",
"brandVariant": "mcdebit",
"formFactor": "virtual"
}
}Physical cards in live environment
Before you can create live physical cards, you must have a design for the card itself and the mailer.
After you create a card, it is personalized, printed, and shipped with the information that you provided. If you need to stop a card from being personalized, update the status before it is sent to the manufacturer. Reach out to your Adyen contact to know the schedule for your balance platform.