Set / Reset Card PIN
POST
{{baseUrl}}/api/v1/cards/{cardId}/pin/set
📋 Request Body Fields
| Field | Type | Description | Constraints |
|---|---|---|---|
pin | string | New PIN — must be 4–6 digits. Example: 1234 | Min length: 4 · Max length: 6 |
📤 Response Fields
| Field | Type | Description | Notes |
|---|---|---|---|
card_id | string (uuid) | - | - |
customer_id | string (uuid) | - | - |
product_id | string | - | nullable |
card_type | string | - | nullable |
action | string | The operation performed: activate, freeze, unfreeze, cancel, replace, set_pin. Example: activate | - |
status | string | New card status after the operation. Example: active | - |
message | string | - | nullable |
task_id | string | Async task ID for operations processed in the background. | nullable |
performed_at | string (date-time) | - | - |
Request
Path Params
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST '{{baseUrl}}/api/v1/cards/a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11/pin/set' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;' \
--header 'Content-Type: application/json' \
--data-raw '{
"pin": "1234"
}'Response Response Example
200 - Example 1
{}Modified at 2026-02-18 13:24:21