Activate Card

Activates (binds) a physical card to the customer's account. Which inputs are mandatory depends on product configuration: some products require the printed activationCode, some require verification (last 4 digits + expiry), and some require a pin to be set at activation time.

Prerequisites

The card must currently be in waiting_to_activate status.

Status values

Status	Meaning
`waiting_to_activate`	Card issued but not yet usable
`active`	Card is activated and usable

Optional Fields

Field	Type	Description	Constraints
`verification.last4`	`string`	Last four digits of the card number	Nullable
`verification.expiryDate`	`string`	Card expiry, `MM/YY`	Nullable
`activationCode`	`string`	Activation code printed on the card mailer/envelope	Max: 64 · Nullable
`pin`	`string`	PIN to set during activation, for products that require it	Min: 4 · Max: 6 · Nullable

📤 Response Fields

Field	Type	Description
`cardId`	`string (uuid)`	Card identifier
`customerId`	`string (uuid)`	Customer identifier
`productId`	`string (uuid)`	Product identifier
`cardType`	`string`	Type of card (e.g. Physical)
`cardNumber`	`string`	Card number
`action`	`string`	Action performed on the card
`status`	`string`	New card status, e.g. `Active`
`taskId`	`string`	Identifier for the activation task
`message`	`string`	Result message for the activation action

curl --location '/api/v1/cardoperations/6f1c9a2e-4b3d-4e7a-9c5f-1a2b3c4d5e6f/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": "393842", "pin": "776750" }'

{ "cardId": "8f3c2a1e-6b74-4d91-9c52-1a7e8b5d3f20", "customerId": "5a2d7c91-3e46-4b82-a1f5-9d8c6e2b4a10", "productId": "2b7f4e61-9a35-48c2-bd17-6e5a3f8c9120", "cardType": "Physical", "cardNumber": null, "action": "Activate", "status": "Active", "taskId": "c9e4a721-5f83-4d62-8b19-2a6f7c1d9e31", "message": "Activation code resent successfully." }

Request

Responses