Create cardholders

Create the cardholder associated with a card before creating the card, and complete the required information submission and status checks.

What is a cardholder

A cardholder is the user or responsible party for a card. Before creating a card, merchants usually need to create a cardholder and link the card to that cardholder.

In general:

  • One cardholder can be associated with multiple cards
  • Cardholder information must meet platform and compliance requirements

Why create a cardholder first

In the issuing flow, the cardholder is used to define card ownership and support later management. Creating the cardholder first helps:

  • Clarify card ownership
  • Complete the required information checks
  • Prepare for card creation, lookup, and management

Common information requirements

The required fields may vary depending on product rules and account activation status. Common information includes:

FieldDescription
NameCardholder name, usually matching the submitted information
EmailUsed for contact or receiving related notifications
Mobile numberUsed for contact or verification
Nationality / country or region informationUsed for verification and compliance processing
Billing address / contact addressUsed for cardholder records, billing information matching, or compliance processing

Cardholder status

After a cardholder is created, the following statuses are common:

StatusDescription
ActiveThe cardholder can be used to bind and create new cards
DisabledThe cardholder cannot continue to bind new cards

When a cardholder is disabled, new cards cannot currently be bound to that cardholder. The actual status name and display method depend on the platform page.

Agreements and confirmations

In some scenarios, the cardholder must complete the corresponding agreement confirmation before using the card. For API integrations, the merchant should also ensure that the required confirmation process has been completed in its own system or business flow.

Confirm the following:

  • Cardholder information is accurate and complete
  • The agreement confirmation flow has been completed
  • The status meets the requirements for card binding and card creation

How to create a cardholder

Cardholders can be created through the Dashboard or API. Available methods depend on the account capabilities.

Create through the Dashboard

  1. Sign in to the ONERWAY Dashboard
  2. Go to the cardholder management page
  3. Start the creation flow
  4. Fill in and submit the required information
  5. Wait for the status to update

Create through the API

For API integrations, create the cardholder through the corresponding endpoint and monitor status changes through callbacks or query endpoints.