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.

​
How due dates are calculated

The repayment due date is always calculated from the moment of Invoice capture – not the order creation date, and not the delivery date. This distinction matters: if a buyer authorizes an order today but the merchant doesn’t ship for two weeks, the due date clock starts on the day the invoice is created, not the day the order was placed. For example, if an invoice is captured on 1 June with DEFER_30D payment terms, the buyer’s payment is due on 1 July, regardless of when the order was originally authorized.
Communicate this clearly to your merchants. A merchant who delays creating an invoice is effectively giving the buyer more time to pay, which may affect the merchant’s own cash flow planning.

​
Available payment terms

Tilta supports the following payment term options. Each is identified by an ENUM value that you use in API requests when creating orders and invoices.
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. To retrieve your current configured payment terms programmatically:
This returns a plain array of payment term ENUMs your platform is enabled to use. Only terms in this list can be submitted in order and invoice requests.

​
Buyer-specific payment terms

Some buyers may have a restricted set of available payment terms based on their credit facility risk tier or underwriting outcome. To retrieve the payment terms available for a specific buyer:
The response pairs each available term with the payment method it applies to, plus the fee and any installment breakdown:
Always use the buyer-specific endpoint to populate your checkout payment term selector. A buyer whose credit facility only supports up to 60 days should not be offered DEFER_90D, even if your platform is configured to offer it.
Submitting an order or invoice with a payment term that is not available to the specific buyer will return a validation error. Fetch the buyer’s available terms before presenting options at checkout.

​
Displaying payment terms at checkout

Use the following pattern to build a reliable checkout payment term selector:
  1. Fetch the buyer’s available payment terms via GET /v1/buyers/{external_id}/payment_terms.
  2. Intersect with your platform’s configured terms from GET /v1/platform/payment_terms.
  3. Display only the intersection to the buyer.
  4. On selection, submit the chosen ENUM as the payment_term field in POST /v1/orders.
This two-step check ensures you never present a term that is either not enabled on your platform or not available to the specific buyer.

​
Supported payment methods

Tilta supports the following payment methods for buyer repayment. The available methods depend on the buyer’s country of registration and banking setup.
You do not need to implement payment method handling on your side. Tilta manages the repayment process directly with the buyer. The supported methods listed above determine how Tilta will collect repayment from each buyer based on their banking setup.
Tilta automatically selects the most appropriate payment method for each buyer based on their registered country and the mandate information collected during onboarding. Buyers are notified of their repayment details in Tilta’s automated confirmation emails.