Skip to main content
PUT
Replace a merchant
This endpoint fully replaces the data for an existing merchant using HTTP PUT semantics. Every field in the merchant record is overwritten with the values you provide in the request body – any field you omit will be cleared or reset to its default. In particular, the business_identifiers array is replaced entirely, so you must re-include any existing identifiers you want to retain. If you only need to update a subset of fields, retrieve the current merchant first using the Retrieve merchant endpoint, modify the fields you need, and then submit the complete merged payload to this endpoint.
This is a full replacement operation. Omitting a field does not preserve its current value – it will be cleared. Always retrieve the current merchant record before calling this endpoint if you want to perform a partial update.
Replacing merchant data does not affect their approval status. An ENROLLED merchant stays enrolled after a data update, and any active financing arrangements continue uninterrupted.

Authorizations

Authorization
string
header
required

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

Path Parameters

external_id
string
required

Unique identifier of a merchant.

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

Body

application/json

Merchant's full legal name incl. the legal form if applicable.

Example:

"ACME Distribution GmbH"

Merchant's legal form.

Available options:
LIMITED_COMPANY,
SOLE_TRADER,
PARTNERSHIP,
PUBLIC_COMPANY,
COOPERATIVE,
GOVERNMENT,
OTHER
trading_name
string | null
required

Merchant's trading name. Send null to clear.

Example:

"ACME"

business_identifiers
object[]
required

List of business identifiers. Replaces the existing set entirely. Send [] to clear all identifiers.

business_address
object
required

Merchant's address.

contact_emails
string<email>[]
required

Merchant's contact emails.

Maximum array length: 10
incorporated_at
number | null
required

Merchant's date of incorporation (unix time in seconds). Send null to clear.

Example:

1582896122

Response

A merchant has been successfully created or updated.

external_id
string
required

Unique identifier of a merchant.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
status
enum<string>
required

Merchant's enrollment status

Available options:
ENROLLED,
INACTIVE,
EXPIRED
created_at
number
required

Timestamp indicating when the merchant was created (unix time in seconds).

Example:

1582896122

updated_at
number
required

Timestamp indicating the last time the merchant was updated (unix time in seconds).

Example:

1582896122

Merchant's full legal name incl. the legal form if applicable.

Example:

"ACME Distribution GmbH"

Merchant's legal form, which depends on the merchant's registered country. Available legal forms cover Tilta's operating countries.

Available options:
LIMITED_COMPANY,
SOLE_TRADER,
PARTNERSHIP,
PUBLIC_COMPANY,
COOPERATIVE,
GOVERNMENT,
OTHER
business_address
object
required

Merchant's address.

contact_emails
string<email>[]
required

Merchant's contact emails

Maximum array length: 10
trading_name
string | null

Merchant's trading name.

Example:

"ACME"

business_identifiers
object[] | null

A list of business identifiers

incorporated_at
number | null

Merchant's date of incorporation (unix time in seconds), meaning the date when the business of registered or started.

Example:

1582896122