Criar cartão virtual

Request

ENDPOINT

/prepaid/card

MÉTODO

POST

Request Body

{
    "account_key": "5294ed8d-08fc-4397-b15f-6d9aa07b0041",
    "program_key":"7d405c31-ec9a-46c1-8ac8-54bab209bf41",
    "type": "virtual",
    "card_name": "ecommerce",
    "printed_name": "Aurora Catarina",
    "cvv_rotation_interval_hours": 72
}

Body params

Campo	Tipo	Descrição	Caracteres
account_key *	string	Chave de identificação da conta de pagamento na QI Tech.	uuid
program_key *	string	Chave de identificação do programa para emitir um cartão.	uuid
type *	string	Tipo do cartão a ser emitido (VIRTUAL).	Enumeradores
card_name *	string	Alias do cartão, como esse cartão será identificado.	uuid
printed_name *	string	Nome que será impresso no cartão (não será permitido o uso de números e caracteres especiais).	uuid
cvv_rotation_interval_hours *	int	Intervalo em horas para atualizar o número CVV.	Number

Enumeradores card_type

Enumerador	Tradução
plastic	Cartão físico
virtual	Cartão virtual

Response

STATUS

201

Response Body

{
    "card_key": "05fd3654-1f5d-479d-ade5-64239fdf214d",
	"created_at": "2023-02-20T19:28:16Z",
    "status":"created"
}

Erros

STATUS

4XX

Response Body

{
  "title": "Bad Request",
  "description": "The type of person is invalid for this program, please try another.",
  "translation": "Invalid Person",
  "code": "CARD000007"
}

Code	Status code	Descrição
QIT000001	400	Invalid Json schema.
CARD000005	404	It was not possible to fetch the Program for the program_key {program_key}.
CARD000006	404	It was not possible to fetch the Account for the account_key {account_key}.
CARD000007	400	The type of person is invalid for this program, please try another.
CARD000008	400	The Card Holder with the status {status} is invalid for the operation.
CARD000009	400	We're sorry, but the card could not be generated. Please try again later.
CARD000010	404	It was not possible to fetch the Person for the person_key {owner_person_key}.
CARD000032	403	Create virtual card is not allowed for program_key {program_key}.

Webhook

WEBHOOK_TYPE

baas.prepaid_card.card

Webhook Body

{
    "webhook_type": "baas.prepaid_card.card",
    "event_datetime": "2023-07-24T12:00:00.000Z",
    "data": {
        "card_key": "9bd93e97-bb6d-410f-8981-06b2765f12a1",
        "account_key": "595e08f0-da4e-40f7-8db4-f9a25c829818",
        "program_key": "bf74df61-557a-45cb-914f-41e127a6e18c",
        "status": "created",
        "type": "virtual"
    }
}