Activate Card

POST

/baseurl/api/v1/cards/{cardId}/activate

Based on the Product API response, retrieve the WaitingToActivate object from the metadata field. Use the values from the WaitingToActivate JSON to populate the corresponding fields in the request.
Optional Fields

Field	Type	Description
`activationCode`	`string`	Activation code (physical cards only). Nullable.
`cardLastFourDigits`	`string`	Last four digits of the card number. Nullable.
`pin`	`string`	PIN to set during activation (required for products that mandate PIN setup at activation time). Nullable.
`expiryDate`	`string`	Card expiry in `MM/YY` format. Nullable.

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Card activated successfully.

Bodyapplication/json

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

cURL

Activate virtual card (no code needed)Activate physical card with code

curl --location '/baseurl/api/v1/cards//activate' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;' \
--header 'Content-Type: application/json' \
--data '{
    "ActivationCode": "9958986",
    "Pin": "454454"
}'

Response Example

{
    "cardId": "ef0c9071-f1d5-4782-996c-db9b45c47a29",
    "customerId": "49cf2793-9379-4d1b-9904-5b77aaa5693c",
    "productId": "999a47bf-5c73-4a93-9827-0182f075355d",
    "cardType": "Virtual",
    "action": "activate",
    "status": "success",
    "message": "Card activated successfully",
    "taskId": "task_123456789"
}

Modified at 2026-07-03 12:52:40

Get Sensitive Card Details

Freeze Card