Business Rules

The set of business rules that applies to the PPS Gateway for AIR Card®

The following table lists business rules relevant to the PPS Gateway for AIR Card®, along with their corresponding APIs:

APIRule
VoidTo void a transaction, the batch that includes the transaction must be open.
SaleSome AIR Cards® only allow for the billing of fuel and not for other types of services.
SaleIf you specify a time in the deliveryDate property of a details subobject of a Sale, you must use UTC time.
SaleIf you input an eProcessingType of CONTRACT, the gateway will check if you are under contract for those products with the airport at the time of the transaction.
SaleIf you are not under contract at an airport, you cannot send transactions to the gateway if another merchant is under contract at the same airport for those contracted products (though system overrides may apply).
SaleA details subobject of a Sale can only include one item of type Fuel but can have several non-fuel items.
SaleIf an item is a fuel type, the properties deliveryDate and deliveryTicketNumber are required in the details subobject of a Sale.
SaleThe gateway will mark a transaction as a possible duplicate if you submit one with the same location and same amount of fuel and the same card and tail number as another within 48 hours (though system overrides may apply).
SaleYou cannot include the taxes and fees that have been specified in a taxAndFeesBreakdown subobject of a Sale in the invoiceTotal property of the invoice subobject.
SaleIf you charge a "vendor fee" for non-fuel items, the gateway validates that the percentage of this fee in relation to the total value of non-fuel items matches the percentage that you specified in your configuration.
SaleIf you charge a "vendor fee" for non-fuel items, you must include this fee in a details subobject of a Sale and not in a taxAndFeesBreakdown subobject.
SaleYou can only include taxes and fees that the gateway has approved in a taxAndFeesBreakdown subobject of a Sale.
SaleIf you've applied a government discount to a transaction, you must reflect this discount in the difference between the postedPrice and the unitPrice properties of the details subobject of a Sale.
SaleThe gateway validates the fuel capacity of an aircraft, and it does not allow the purchase of fuel above what has been established (though system overrides may apply).
SaleIf you are a third-party merchant with an eProcessingType of RETAIL, you must send the gateway the price of fuel prior to transaction initiation, and the gateway will then validate this price in ongoing transactions.
SaleIf an item in a details subobject of a Sale has a product type of Fuel Related, there must be another item in the subobject that has a product type of Fuel.