Home / Issuing / Handle Transactions

Simulate Fleet Transactions

Prerequisites

  1. A Highnote Account
  2. An API Key, the API Explorer, or the Dashboard
  3. A Fleet Visa Card Product, Financial Account, and Payment Card

Overview

Before starting this guide, we recommend viewing Simulate Transactions in Test.

Transactions for Fleet Card Products include several elements not found in other Products, such as enhanced data processing during clearing and settling. Highnote provides a rich set of operations that allow you to simulate Fleet Transactions and ensure your integration is ready for production.

Authorization

Highnote offers two types of authorization controls for Fleet Payment Cards:

For example, Highnote’s Fleet Cards have a product restriction code encoded into the EMV chip to allow fuel purchases and other approved products. The product restriction code may also prevent purchasing non-fleet items, such as food, at fuel stops.

Merchant Category Codes

Fleet Cards may be restricted to specific purchase types. In addition, you may also restrict purchases, such as meals purchased through DoorDash, via MCC-based Spend Control Rules.

Refer to the following product restriction types for Visa and Mastercard:

Visa

  • Open, No Restrictions (Fuel, Maintenance, and Non-Fuel)
  • Fleet (Fuel and Maintenance Only)
  • Fuel Only

Mastercard

  • Open, No Restrictions (Fuel, Maintenance, and Non-Fuel)
  • Fuel Only

All Fleet Cards must accept Fleet/Fuel MCCs and can optionally accept Maintenance MCCs:

Fleet/Fuel MCCs

CODEDESCRIPTION
4468Marinas, Marine service/supplies
5499Miscellaneous food stores - Convenience stores, markets, and specialty stores
5541Service stations (with or without ancillary services)
5542Fuel dispenser, automated
5983Fuel dealers – Coal, fuel oil, liquefied petroleum, wood

Maintenance MCCs

CODEDESCRIPTION
5013Motor vehicle supplies and new parts
5511Automobile and truck dealers – Sales, service, repairs, parts, and leasing
5531Auto stores, home supply stores
5532Automotive tire stores
5533Automotive parts, accessories stores
5599Miscellaneous automotive, aircraft, and farm equipment dealers
7531Automotive body repair shops
7534Tire retreading and repair shops
7535Automotive paint shops
7538Automotive service shops (non-dealer)
7542Car washes
7549Towing services
7692Welding
7699Miscellaneous repair shops and related services

Simulate Authorization with Visa

Use the following query to simulate a Fleet Authorization with Visa:

Simulate Authorization with Mastercard

Use the following query to simulate a Fleet Authorization with Mastercard:

Authorization Advice

The full transaction amount may not be known at authorization for an Automated Fuel Dispenser purchase. Instead, a $1 or estimated amount is sent for authorization, requiring Authorization Advice to be sent to confirm the total amount later. The Authorization Advice amount replaces the original Authorization amount. For example, automated fuel dispensers (AFDs) often charge a $1 Authorization at the time of purchase. A few hours after the cardholder completes fueling, Authorization Advice is sent to confirm the total transaction amount.

Simulating Authorization Advice is optional. Visa supports a Real-Time Clearing program, which does not require Authorization Advice. Skip simulating Authorization Advice in the following scenarios:

  • Simulating a Real-Time Clearing event
  • Simulating an in-store pre-pay transaction
  • Simulating a transaction where the merchant incorrectly did not send Authorization Advice

Simulate Authorization Advice with Visa

Use the following mutation to simulate Authorization Advice with Visa in your Test Environment:

Simulate Authorization Advice with Mastercard

Use the following query to simulate Authorization Advice with Mastercard in your Test Environment:

Clearing

Fleet transactions follow the standard authorization and clearing data flow of all card payments and include ancillary information specific to the fleet vertical via specialized clearing messages. The payment networks outline three levels of data for fleet transactions, but they provide the data at different times during the transaction lifecycle. Depending on your Card Product's payment network, your system will receive and interact with the Level 2 and Level 3 data.

Level 1

Contains standard payment network transaction data provided by merchants. This data includes:

Level 1 data is the same for all transaction types and merchants. No Enhanced Data is captured or provided at this level.

Level 2

Contains Enhanced Data captured at the point of sale and sent with the transaction. Level 2 data is always sent at the time a transaction clears. Level 2 transactions have different MCCs based on whether the Payment Card is used at an Automated Fuel Dispenser or in-store:

  • Automated Fuel Dispenser: 5542
  • In-store: 5541

The full transaction amount may not be known at authorization when Level 2 data is sent for an Automated Fuel Dispenser purchase. Instead, a $1 or estimated amount is sent for authorization, requiring Authorization Advice to be sent to confirm the total amount later.

Refer to the API Reference for more information on Visa Level 2 Purchase Data Fields.

Simulate Clearing with Visa

Visa sends Level 1 and Level 2 data together with the Clearing event. Use the following mutation to simulate Clearing with Visa in your Test Environment:

Simulate Clearing with Mastercard

Mastercard sends Level 1 data only in the Clearing event. Use the following query to simulate a Clearing with Mastercard in your Test Environment:

Level 3 Enhanced Data

Level 3 transactions have different MCCs based on whether the Payment Card is used at an Automated Fuel Dispenser or in-store:

  • Automated Fuel Dispenser: 5542
  • In-store: 5541

The full transaction amount may not be known at authorization when Level 3 data is sent for an Automated Fuel Dispenser purchase. Instead, a $1 or estimated amount is sent for authorization, requiring Authorization Advice to be sent to confirm the total amount at a later time.

You can set up a Notification Event to alert you when Level 3 Data has been added to a transaction.

Simulate Enhanced Data with Visa

Visa Level 3 Data contains enhanced data for a transaction and is generally used to send specifics for non-fuel products and services. The data is sent anywhere from 24 to 48 hours after the transaction. Merchants are not required to report enhanced data for fuel-only transactions. Level 3 Data typically follows an invoice structure with invoice summary information and invoice line item detail information.

Refer to the API Reference for more information on Visa Level 3 Enhanced Data Fields.

Use the following mutation to simulate Visa Fleet Enhanced Data:

Simulate Enhanced Data with Mastercard

Mastercard Level 2 and Level 3 Data contains enhanced data for a transaction and is generally used to send specifics for non-fuel products and services. The data is sent at the end of the business day (EST). Level 3 Data typically follows an invoice structure with invoice summary information and invoice line item detail information.

Refer to the API Reference for more information on Mastercard Enhanced Data Fields.

Use the following mutation to simulate Mastercard Fleet Enhanced Data:

Provide Feedback

Was this content helpful?