Skip to main content
POST
Add a Card

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

FlowPassword
Token URL
/v1/platform/auth/token

Body

application/json

Add a card for one of the platform's users. Sandbox test numbers only.

user_id
string<uuid>
required

The user the card belongs to.

card_number
string
required

Any card number, 12 to 19 digits (spaces and dashes are ignored). In sandbox every card reads as a Visa and its transfers settle, except 4000000000000002, whose transfers are declined. The number is never stored.

Required string length: 12 - 23
Example:

"4111111111111111"

exp_month
integer
required

Expiry month (1-12).

Required range: 1 <= x <= 12
Example:

12

exp_year
integer
required

Expiry year, four digits.

Required range: 2000 <= x <= 2100
Example:

2030

name_on_card
string | null

Required. The cardholder's name as printed on the card, up to 120 characters. Shown beside the user's KYC name when Finogate reviews a transfer to the card.

Example:

"Jane A Doe"

cvv
string | null

Required. The card's security code (CVV / CVC), 3 or 4 digits. Used once to verify the card and never stored. In sandbox 000 fails the check (card_cvv_mismatch) and the card is not added.

Example:

"123"

Response

Successful Response

status_code
integer
required

HTTP status code for the response.

data
SandboxCardRead · object
required

Payload or error details.

query_generated_time
integer
required

UTC timestamp (milliseconds since epoch) when response was generated.