Home / Issuing / Issue Cards
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:
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:
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.
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.
|A request for a Physical Card has been made. This is the only stage at which an order may be canceled.|
|This status is only applicable to Group orders. The Group Order is ready to ship but has not yet been sent to the printer.|
|The Order has successfully been sent to the printer.|
|The printer has approved the Order.|
|The Order has been shipped. All shipment methods besides USPS Ground return a tracking number.|
|You requested to cancel the Order.|
|The Order failed to reach the Account Holder. Failed Orders are returned to the return address on file.|
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 firstname.lastname@example.org.
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:
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:
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
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
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
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
Use the following mutation to simulate a failed shipment: