Manage Cards

Print Physical Cards

Issue Cards

1. [A Highnote Account](https://dashboard.highnote.com/auth/signin?screen_hint=signup)
2. An [API Key](/docs/basics/graphql-api/using-the-highnote-graphql-api#authentication), the [API Explorer](/docs/explorer/default) or the [Dashboard](https://dashboard.highnote.com)
3. A [Payment Card and Financial Account](/docs/guides/cards/issue)

Prerequisites

You have several options when it comes to displaying a payment card in your application.

1. For web-based applications that want to show the full card information, including card number and expiration, you can use the [Card Viewer SDK](/docs/basics/clientside-and-sdks/card-viewer-sdk).
2. For iOS and Android based integrations, you can securely retrieve and display card details from the API with a [Client Token](/docs/basics/clientside-and-sdks/client-tokens).

~~~graphql
query ViewPaymentCard($id: ID!) {
  node(id: $id) {
    ... on PaymentCard {
      id
      bin
      last4
      expirationDate
      restrictedDetails {
        ... on PaymentCardRestrictedDetails {
          number
          cvv
        }
      }
    }
  }
}
~~~

~~~json
{
  "data": {
    "node": {
      "id": "PAYMENT_CARD_ID",
      "bin": "411111",
      "last4": "1111",
      "expirationDate": "2026-01-01T23:59:59Z",
      "restrictedDetails": {
        "number": "4111111111111111",
        "cvv": "222"
      }
    }
  },
  "extensions": {
    "requestId": "REQUEST_ID"
  }
}
~~~

ViewPaymentCard

Display a Card

Balances are held in the ledgers of the financial account a payment card is issued against.

You can query against this financial account and get back a set of ledgers. The types of ledgers returned vary by the product vertical. The available to spend balance is most commonly represented in the `AVAILABLE_CASH` or `AVAILABLE_CREDIT` ledger.



~~~graphql
query FindAccount($id: ID!) {
  node(id: $id) {
    ...on FinancialAccount {
      id
      accountStatus
      name
      ledgers {
        id
        name
        normalBalance
        debitBalance {
          value
          currencyCode
        }
        creditBalance {
          value
          currencyCode
        }
      }
    }
  }
}
~~~

~~~json
{
  "data": {
    "node": {
      "id": "FINANCIAL_ACCOUNT_ID",
      "status": "ACTIVE",
      "name": "John Doe - Account",
      "ledgers": [
        {
          "id": "LEDGER_ID",
          "name": "CASH",
          "normalBalance": "DEBIT",
          "debitBalance": {
            "value": 0,
            "currency": "USD"
          },
          "creditBalance": {
            "value": 0,
            "currency": "USD"
          }
        },
        {
          "id": "LEDGER_ID",
          "name": "ADVANCE_PAYABLE",
          "normalBalance": "CREDIT",
          "debitBalance": {
            "value": 0,
            "currency": "USD"
          },
          "creditBalance": {
            "value": 0,
            "currency": "USD"
          }
        }
      ]
    }
  }
}
~~~

Retrieve Financial Account Balance

Display a Balance

Display Cards & Balances

Issue Your First Card

Test Your Integration

Using Ledgers

Controlling Authorizations with Spend Rules

Order Physical Cards

Managing Financial Accounts

GraphQL API

Search & Filters

Events & Notifications

Clientside & SDKs

Product Verticals

Dashboard

Control Authorizations

Transfer Funds

Handle Transactions

Manage Credit

Onboard Accounts

Compliance

Card Design

Using the Highnote API

Using GraphQL

API Error Handling

Search

API Status & Changes

Using the Dashboard

Team, Roles & Profile

Perform Searches

Manage your Integration

Client Tokens

Card Viewer SDK

Secure Inputs SDK

Notifications

Events

Events Reference

Virtual Cards

Physical Cards

Digital Wallets

API Reference

API Explorer

Basics

Onboard an Account

Request Documents for Application Review

Update an Account

Add Cards to Digital Wallets

Print Cards in Bulk

Handle Account Suspension

Transaction Lifecycle

Simulate Transactions

Simulate Fleet Transactions

Build a Transaction Feed

Deliver Statements

Manage Disputes

Configure Spend Rules

Configure Velocity Controls

Collaborative Authorization

Add Funds to your Balance

Connect External Accounts

Add Funds to an Account

Move Funds Out of Highnote

Payroll Advance

Assign a Credit Line

Simulate Application Denial

Collaborative Underwriting 

Set & Update a Credit Limit

Schedule Repayments

Guides

Consumer Debit

Commercial Debit

Commercial Charge

Secured Commercial Charge

Fleet

AP Automation

Consumer Prepaid

Payroll

Marketing & Collateral

Cards in Marketing

Agreements & Disclosures

Concepts