Skip to main content

Trip Invoices Service

MaaS allows consumers to retrieve invoices associated with trips. There are two different types of invoices:

  1. Trip: This invoice type is linked to a single trip, and each trip has a unique invoice of this type and it is automatically created when a trip is ended.
  2. Refund: This invoice type is associated with a refund, a refund invoice is created when a refund is issued 1.

The v2alpha1 version of the Trip Invoice Service API provides four endpoints:

  • GetTripInvoice: Retrieve an invoice for a terminated trip.
  • ListTripInvoices: Retrieve a list of all invoices (includes all types) for an individual trip.
  • CreateTripInvoice: Create a Refund invoice for a terminated trip 1.
  • WaitForTripInvoice: Wait for a Trip invoice to be created for an ended trip, it immediately returns the invoice if available, it waits for it to become available or it times out if not available within the time limit. This is a convenience endpoint, designed to be called immediately after a trip ended.

Sequence Diagram

1: Refunding of an invoice is only supported for partners that provides a PSP for refunds. Currently this feature is only supported for select integrations.