Retrieve card information

View basic card information and sensitive card information.

Retrieve basic card information

On the card details page in the Dashboard, the basic information currently available usually includes:

InformationDescription
Card statusCurrent status, such as active, frozen, system-frozen, terminated, or expired
Issuing marketIssuing market of the card
Settlement currencySettlement currency of the card
Card productCard product information
CardholderAssociated cardholder information
BalanceCurrent available card balance
Card purposePurpose description configured for the card
Created timeCard creation time
Updated timeMost recent card update time

Card status is one of the most important fields for daily management. Current statuses mainly include:

StatusMeaning
ACTIVEThe card can be used normally
FROZENThe card has been frozen by the merchant and can be unfrozen by the merchant
SYSTEM_FROZENThe card is automatically frozen after triggering risk control rules to protect fund security. Merchants cannot unfreeze it themselves. See Freeze and unfreeze cards
TERMINATEDThe card has been terminated and can no longer be used
EXPIREDThe card has expired

Card face information

The top of the card details page displays card face information. Current card face information mainly includes:

InformationDescription
Card numberMasked card number display
Expiry dateCard expiry date
CVVMasked card security code
Card networkCard network, such as Visa or Mastercard

Retrieve sensitive card information

To view complete card information, use “View card information” to view the corresponding sensitive information. Sensitive information includes payment credentials used for actual payments:

InformationDescription
Card number (PAN)Full card number
CVV3-digit security code
Expiry dateCard expiry date in month/year format

Security notes

  • Sensitive information must be retrieved through dedicated APIs
  • Follow PCI DSS security standards when handling sensitive information
  • Do not store sensitive information in plaintext in logs or databases

Viewing methods

Card details can be queried through the Dashboard or API. Actual available fields depend on account permissions and product capabilities.

View through the Dashboard

  1. Log in to the ONERWAY Dashboard
  2. Go to “Card management”
  3. Click a card to view details
  4. View basic information on the card details page
  5. To view sensitive card information, click “View card information”

Query through the API

Use the Get basic card information API and Get sensitive card information API for the respective queries. Sensitive information APIs involve card number, CVV, and other data. Make sure the calling environment is secure.