Invoices

An invoice forms the basis of a Tilia Pay purchase transaction.

Invoice properties

Each invoice is associated with one or more payment methods. Supported payment methods include credit cards, Tilia Wallets, and PayPal.

An invoice has one or more line items, and each line item has a transaction type. Tilia supports the following transaction types:

  • User to user: Used when the customer is paying another user for a good or service.
  • User to integrator: Used when the customer is paying you for a good or service.
  • Token purchase: A special transaction type used in purchasing in-game tokens.

You can combine line items with different transaction types in a single invoice. For example, an invoice may have a user-to-user line item to compensate a seller, and a user-to-integrator line item to capture the fee you collect for the transaction.

You can pass us information referencing the transaction in your system and other metadata related to your invoice.

Our Developer Guides walk you through the process of creating invoices for various transaction types.

Invoice lifecycle

A typical invoice moves through the following states: open, processing, and success.

If an invoice cannot be processed (for example, if the user's credit card is declined), it is assigned a state of failed.

An unprocessed invoice can also be cancelled, in which case it is assigned a state of cancelled.

Webhooks

Our webhook enables you to keep track of an invoice throughout its lifecycle. Refer to the Invoice Completion webhook documentation for more details.

You can also retrieve any invoice by its ID.

GET https://invoicing.tilia-inc.com/v2/invoice/{invoice_id}