Home / Guides/ Issue Cards

Manage Cards

Change a PIN


A PIN must be set on card creation, and you may allow your account holders to change their PIN once their card is activated.

For web-based integrations, Highnote recommends you change a PIN with the Secure Inputs SDK.

For iOS and Android based integrations, you can securely change a PIN from the API with a Client Token.

Display Account & Routing Number


Financial Accounts with the DIRECT_DEPOSIT feature have an associated account and routing number to be used for funds movements originated outside of Highnote.

To display the account and routing number, you can fetch them from the API by generating a Client Token and using that token to view the restricted details.

Lock a Card


Once a card is in use, you can provide an interface for your account holders to "lock" their payment card.

You can connect the mutation SuspendPaymentCard to a toggle element.

Unlock a Card

You can also provide an interface for your account holders to "unlock" their payment card.

You can connect the ActivatePaymentCard mutation to a toggle element.

Reissue a Card


You might need to order a Physical Card with a different expiration date than your existing Virtual Card. You might suspend, terminate and reissue, or replace a card if it is lost, damaged, or stolen. This guide will provide you with an overview of how to manage these scenarios by reissuing a card.

Reissue allows you to create a new card with the same card number or a different card number for the following use cases:

Use CaseDescription
Your customer already has a Virtual Card and would like to now order a Physical Card.You do not want to ship an active Physical Card, but also don’t want to deactivate the Virtual Card while the Physical Card is shipping. To achieve this, you will reissue the card, with the same card number but a different expiration date and CVV.
The card is about to expire.You want to issue a new card, with the same card number but a different expiration date, later in the future.
The card was lost or stolen.You want to issue a new card, but with a different card number and expiration date.


  1. Call reissuePaymentCard (see example below) to create a new Payment Card. The new Payment Card will be attached to the same Financial Account as the original Payment Card. You may choose to copy the card number and/or PIN from the original Payment Card.
  2. If copyNumber is true, the new Payment Card will have the same card number as the original Payment Card. You may then also choose to set copyPin to true. If you choose to update the card number, you will not be able to copy the PIN. Note, in this case, the expiration date cannot be in the same month/year as the original Payment Card. Additionally, the original Payment Card cannot be in the CLOSED state.
  3. While the Physical Card is being printed and shipped to the account holder it is not active, as activateOnCreate is set to false. Note that even if it has the same card number, it will have a different expiration date and CVV. The Virtual Card remains active.
  4. When the Physical Card is delivered to the account holder, you may want to activate it. You can only maintain one active reissued payment card at a time. As such, when you activate a reissued card, the old card will immediately be deactivated and no longer accept authorizations.

Close a Card


Closing a Payment Card is permanent and impacts both the Virtual and Physical form factors.

Map ATM Locations

A maximum of 50 locations will be returned per request.

If you are offering Physical Payment Cards with cash withdrawal capabilities, you may want to provide your account holders with the ability to locate ATMs that do not have surcharges.

You can allow your customer to set a PIN for their card. This will be required if you want customers to be able to access ATMs and/or receive cashback at checkout.

Search by radius

Use a radius search when searching around a specific place (address, postal code, landmark, etc.) and you have the locations' map coordinates latitude and longitude. Set distance to the radius of the search circle. The distance is expected to be in miles unless overridden.

Filter ATM Search Results

Filters allow you to refine your search by including or excluding certain ATM features.

By default, the ATM features included are:


Inclusive ATM Filters

When using the include parameter, the list will be filtered to only the included values of available ATM features.

In this example, since the includes field was provided with the value of OPEN_24_HOURS, the results from the API will return only the matching locations.

ATM Filter using includes
  "includes": ["OPEN_24_HOURS"]

Provide Feedback

Was this content helpful?