Emitir cartão virtual

post

https://api.autra.io/v1/banking/accounts/{accountId}/cards

Cria um cartão virtual via Autra (POST /cards/v1/cards).

Cartão nasce em status=BLOCKED, status_reason=INITIAL_BLOCKED — não transaciona até POST /cards/{id}/activate.

PIN é repassado pra Autra e não persistido do nosso lado.

Idempotência via businessKey (UUID v4) ou header Idempotency-Key.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

accountId

uuid

required

Body Params

Cria um cartão virtual via cartões.

type

string

enum

Defaults to VIRTUAL

VIRTUAL no MVP. PHYSICAL exige address + embossing_setup_id (não suportado nesta Fase).

Allowed:

activeFunction

string

enum

Defaults to CREDIT

Como o cartão se apresenta no checkout. CREDIT é recomendado pra e-commerce/wallets. DEBIT requer senha presencial. Em ambos o dinheiro vem do saldo (PREPAID).

Allowed:

cardProfileId

uuid

Opcional. Override do profile. Default = VISA_49170838 (PREPAID PF).

string

required

length between 4 and 4

^[0-9]{4}$

4 dígitos numéricos. Rejeitado: 0000, 1234, 1111, 2222...9999, sequenciais (1234, 9876), repetidos. Backend NÃO persiste/loga.

cardholderName

string

length ≤ 26

Opcional. Default = full_name do onboarding. Backend normaliza: uppercase, sem acento, max 26 chars (padrão Visa Brasil).

businessKey

string

Idempotência (UUID v4). Se omitido, Autra gera. Mesma key reenviada devolve o mesmo cartão.

metadata

object

Metadados livres, repassados pra Autra.

Headers

Idempotency-Key

string

Responses

403

Token inválido.

404

PERSON_NOT_FOUND — onboarding incompleto.

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Cartão criado (em BLOCKED+INITIAL_BLOCKED — chame /activate)

400PIN_REQUIRED, PIN_INVALID, PIN_WEAK, INVALID_TYPE, INVALID_ACTIVE_FUNCTION, CARDHOLDER_NAME_REQUIRED.