Define Petroleum Fleet Card transactions, including required parameters and product codes.

Petroleum Fleet Cards

Use these fields in addition to those indicated in the ‘Account Identifiers and Flags’ and ‘Transaction Details’ sections above when processing petroleum cards.

Merchant accounts must be configured specifically to accept Petroleum Cards to use this functionality.

Parameters

All requests require the following parameters. Each parameter includes its requirement, maximum length, format, and notes.

Variable Required Max Size Format Notes
drivernum Mandatory 10 Alphanumeric Driver number (length: 4–10)
vehiclenum Mandatory 8 Alphanumeric Vehicle number (length: 4–8)
odometer Mandatory 9 Alphanumeric Odometer reading (length: 2–9)
jobnum Mandatory 12 Alphanumeric Job number (length: 1–12)
deptnum Mandatory 12 Alphanumeric Department number (length: 1–12)
licensenum Mandatory 12 Alphanumeric License number (length: 1–10)
userdata Mandatory 12 Alphanumeric User-specific data (length: 1–12)
userid Mandatory 12 Alphanumeric User ID (length: 1–12)
devseqnum Mandatory 5 Alphanumeric Card number or vehicle number on front of card (length: 5)
pin Mandatory 16 Alphanumeric Personal Identification Number (PIN) (length: 16)
deviceid Mandatory 2 Alphanumeric Device ID (length: 2)
pumpid Mandatory 2 Alphanumeric Pump ID (length: 2)
ticketnum Mandatory 15 Alphanumeric Ticket number (length: 15)
transflags Recommended 5 Alphanumeric Flags the card as a Petroleum Fleet Card (fleet)
item# Mandatory 23 Alphanumeric Product code (see Product Codes table)
cost# Mandatory 10 Numeric Cost of item; recommended for extended fraud screening
quantity# Mandatory 5 Numeric Quantity of item; recommended for extended fraud screening
description# Mandatory 79 Alphanumeric Long description of item; recommended for extended fraud screening
unit# Mandatory 5 Alphanumeric G = Gas, U = Everything but gas
easycart Mandatory 1 Numeric Value 1

Note: # indicates that multiple items can be included (e.g., item1, item2).

Petroleum Transaction Product Codes

Product Code Description
1 Ethan 1 (Regular)
2 Diesel
3 Unleaded
4 Super Unleaded
5 Other Fuel
6 Unleaded Plus
7 Gas/Alcohol
8 Gas/Alcohol 2
9 Diesel 2
10 Propane
11 CNG
12 Unleaded 10% Blend
13 Unleaded Plus 10% Blend
14 Super Unleaded 10%
15 Unleaded 7% Blend
16 Unleaded Plus 7%
17 Super Unleaded 7% Blend
18 Refer Fuel
19 Fam Fuel
20 Multi-Fuel
21 Motor Oil
22 Lamps
23 Wipers
24 Battery
25 Fluids/Coolants
26 Tires
27 Hoses
28 Filters
30 Repairs
31 Oil Change
32 Tune Up
33 Inspection
34 Car Wash
35 Tires/Batteries/Access
40 Other
41 Accessories
42 Food
43 Service
44 Parts
45 Labor
46 Reserved
51 Discount
56 Sales Tax
101 Full Service Ethan 1 (Regular)
102 Full Service Diesel
103 Full Service Unleaded
104 Full Service Super Unleaded
105 Full Service Other Fuel
106 Full Service Unleaded Plus
107 Full Service Gas/Alcohol
108 Full Service Gas/Alcohol 2
109 Full Service Diesel 2
110 Full Service Propane
111 Full Service CNG
112 Full Service Unleaded 10% Blend
113 Full Service Unleaded Plus 10% Blend
114 Full Service Super Unleaded 10%
115 Full Service Unleaded 7% Blend
116 Full Service Unleaded Plus 7%
117 Full Service Super Unleaded 7% Blend
118 Full Service Refer Fuel
119 Full Service Farm Fuel