Home
API Reference

Create a physical card

post
https://sb-api.xpollens.com/api/v3.0/cards/physical

Description

This endpoint allows to create a physical card.

Prerequisites

The prerequisites to call this endpoint are:

  • Client Authentication.


  • Offer partner code.


  • Cardholder existence.


  • Account existence.


  • Cardholder delivery address.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

The input.

Represents the request payload for creating a new physical card, including identifiers for the card, cardholder,
account., offer details, visual code preferences, NFC settings, and delivery information.

string
required
length between 1 and 50

The card's reference attributed by the partner.

string
required
length between 1 and 255

The holder's reference attributed by the partner (also named appUserId).

string
required
length between 1 and 255

The account’s reference attributed by the partner.

string
required
length between 1 and 50

The Partner's offer code provided by Xpollens.

In Demo mode, please use the following offer's code

* To create physical classic cards: 'DemoClassicPhysicalDebitVISA'

  • To create virtual classic cards: 'DemoClassicVirtualDebitVISA'
string | null

The card's visual selected by the partner.

boolean | null

Defines whether the cardholder can set their card's pin.

If false or not specified, the default value specified on the offer will be used.

boolean | null

Defines whether the NFC is activated on the card's chip.

If false or not specified, the default value specified on the offer will be used.

deliveryAddress
object
required

Card delivery address

uuid | null

Description

The reference for the delivery point used to send grouped cards.
To retrieve the full delivery address, please call the endpoint: GET /api/v3.0/delivery-points/{deliveryPointId}

string | null
^(0[1-9]|1[0-2])\/\d{4}$

Override the expiration date of the card. Format: MM/yyyy.
If not provided, the expiration date is computed from the offer settings.

limits
array of objects | null

Optional limits for the card. If not provided, card inherits default limits from the offer.
Each limit specifies a type (Payment, Withdrawal), period (Daily, Weekly, Monthly, Unit), and value.

limits
Headers
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses

Updated 4 months ago

Did this page help you?
Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 4 months ago

Did this page help you?