Ativar cartão físico

Todo cartão físico precisa ser ativado através de um código de ativação que é enviado junto do cartão físico, ao portador.

Ao receber o cartão por correspondência, o portador do cartão precisa informar ao parceiro da QI, para que o parceiro realize a ativação do cartão através deste endpoint.

Atenção

Por motivos de segurança, não existe a possibilidade de consulta do código de ativação via API por parte do parceiro.

Este código é enviado, exclusivamente ao portador do cartão, no momento da postagem do cartão físico.

Para realizar testes de integração, esse código é devolvido em ambiente de sandobox ao consultar um cartão.

Request

ENDPOINT

/wallet/WALLET_KEY/card/CARD_KEY/activate

MÉTODO

PATCH

Path params

Campo	Tipo	Descrição	Caracteres
WALLET_KEY *	string	Chave de identificação do carteira.	uuid
CARD_KEY *	string	Chave de identificação do cartão.	uuid

Request Body

{
    "code": "253615"
}

Body params

Campo	Tipo	Descrição	Caracteres
code *	string	Código de ativação do cartão.	6

Response

STATUS

200

Response Body

{
    "card_key": "05fd3654-1f5d-479d-ade5-64239fdf214d",
    "status": "active",
    "account_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "program_key": "6b6ebaac-043b-4390-8d62-e8098ec901e9",
    "type": "virtual",
    "card_name": "ecommerce",
    "printed_name": "Aurora Catarina",
    "brand": "visa",
    "last_four_digits": "5695",
    "created_at": "2023-02-20T19:28:16Z",
    "updated_at": "2023-02-22T19:28:16Z",
    "cvv_rotation_interval_hours": 72
}

Erros

STATUS

4XX

Response Body

{
  "title": "Not Acceptable",
  "description": "Invalid activation code [1254].",
  "translation": "Unable to activate card",
  "code": "CARD000020"
}

Code	Status code	Description
QIT000001	400	Invalid Json schema.
CARD000011	404	It was not possible to fetch the Card for the card_key {card_key}.
CARD000017	406	The activation operation is not valid for the current card status [{card_status}].
CARD000018	400	We're sorry, but the card could not be activate. Please try again later.
CARD000020	406	Invalid activation code [{code}].
CARD000023	406	The card type is invalid for this operation. Only plastic cards are allowed.