Set Card PIN
POST
/api/v1/cardoperations/{cardId}/pin/set
{cardId}/iframe/pin/set instead, where the customer enters the PIN inside a provider-hosted iframe.| Field | Type | Description | Constraints |
|---|---|---|---|
pin | string | The new PIN to set | Min: 4 · Max: 6 |
| Field | Type | Description |
|---|---|---|
cardId | string (uuid) | Card identifier |
customerId | string (uuid) | Customer identifier |
productId | string(uuid) | Product identifier |
cardType | string | Type of card |
cardNumber | string | null |
action | string | Action performed on the card |
status | string | Status of the PIN operation |
message | string | Message describing the operation result |
taskId | string (uuid) | Task identifier |
performedAt | string (date-time) | Timestamp when the action was performed |
Request
Path Params
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/cardoperations/6f1c9a2e-4b3d-4e7a-9c5f-1a2b3c4d5e6f/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 '{
"pin": "4821"
}'Response Response Example
200 - Success
{
"data": {
"cardId": "8b1f3d52-9c4e-4a77-b0d2-6e3f1a9c5d41",
"customerId": "2c7a4f10-88b3-4e91-9d6a-1f5c2b7e3a04",
"productId": "2c7a4f10-88b3-4e01-9d6a-1f5c2b7e3a04",
"cardType": "Physical",
"cardNumber": null,
"action": "set_pin",
"status": "PIN Set",
"message": "Card PIN set successfully.",
"taskId": "9d4c1f60-2a83-4b57-a0e9-6c73f815d224",
"performedAt": "2026-09-01T09:14:22.4310000Z"
}
}Modified at 2026-09-01 07:06:45