Skip to content

Set Card PIN

Request

Set PIN for physical cards (by card_id) before they are activated.

Security
HTTPBearer
Path
account_idstring, (uuid)(Account Id)required
card_idstring, (uuid)(Card Id)required
Headers
x-jiko-idempotencystring, (uuid)(X-Jiko-Idempotency)required

A UUID you generate to identify this request. Reusing a value that was already sent is rejected as a duplicate request.

x-jiko-signaturestring(X-Jiko-Signature)required

Base64-encoded HMAC-SHA256 hash of x-jiko-idempotency + request pathname + body, keyed with your shared secret. See Authentication for the full algorithm and a code sample.

Bodyapplication/jsonrequired
encrypted_pinstring, (password)(Encrypted PIN)write-onlyrequired

4 digit PIN encrypted by set_pin public key

curl -i -X POST \
  'https://your-partner-name.sandbox-api.jikoservices.com/api/v1/jiko-accounts/{account_id}/cards/{card_id}/pin/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'x-jiko-idempotency: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -H 'x-jiko-signature: string' \
  -d '{
    "encrypted_pin": "pa$$word"
  }'

Responses

Successful Response

Bodyapplication/json
successboolean(Success)required
Response
{ "success": true }