Skip to main content
POST
Request a credit facility increase
If a buyer’s purchasing volume grows beyond their current credit facility limit, you can request an increase on their behalf. The increase request triggers a new underwriting review using the latest credit bureau data and the buyer’s updated business profile. The requested amount represents the new total limit you are asking for – not an incremental increase on top of the current limit. Because the review involves external data sources, the result is delivered asynchronously via a FACILITY.INCREASE.* webhook event rather than synchronously in the response.

Webhook events

Tilta delivers the underwriting result for an increase request via the following webhook events:
The requested_amount is the desired total facility limit, not an incremental add-on. If the buyer’s current limit is €100,000 (10000000) and you want to raise it to €150,000, submit requested_amount: 15000000.
A buyer can only have one increase request under review at a time. Submitting another while one is outstanding returns a 409 Conflict – wait for the FACILITY.INCREASE.ACCEPTED or FACILITY.INCREASE.REJECTED webhook first.
Monitor credit utilization with List facilities. When a buyer’s used_amount consistently approaches their total_amount, request an increase before checkout starts failing for insufficient credit.

Authorizations

Authorization
string
header
required

Your Tilta API key, sent as Bearer <key>.

Path Parameters

external_id
string
required

Unique identifier of a buyer.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$

Body

application/json
requested_amount
integer
required

The total amount of credit limit requested.

Required range: x > 0
comments
string | null

Comments for the request.

Maximum string length: 500

Response

The creation of a credit facility is pending.

buyer_external_id
string
required

Unique identifier for buyer.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
Example:

"5f6374a46a5e8e0104aa5cd4"

status
enum<string>
required

Status of the Pending facility

Available options:
PENDING