Bind a card to its verification and issuer master keys and return its codes once

POST/cards/{id}/personalization

Verified bank staff with cards:read observe the registry; opening a ceremony, entering a component, personalising a card and unlocking a PIN take the narrow cards:security:write and a step-up in the last five minutes, never cards:write. Approving another member of staff's ceremony adds cards:security:approve. The maker never approves their own ceremony and never enters a component. Both HSM adapters are simulators and are refused in prod. The CVV, CVV2 and iCVV are returned once and never stored.

Path parameters

idstringRequired

Headers

Idempotency-KeystringRequired

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

cvk_key_idstringRequired

imk_key_idstringOptional

pan_sequencestringOptional

Returns

200 OK

bindingobjectRequired

CardSecurityBinding is what personalisation fixed for one card.

8 child attributes

card_idstringRequired

Example card_2tVh8nqLxq4GbDe0K1F6S9zRcWm

cvk_key_idstringRequired

imk_key_idstringOptional

last_atcintegerRequired

pan_sequencestringRequired

personalized_atstring · date-timeRequired

personalized_bystringRequired

updated_atstring · date-timeRequired

cvvstringOptional

cvv2stringOptional

icvvstringOptional

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503