Create a card
In this tutorial, you'll learn how to:
✅ Create and order a new card
If you are new to card issuing we recommend you read the card issuing management documentation before starting this tutorial.
The tutorial assumes you have a knowledge of APIs and how they work. For more information on sending API calls, see the API overview page.
The tutorial uses these API endpoints
API | Description |
|---|---|
Requests creation of a new debit card |
The tutorial uses these webhooks.
Webhook | Description |
|---|---|
Cards.Card.Created | Debit card created |
Make sure you have:
- Cardholder's account number
- Customer ID (you get this when you create a customer)
To receive the webhook events for this tutorial both partner accounts need to register each specific webhook event type. Once you are registered, the event objects are sent to the registered URLs.
The event object contains a list of resource identifiers used to download details on each event.
In this tutorial you will learn how to order/create a new debit card. by creating a card for John Smith.
Call POST /cardmanagement/v1/cards. For this call, some/all attributes are required. A full list of attributes is found here .
A successful API call returns a JSON response with the details of the new card. The card status will be unactivated until you activate the card. The id is the card ID, in this example 8709163d-140c-4d95-a111-afa8009e9cd1, which you will need to Activate a card.
When the card is generated at the processor, the Cards.Card.created webhook event fires.
Sample Cards.Card.Created event
