Skip to main content
POST
Create a merchant owner
Declare a natural person who ultimately owns or controls the merchant, together with the share of the entity they hold.
The person must already exist in Tilta. Create them with the Create person endpoint first, and make sure the record carries accurate identity and address information – it is used for KYC verification.
Declared ownership percentages are verified as part of KYB. Inaccurate ownership information can result in the merchant being rejected.

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
person_external_id
string
required

Unique identifier of a person.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
percent_ownership
number
required
Required range: 0 <= x <= 100

Response

person_external_id
string
required
merchant_external_id
string
required
status
enum<string>
required
Available options:
PENDING_VERIFICATION,
VERIFYING,
NEEDS_REVIEW,
MANUAL_REVIEW,
REJECTED,
APPROVED,
SUSPENDED,
INACTIVE
percent_ownership
number
required
Required range: 0 <= x <= 100
role
enum<string>
required
Available options:
REAL,
FICTIONAL