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

Petroleum Fleet Cards

Use these fields in addition to the standard Remote Authorization parameter sections when processing petroleum cards:

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

Variable	Requirement	Type	Max Size	Possible Values / Example	Description	Notes
`drivernum`	Mandatory	string	10	—	Driver number.	Alphanumeric. Length: 4–10.
`vehiclenum`	Mandatory	string	8	—	Vehicle number.	Alphanumeric. Length: 4–8.
`odometer`	Mandatory	string	9	—	Odometer reading.	Alphanumeric. Length: 2–9.
`jobnum`	Mandatory	string	12	—	Job number.	Alphanumeric. Length: 1–12.
`deptnum`	Mandatory	string	12	—	Department number.	Alphanumeric. Length: 1–12.
`licensenum`	Mandatory	string	10	—	License number.	Alphanumeric. Length: 1–10.
`userdata`	Mandatory	string	12	—	User-specific data.	Alphanumeric. Length: 1–12.
`userid`	Mandatory	string	12	—	User ID.	Alphanumeric. Length: 1–12.
`devseqnum`	Mandatory	string	5	—	Card number or vehicle number on front of card.	Alphanumeric. Length: 5.
`pin`	Mandatory	string	16	—	Personal Identification Number (PIN).	Alphanumeric. Length: 16.
`deviceid`	Mandatory	string	2	—	Device ID.	Alphanumeric. Length: 2.
`pumpid`	Mandatory	string	2	—	Pump ID.	Alphanumeric. Length: 2.
`ticketnum`	Mandatory	string	15	—	Ticket number.	Alphanumeric. Length: 15.
`transflags`	Recommended	string	5	`fleet`	Flags the card as a Petroleum Fleet Card.	Alphanumeric.
`item#`	Mandatory	string	23	See Product Codes table	Product code for the purchased item.	Alphanumeric.
`cost#`	Mandatory	decimal	10	`15.00`	Cost of item. ¹	Numeric. Recommended for extended fraud screening.
`quantity#`	Mandatory	integer	5	`1`	Quantity of item.	Numeric. Recommended for extended fraud screening.
`description#`	Mandatory	string	79	—	Long description of item.	Alphanumeric. Recommended for extended fraud screening.
`unit#`	Mandatory	string	5	`G`, `U`	Unit of measure for the item.	`G` = Gas, `U` = Everything but gas.
`easycart`	Mandatory	integer	1	`1`	Enables itemized petroleum transaction processing.	Must be set to `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

⚠️ Formatting Rule (Applies to All Amount Fields)

All monetary values must be numeric only in the format 1234.56. Do not include currency symbols, commas, or formatting. Exactly two decimal places are required. ↩︎