Guides

Create Cardholders

To issue a card to an user, you must first create a cardholder. Once a card is linked to a cardholder, the cardholder cannot be changed. However, you can update the cardholder's details later, such as phone number or business email address, as needed.

Suggest Edits

Create Cardholder in the Dashboard

  1. Sign in to the Dashboard.
  2. Navigate to the Cards > Cardholders screen.
  3. Click Create Cardholder in the top-right corner.
  4. Fill out the cardholder's detailed information in the fields presented.
  5. Click Confirm.

Create Cardholder Using the API

Request example

curl --request POST \
     --url https://api.sandbox.uqpay.tech/api/v1/issuing/cardholders \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-auth-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtYXN0ZXJfaWQiOiIwIiwiY3VzdG9tZXJfaWQiOiJjZWRjYjE0MS0xM2IwLTRlMzItOTlkZC00MzQ1NWI1M2Q3MzciLCJhY2NvdW50X2lkIjoiY2VkY2IxNDEtMTNiMC00ZTMyLTk5ZGQtNDM0NTViNTNkNzM3IiwiYXBpX3ZlcnNpb24iOiJWMS4wIiwiY2xpZW50X2lkIjoialB5a1BlR1NNMWtSMGx0YmV5VGU3TiIsInVzZXJfaWQiOiJqUHlrUGVHU00xa1IwbHRiZXlUZTdOIiwiZW1haWwiOiIiLCJzY29wZSI6IiIsInVzZXJfbmFtZSI6IlRlc3QiLCJkaXJlY3RfaWQiOiIwIiwib25fYmVoYWxmX2lkIjoiIiwib25fYmVoYWxmX25hbWUiOiIiLCJidXNfdHlwZSI6MCwiaXAiOiI0My4xOTguMTUyLjc0IiwiZXhwIjoxNzM1ODk3MTA3LCJpc3MiOiJ1cXBheSJ9.V5nnals8t95yOGMqUe4wHS9EUyew_2k1AdZYTGXzNG8' \
     --header 'x-idempotency-key: 18828f72-f4de-4f9c-bb8e-ec7d1c4f32be' \
     --data '
{
  "email": "[email protected]",
  "first_name": "Emily",
  "last_name": "John",
  "date_of_birth": "1980-01-01",
  "country_code": "SG",
  "phone_number": "86687306",
  "delivery_address": {
    "city": "Singapore",
    "country": "SG",
    "line1": "10 Bayfront Avenue, Marina Bay Sands",
    "postal_code": "018956"
  }
}
'

Response example

{
  "cardholder_id": "1911292b-67e4-4ee9-87d7-a8a6c7cb1af7",
  "cardholder_status": "SUCCESS"
}

Updated 13 days ago