Activate physical card

Every physical card needs to be activated through an activation code that is sent along with the physical card to the cardholder.

When receiving the card by mail, the cardholder needs to inform the QI partner, so that the partner can activate the card through this endpoint.

Warning

For security reasons, there is no possibility for the partner to query the activation code via API.

This code is sent exclusively to the cardholder at the time of posting the physical card.

To perform integration tests, this code is returned in sandbox environment when querying a card.

Request

ENDPOINT

/wallet/WALLET_KEY/card/CARD_KEY/activate

METHOD

PATCH

Path params

Field	Type	Description	Characters
WALLET_KEY *	string	Wallet identification key.	uuid
CARD_KEY *	string	Card identification key.	uuid

Request Body

{
    "code": "253615"
}

Body params

Field	Type	Description	Characters
code *	string	Card activation code.	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
}

Errors

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.