Skip to main content
Payment terms define when a buyer must repay a financed invoice. Rather than paying at point of purchase, the buyer receives a credit period – ranging from 3 to 90 days – during which they can use the goods or services before settling their obligation. You configure which payment terms to make available. Buyers then select from your configured options at checkout.

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_30D describes a discrete option the buyer requests when placing an order – before any invoice has been issued. Submit the buyer’s choice as payment_term in POST /v1/orders.
  • Invoices use explicit dates. When you create an invoice, you set invoiced_at and due_at directly instead of passing an ENUM. This lets you issue invoices with any payment period, not only the discrete options listed below.
If the buyer chose a payment term on the order, set the invoice’s 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 as payment_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:
This returns a plain array of the payment term ENUMs enabled for your Tilta account. Offer buyers only the terms in this list when they choose a payment term for an order.

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:
The response lists your configured payment terms, each paired with the payment method, the buyer fee, and the installment schedule for that order amount:
The preview does not apply buyer-specific terms. It returns the terms configured for your Tilta account, but first checks that the buyer can place the order – the buyer needs an active credit facility with enough available credit. Terms that would fall due after the buyer’s credit facility expires are left out of the response.

Displaying payment terms at checkout

Use the following pattern to build a reliable checkout payment term selector:
  1. Fetch the payment term preview for the order via GET /v1/buyers/{external_id}/payment_terms.
  2. Display the returned terms and their fees to the buyer.
  3. On selection, submit the chosen ENUM as the payment_term field in POST /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.
Buyers receive their repayment details in Tilta’s automated payment reminder emails. See Buyer communication for the cadence and content of those emails.