Skip to main content
PUT
Replace a payout instruction
Because replacing an instruction forces Tilta to re-verify the account, only call this endpoint when the underlying bank account genuinely changes. Payouts to the merchant are held until re-verification completes.

Authorizations

Authorization
string
header
required

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

Path Parameters

external_id
string
required

Unique identifier of a payout instruction.

Example:

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

Body

application/json

SEPA payout instruction.

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"