Payment terms on orders and invoices
Payment terms and invoice due dates work at different stages of the lifecycle:- Orders use payment term ENUMs. An ENUM such as
DEFER_30Ddescribes a discrete option the buyer requests when placing an order – before any invoice has been issued. Submit the buyer’s choice aspayment_terminPOST /v1/orders. - Invoices use explicit dates. When you create an invoice, you set
invoiced_atanddue_atdirectly instead of passing an ENUM. This lets you issue invoices with any payment period, not only the discrete options listed below.
due_at to match it. For example, for an invoice dated 1 June on an order placed with DEFER_30D, set due_at to 1 July.
The invoice due date must be at least two days in the future. To be eligible for financing, the period between
invoiced_at and due_at must not exceed the maximum payment term configured for your Tilta account.Available payment terms
Tilta supports the following payment term options for orders. Each is identified by an ENUM value that you submit aspayment_term when creating an order.
PREPAYMENT is included for completeness and platform configurability but does not involve deferred financing. It is typically used for platform-specific workflows where upfront payment is required for certain product categories or new buyers.Configuring payment terms for your platform
You decide which of the above terms to offer on your platform. Your configuration is set up during onboarding with your Tilta integration manager. Payment terms are configured for your Tilta account as a whole – every buyer is offered the same set of terms. To retrieve your current configured payment terms programmatically:Previewing payment terms for an order
To show a buyer what each payment term costs before they place an order, request a preview for the buyer, merchant, and order amount:Displaying payment terms at checkout
Use the following pattern to build a reliable checkout payment term selector:- Fetch the payment term preview for the order via
GET /v1/buyers/{external_id}/payment_terms. - Display the returned terms and their fees to the buyer.
- On selection, submit the chosen ENUM as the
payment_termfield inPOST /v1/orders.
Supported payment methods
Tilta supports the following payment methods for buyer repayment.
You select the payment method for each order and invoice through the
payment_method field – for example, TRANSFER for a bank transfer or DEBIT for a SEPA B2B direct debit. Direct debit requires an active mandate for the buyer.
You do not need to handle the repayment itself. Tilta collects repayment directly from the buyer using the payment method you selected.