Skip to main content
POST
Create a payout instruction
Payout Instructions define the bank account to which Tilta transfers funds once a merchant’s invoice is captured and financed. Every approved merchant needs at least one verified payout instruction before their orders can result in a payout.
Create the payout instruction as soon as a merchant is approved, so payouts are not delayed when their first invoice is captured.

Authorizations

Authorization
string
header
required

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

Body

application/json

SEPA payout instruction.

external_id
string
required

Unique identifier of a payout instruction.

Example:

"8b9f1f4c-2e2a-4a8c-9d51-1b3a3a2c8e9d"

merchant_external_id
string
required

Unique identifier of the merchant the payout instruction belongs to.

Example:

"merchant_id1"

type
enum<string>
required
Available options:
SEPA
beneficiary_name
string
required
Example:

"ACME Distribution GmbH"

iban
string
required
Example:

"DE00123456781234567890"

bic
string
required
Example:

"DEUTDEDB"

Response

A SEPA payout instruction.

external_id
string
required

Unique identifier of a payout instruction.

Example:

"8b9f1f4c-2e2a-4a8c-9d51-1b3a3a2c8e9d"

beneficiary_name
string
required
is_verified
boolean
required

Whether this payout instruction has been verified by Tilta and is therefore eligible for use in actual payouts. Newly created or replaced payout instructions are unverified and must be verified by Tilta out-of-band before they can be used operationally.

Example:

false

created_at
number
required

Timestamp in unix time (seconds).

Example:

1582896122

updated_at
number
required

Timestamp in unix time (seconds).

Example:

1582896122

type
enum<string>
required
Available options:
SEPA
iban
string
required
Example:

"DE03500105177178979259"

bic
string
required
Example:

"DEUTDEFF"