Manage Cards

Issue Preprinted Physical Cards

Issue Cards

- [A Highnote Account](https://dashboard.highnote.com/auth/signin?screen_hint=signup)
- 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)
- A [Payment Card and Financial Account](/docs/guides/cards/issue)

Prerequisites

You have several options for displaying a payment card in your application.

- 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).
- 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).

Use the following query to View a Payment Card: 

~~~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, for example, Consumer Debit vs. Commercial Charge. The available-to-spend balance is most commonly represented in the `AVAILABLE_CASH` or `AVAILABLE_CREDIT` ledger.

Use the following query to find a Financial Account and display a balance: 



~~~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 and Balances

Issue Your First Card

Test Your Integration

Using Ledgers

Controlling Authorizations with Spend Rules

Order Physical Cards

Managing Financial Accounts

Highnote API

Search & Filters

Events and Notifications

Client Tokens and SDKs

Quick Start Templates

Dashboard

Control Authorizations

Transfer Funds

Handle Transactions

Manage Credit

Onboard Accounts

Compliance

Card Design

Get Started

Test the API

Generate Reports

Accept Payments

Simulate Payments

Offer Rewards

Highnote Overview

Intro to GraphQL

Using the Highnote API

Rotating API Keys

API Rate Limiting

Request Complexity

API Error Handling

Search

API Status and Changes

Using the Dashboard

Notifications

Events

Events Reference

Launch Checklist

Basics

Issuing Overview

Virtual Cards

Physical Cards

Digital Wallets

Design Your Card Experience

Marketing and Collateral

Cards in Marketing

Co-Brands

Onboard an Account

Request Documents for Application Review

Onboard Authorized Users

Update Account Information

Close an Account

Manage Card Profiles

Print Physical Cards

Add Cards to Digital Wallets

Print Cards in Bulk

Transaction Lifecycle

Simulate Transactions

Simulate Fleet Transactions

Build a Transaction Feed

Deliver Statements

Fees

Chargebacks and Disputes

Configure Spend Rules

Configure Velocity Controls

Collaborative Authorization

Add Funds to your Balance

Connect External Accounts

Add Funds to an Account

Transfer between Financial Accounts

Move Funds Out of Highnote

On-demand Funding

Payroll Advance

Create Credit Plans

Find Variable Interest Rates

Assign a Credit Line

Simulate Application Denial

Collaborative Application Decisioning

Create Secured Deposit Offer

Set and Update a Credit Limit

Schedule Repayments

Handling Account Delinquency

Simulate Delinquency

Create Reward Earn Rule

Configure Reward Redemption

Redeem Rewards

Adjust and Find Rewards

Using Reports

Card Interchange Activity Report

Card Transaction Activity Report

Ledger Entry Report

Fleet Enhanced Data Summary Report

Summary Metrics

Consumer Credit

Commercial Charge

Consumer Charge

Secured Commercial Charge

Fleet

AP Automation

Consumer Prepaid

Commercial Prepaid

Payroll

Issuing

Client Tokens

Card Viewer SDK

Secure Inputs SDK

Document Upload SDK

Support

SDKs

Acquiring Overview

Online Payments

Recurring Payments

Simulate Authorizations and Declines

Display Transactions

Acquiring