Create Cardholder

POST

/api/v1/issuing/cardholder/create

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.

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. 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.

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.

Request

Body Params application/json

Examples

Responses

🟢200

application/json

Cardholder created successfully

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠422VendorRejected

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

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"
}'

Response Example

200 - Example 1

{
    "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"
    }
}

Modified at 2026-08-11 10:11:22

List Card Products

List Cardholders