Table of contents
Note: You must have an active card with an available cash balance to simulate authorizations. To issue a card, see Issue virtual cards.
You can use the Highnote dashboard to simulate different transaction events. This allows you to test your integration, notifications, and more. This guide provides an overview for simulating authorizations, clearing events, reversals, and refunds using the Highnote dashboard.
Authorizations
Authorizations occur after a transaction is initiated and verified. During authorization, money in the cardholder's financial account is put on hold.
Use the following steps to simulate an authorization in the dashboard:
- Use the dashboard search bar to search for an account holder. For tips on using the search bar, see Using the Highnote dashboard.
- On the account holder page, click the Cards tab and select a payment card.
- On the card details page, click Authorization.
- On the simulation form, provide an amount.
- Optional - Provide a merchant name, merchant description, and merchant ID.
- Choose a merchant category.
- Choose a merchant country.
- Optional - To simulate a single-step clearing transaction, use the toggle to enable Clear The Authorization.
- Optional - To simulate CVV or address overrides, use the toggle to enable Override CVV or Override Address.
- Click Simulate Authorization.
Clearing
Clearing events occur after an authorization has settled. When an authorization clears, the status of the transaction is updated from "pending" to "posted" and funds are moved from the financial account to the merchant.
Use the following steps to simulate a clearing event in the dashboard:
- Simulate an authorization. Do not clear the authorization.
- On the transaction details page, click Clearing.
- Enter an Amount to clear. You can clear the transaction for the full amount, or a partial amount.
- Optional - Provide a merchant name, merchant description, and merchant ID.
- Optional - Choose a merchant category.
- Click Simulate Clearing.
Reversals
Note: You can only simulate full reversals using the dashboard. To simulate a partial reversal, you must use the Highnote API. For more information, see Simulate Reversal.
Reversals occur when an amount of money is returned to the cardholder before an authorization has cleared. Use the following steps to simulate a full reversal in the dashboard:
- Simulate an authorization. Do not clear the authorization.
- After successfully simulating an authorization, click Reversal on the transaction detail page.
- Optional - Click the toggle for Authorization Did Not Clear Prior to Network Expiration Date.
- Click Simulate Reversal.
Refunds
Refunds occur when a cardholder is owed money after an authorization has cleared. Highnote receives refunds from merchants as authorization, authorization and clear, or clearing events.
Use the following steps to simulate and verify a refund event type using the dashboard:
- Simulate an authorization with a separate clearing event.
- After successfully clearing the authorization, click Refund.
- Enter an Amount to be refunded. You can enter a full or partial amount of the authorization.
- Click Simulate Refund.
- Using the left-hand navigation, click on the Transactions page.
- Verify the refund and the event type the refund was received as.