Print Physical Cards

1. A Highnote Account
2. An API Key, the API Explorer or the Dashboard
3. A Virtual Card

When a Payment Card has been issued, by default, a Virtual Card is created. You can order Physical Cards for eligible, multi-use Card Products.

Once you've created a Physical Card order, Highnote will track and report the status of your order and related shipments.

In the Test Environment, you can test your integration by running through all possible shipment scenarios, including successful and unsuccessful orders.

Individual Physical Card orders allow you to request a single Physical Card. Note the following about Individual Physical Card orders:

• Packaged with a card carrier
• Shipped to a single location
• Not connected to other orders at any time in the Physical Card order lifecycle

Individual Physical Card orders are the most common order type across Card Products. For example, when issuing a card to a single Account Holder for a Consumer Debit product, you will use this order type.

Group Physical Card orders allow you to request several Physical Cards at once. Note the following about Group Physical Card orders:

• Packaged individually with a card carrier
• Shipping as a group in a single shipment to one location

Group Physical Card orders are essentially a set of individual card orders that are packaged into a single shipment during the last step of the Physical Card order lifecycle.

Group orders are typically utilized for prepaid Card Products, but may also work well for products such as Fleet cards.

Card personalization is dynamic information printed on a physical card that is unique to the cardholder.

• Line 1 is required and used for the cardholder's name. Examples of cardholders include account holders and authorized users.
• Line 2 is optional and can be used for any additional information. For example, a business account holder may use line 2 for the business name.

When designing a physical card, card personalization information can be added to the front or back.

Physical Card orders follow a standard lifecycle, beginning with an order for a Payment Card and ending with a shipment received by the Account Holder.

Order Status

Highnote sends Physical Card fulfillment requests to the printer several times a day. You can either select a custom date in the future for when you want your order to be shipped or select SHIPPED_IMMEDIATELY. When you request a card to be SHIPPED IMMEDIATELY, the order will be fulfilled within 72 hours and shipped via the courier of your choice.

You can also request to ship at a future date, but note that it may take up to 72 hours after the requested date to ship the order.

Tracking numbers are unavailable for cards shipped via USPS Ground.

You can choose various shipping methods to send Physical Cards to Account Holders. Shipping cost is based on the price outlined in your Highnote Master Services Agreement. You can also require a signature on delivery when creating your Physical Card order.

The following table outlines the available couriers, shipping options, expected shipping times, and which card types support each option:

Courier	Shipment Option	Expected Time	On-demand Card	Premium Card
USPS	Ground	Two to eight business days
	Priority	One to three business days
	Express	Next business day to two days		✖️
UPS	Ground	One to five business days		✖️
	Second Day	Two business days		✖️
	Next Day	Next business day		✖️
FedEx	One Rate	Two to three business days	✖️
	Standard Overnight	Next day by 6 PM	✖️

Your return address is configured by the Highnote team when your Card Product is setup. To view or update your return address, send a request to support@highnote.com.

Orders that cannot be delivered are returned to the return address on file with Highnote.

You may only submit one order for a given payment card. If the order is canceled or fails, you may try again for the same card. However, if an order is successful and you need another physical card, you will need to issue a new payment card.

Once you have issued a payment card, you can create an order for a physical card. When ordering a physical card, you can ship to the account holder's address on file or specify a different shipping address.

Physical card orders require:

• Card personalization details
• Shipping address
• Requested ship date
• Shipping method and signature requirements

For more information on issuing physical cards, see Print Physical Cards.

Once you have requested a Physical Card order you can use a query for updates on the order’s status.

Once the order has moved to SHIPPED status, you can query the tracking number to share with your customers. Orders shipped via USPS Ground do not return a tracking number.

Use the following query to check the status of a Physical Card order:

Orders can only be canceled if they have the NEW status, allowing you to cancel printing and shipment in the event a mistake was made. If you need to edit attributes such as shipping address or make changes after the order passes the NEW status, you must create a new Physical Card order.

Use the following mutation to cancel a Physical Card order:

A SHIPMENT_FAILED status occurs when the Physical Card can not reach the provided address. When this occurs, you must contact the Account Holder for more information and create a new orderPhysicalPaymentCard request with updated information.

Use the following query to find the status of a Physical Card order:

In the Test Environment, Physical Cards are not actually shipped when an order is created and the shipment does not go through the Physical Card order lifecycle. While building your integration, you can manually transition Physical Card orders through the shipment process from both the API and Dashboard and simulate transitioning the order through statuses of SENT_TO_PRINTER, APPROVED, SHIPPED, and SHIP_FAILED.

Use the following sections to simulate order fulfillment.

Once you have created a Physical Card Order with a status of NEW, you can transition it to SENT_TO_PRINTER.

Use the following mutation to simulate sending a Physical Payment Card order to the printer:

Once the Order has been SENT_TO_PRINTER, you can approve the Order and change the status to APPROVED.

Use the following mutation to simulate approving a Physical Payment Card order:

Orders with a status of APPROVED may be transitioned to SHIPPED and will return the shipping method, and if available, tracking number.

Use the following mutation to simulate shipping a Physical Payment Card order:

To design your system to handle failed shipments, you can simulate a status of SHIP_FAILED.

Use the following mutation to simulate a failed shipment: