Set Card PIN

Request

curl --request POST \
  --url "$baseUrl/organization/cards/{id}/pin" \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "pin": "1234"
  }'

Field	Type	Required	Description
`pin`	string	Yes	4-digit numeric PIN

Response

{
  "success": true,
  "statusCode": 200,
  "message": "Card PIN set and activated",
  "data": {
    "id": "card_01hw3x7k2r4p5q6m8n9v",
    "status": "active"
  }
}

A card cannot be used for transactions until its PIN is set — this call moves the card's status from inactive to active.

Security note

Collect the PIN through a tightly scoped input on your frontend and send it straight to this endpoint — don't store it, log it, or pass it through any intermediate service that doesn't need it.