Section 7. Petroleum Cards
Your merchant account must be setup specifically to accept Petroleum Cards in order to utilize this ability.
Please see the two tables below for information regarding mandatory parameters to be sent and product/service codes.
Parameters:
| Variable | Required | Max Size | Value | Notes |
| drivenum | Mandatory | 10 | Driver NumberFormat: alphanumericLength: 4 to 10 | |
| vehiclenum | Mandatory | 8 | Vehicle NumberFormat: alphanumericLength: 4 to 8 | |
| odometer | Mandatory | 9 | OdometerFormat: alphanumericLength: 2 to 9 | |
| jobnum | Mandatory | 12 | Job NumberFormat: alphanumericLength: 1 to 12 | |
| deptnum | Mandatory | 12 | Department NumberFormat: alphanumericLength: 1 to 12 | |
| licensenum | Mandatory | 12 | License NumberFormat: alphanumericLength: 1 to 12 | |
| userdata | Mandattory | 12 | User DateFormat: alphanumericLength: 1 to 12 | |
| userid | Mandatory | 12 | User IDFormat: alphanumericLength: 1 to 12 | |
| devseqnum | Mandatory | 5 | CARD NO. or vehicle number on front of cardFormat: alphanumericLength: 5 | |
| pin | Mandatory | 16 | Personal Identification Number (PIN)Format: alphanumericLength: 16 | |
| deviceid | Mandatory | 2 | Device IDFormat: alphanumericLength: 2 | |
| pumpid | Mandatory | 2 | Pump IDFormat: alphanumericLength: 2 | |
| ticketnum | Mandatory | 15 | Ticket NumberFormat: alphanumericLength: 15 | |
| transflags | Recommended | 5 | fleet | This flags the card being used as a Petroleum Fleet Card. |
| item# | Mandatory | 23 | Please see table below for allowed values. | |
| cost# | Mandatory | 10 | Cost of item. Recommended for extended fraud screening. | |
| quantity# | Mandatory | 5 | Quantity of item. Recommended for exentended fraud screening. | |
| description# | Mandatory | 79 | Long description of item. Recommended for extended fraud screening. | |
| unit# | Mandatory | 5 | G,U | G = Gas.U = Everything but gas. |
| easycart | Mandatory | 1 | 1 |
Petroleum Transaction Product Codes:
| Product Code Description | Product Code # | Product Code Description | Product Code # |
| Ethan 1 (Regular) | 1 | Inspection | 33 |
| Diesel | 2 | Car Wash | 34 |
| Unleaded | 3 | Tires/Batteries/Access | 35 |
| Super Unleaded | 4 | Other | 40 |
| Other Fuel | 5 | Accessories | 41 |
| Unleaded Plus | 6 | Food | 42 |
| Gas/Alcohol | 7 | Service | 43 |
| Gas/Alcohol 2 | 8 | Parts | 44 |
| Diesel 2 | 9 | Labor | 45 |
| Propane | 10 | Reserved | 46 |
| CNG | 11 | Discount | 51 |
| Unleaded 10% Blend | 12 | Sales Tax | 56 |
| Unleaded Plus 10% Blend | 13 | Full Service Ethan 1 (Regular) | 101 |
| Super Unleaded 10% | 14 | Full Service Diesel | 102 |
| Unleaded 7% Blend | 16 | Full Service Unleaded | 103 |
| Unleaded Plus 7% | 16 | Full Service Super Unleaded | 104 |
| Super Unleaded 7% Blend | 17 | Full Service Other Fuel | 105 |
| Refer Fuel | 18 | Full Service Unleaded Plus | 106 |
| Fam Fuel | 19 | Full Service Gas/Alcohol | 107 |
| Multi-Fuel | 20 | Full Service Gas/Alcohol 2 | 108 |
| Motor Oil | 21 | Full Service Diesel 2 | 109 |
| Lamps | 22 | Full Service Propane | 110 |
| Wipers | 23 | Full Service CNG | 111 |
| Battery | 24 | Full Service Unleaded 10% Blend | 112 |
| Fluids/Coolants | 25 | Full Service Unleaded Plus 10% Blend | 113 |
| Tires | 26 | Full Service Super Unleaded 10% | 114 |
| Hoses | 27 | Full Service Unleaded 7% Blend | 115 |
| Filters | 28 | Full Service Unleaded Plus 7% | 116 |
| Repairs | 30 | Full Service Super Unleaded 7% Blend | 117 |
| Oil Change | 31 | Full Service Refer Fuel | 118 |
| Tune Up | 32 | Full Service Farm Fuel | 119 |