Order new card

Order a new card for a specific customer

Generates a card for the customer, starting the delivery and manufacturing process.

At this point, the card is not linked to the customer's account,
and the only customized part is the name that will be printed on the card.

This endpoint is intended for Business-to-Consumer (B2C) operations.

Important considerations:

  • new_pin must be exactly 4 digits.
  • balance_id is required and determines which balance the card will be linked to.
  • delivery_location is required for physical cards when delivery is enabled—all mandatory fields must be provided.
  • front_name is optional and will be printed on the card.
  • campaign_id is optional—a default campaign will be used if not provided.
  • For physical cards, the delivery process starts immediately.
  • The card is not usable until activated.
  • The endpoint supports both physical and virtual card types.
  • All operations are atomic—if any step fails, the entire operation is rolled back.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
int64
required

The primary key of the balance to which the card order will be tied

string
length ≤ 100

The id for the card's campaign.
A default campaign will be set if this field is not present.

int64

Unused field, included in the documentation for technical reasons only. Safe to ignore

delivery_location
object
string

Name that will be printed in the requested card

string

Url of the document that's sent to the manufacturer. Required when delivery is disabled.

string
required

The personal identification number (PIN) for the new card.
Must be 4 digits in length

int64

Location where the card is picked up by the delivery service. Valid types: 1 - Manufacturer's location

Headers
string
required

OAuth token belonging to the e-commerce

string
required

OAuth token belonging to the customer

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json