Create cards

Select a card product, link a cardholder, and create a virtual card.

Before creating a card

Before creating a card, usually confirm that:

  • A card product has been selected
  • The merchant account has enough available balance
  • The corresponding cardholder has been created and its status meets the card creation requirements

Card creation flow

Card creation usually includes selecting a card product, linking a cardholder, setting card information, and submitting the creation request.

1. Select a card product

Select a card product based on the business scenario, such as a U.S. product or an international product, and the corresponding card network.

Select the appropriate cardholder from existing cardholders and link the card to that cardholder.

3. Set card information

Current card creation mainly involves the following information:

ItemDescription
CardholderThe user associated with the card
Initial amountThe initial amount set when creating the card

The actual fields and display method depend on Dashboard or API capabilities.

4. Submit the request

After confirming that the information is correct, submit the card creation request. After the card is created successfully, the system generates the virtual card and sets it to a usable state.

After a card is created

After card creation, merchants can usually:

  • View the card status and basic information
  • Add balance to the card
  • Freeze or unfreeze the card
  • View card-related transactions

Common card statuses

After a card is created, it usually has one of the following statuses:

StatusDescription
ACTIVEThe card is active and can be used normally
FROZENThe card is frozen and temporarily unavailable, but incoming refunds are not affected
SYSTEM_FROZENThe card is frozen by the system for risk control reasons and cannot be manually unfrozen
TERMINATEDThe card has been terminated and can no longer be used
EXPIREDThe card has expired

In most cases, a card enters the ACTIVE status after it is created successfully. Freezing, unfreezing, system risk-control freezing, termination, and expiration may trigger later status changes.

Creation methods

Cards 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 card management page
  3. Start the card creation flow
  4. Select a card product and link a cardholder
  5. Fill in the required information and submit

Create through the API

For API integrations, create the card through the corresponding endpoint and query the card status and related information afterward.