Create Cardholder

Create a cardholder. A cardholder is a prerequisite for issuing a card.

The cardholder is registered with the card network synchronously. If the network rejects the request, nothing is persisted on the PIK side and the rejection reason is returned in message.

Field format rules (names, email, phone number, lengths; see the request schema) are checked by PIK before anything is submitted. A violation returns 400 with the field named in message.

Phone number rules enforced by the card network:

phoneCountryCode is the ISO 3166-1 alpha-2 code of the country the phone number belongs to, not the cardholder's nationality. PIK derives the dialling code from it; a country PIK does not support returns 400 phoneCountryCode is not supported: XX. The number length is validated against that country's numbering plan.

phoneNumber must exclude the dialling prefix and any leading zero, and must be unique across your account.

A card can only be issued once status is ACTIVE. status follows the KYC result: kycStatus = SUCCESS gives ACTIVE, FAILED gives KYC_FAILED, and PENDING / INCOMPLETE give KYC_PENDING.

Note: PIK submits an internally generated email address to the card network, so notifications the network sends to the cardholder will not reach the address you supply here. Network email notifications are not forwarded in this release.

curl --location '/api/v1/issuing/cardholder/create' \ --header 'Content-Type: application/json' \ --data-raw '{ "firstName": "Wei", "lastName": "Tan", "email": "wei.tan@example.com", "phoneCountryCode": "SG", "phoneNumber": "91234567", "externalId": "user-88213" }'

{ "code": 200, "message": "success", "data": { "cardholderNo": "string", "status": "string", "kycStatus": "string", "firstName": "string", "lastName": "string", "email": "string", "phoneCountryCode": "string", "phoneNumber": "string", "cardCount": 0, "externalId": "string", "remark": "string", "createTimeUtc": "2019-08-24T14:15:22.123Z" } }

Create Cardholder

Request

Responses