Home
API Reference

Create a virtual card

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

Description

This endpoint allows to create a virtual card.

Prerequisites

The prerequisites to call this endpoint are:

  • Client Authentication.


  • Offer partner code.


  • Cardholder existence.


  • Account existence.

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 virtual card, including identifiers for the card, cardholder,
account., offer details, visual code preference.

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
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 card's reference attributed by the partner.

string | null

The card's visual selected by the partner.

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?