Payviate Documentation

World Contract Fuel Transactions

Payviate can be used to process World Fuel Contract Fuel (WFS CF) tranactions.

WFS CF transactions can be passed in in a number of ways.

Token from a card on file - Token field
5 digit WFCF card number - CardNumber field
16 digit WFCF card number - CardNumber field
WFS SO Number - WFSSONumber field

PCATS Line items are required for WFS CF.

To ensure correct pricing, ensure the following fields are passed (in addition to standard Payviate required fields):

Amount must be passed as 0 for contracted items, including taxes on contract items. Pass-thru line items must be priced, and summed in the total.
EnforcePCATSCodes must be passed as True.
The ContractFuel group must be passed in with a FuelDeliveryDate, and a TransactionType. Available TransactionType values are:

Example PreAuth Transaction

POST https://beta.ahtservices.com/ahtcp/payviate/webid/xxxxx/Auth
{
  "TransactionType": "PreAuth",
  "CardNumber": "*****",
  "ExpirationMonth: "**",
  "ExpirationYear": "**",
  "MerchantInvoiceNumber": "2013718",
  "TailNumber": "N876GH",
  "AuthAmount": 0.00,
  "EnforcePCATSCodes": true,
  "Software": "YourSoftware",
  "LineItems": [
    {
      "Description": "JetAFuel",
      "Amount": 0,
      "Quantity": 512,
      "UnitPrice": 0,
      "SalesTax": 0,
      "ProductType": "Fuel"
    }
  ],
  "ContractFuel": {
    "FuelDeliveryDate": "03/20/2026",
    "FlightNumber":"",
    "TransactionType":"CORP"
  }
}