Card issuing

Create a card

4min

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

Before you begin

Make sure you have:

Register the relevant webhook events

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.

Order a new card

In this tutorial you will learn how to order/create a new debit card. by creating a card for John Smith.

1

Call POST /cardmanagement/v1/cards. For this call, some/all attributes are required. A full list of attributes is found here .

Sample create a card

2

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.

Sample order a card response

3

When the card is generated at the processor, the Cards.Card.created webhook event fires.

Sample Cards.Card.Created event




Sample Cards.Card.Created event

🤔
Have a question?
Our super-smart AI, knowledgeable support team and an awesome community will get you an answer in a flash.
To ask a question or participate in discussions, you'll need to authenticate first.



Updated 30 Sep 2024
Doc contributor
Doc contributor
Did this page help you?