Replace a payout instruction
curl --request PUT \
--url https://api.tilta.io/v1/payout_instructions/{external_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "SEPA",
"beneficiary_name": "ACME Distribution GmbH",
"iban": "DE00123456781234567890",
"bic": "DEUTDEDB"
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
type: 'SEPA',
beneficiary_name: 'ACME Distribution GmbH',
iban: 'DE00123456781234567890',
bic: 'DEUTDEDB'
})
};
fetch('https://api.tilta.io/v1/payout_instructions/{external_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.tilta.io/v1/payout_instructions/{external_id}"
payload = {
"type": "SEPA",
"beneficiary_name": "ACME Distribution GmbH",
"iban": "DE00123456781234567890",
"bic": "DEUTDEDB"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tilta.io/v1/payout_instructions/{external_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'type' => 'SEPA',
'beneficiary_name' => 'ACME Distribution GmbH',
'iban' => 'DE00123456781234567890',
'bic' => 'DEUTDEDB'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"external_id": "8b9f1f4c-2e2a-4a8c-9d51-1b3a3a2c8e9d",
"beneficiary_name": "<string>",
"is_verified": false,
"created_at": 1582896122,
"updated_at": 1582896122,
"type": "SEPA",
"iban": "DE03500105177178979259",
"bic": "DEUTDEFF"
}{
"code": "BAD_REQUEST",
"error": "Request validation failed. 1 issue found.",
"issues": [
{
"code": "INVALID_TYPE",
"path": "body.registered_at",
"message": "Invalid type"
}
]
}{
"error": "Unauthorized",
"code": "UNAUTHORIZED"
}{
"error": "No Entity found",
"code": "NOT_FOUND"
}Merchants
Replace a payout instruction
Replace the bank account details on an existing payout instruction. Replacing resets verification, so only do it when the account genuinely changes.
PUT
/
v1
/
payout_instructions
/
{external_id}
Replace a payout instruction
curl --request PUT \
--url https://api.tilta.io/v1/payout_instructions/{external_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "SEPA",
"beneficiary_name": "ACME Distribution GmbH",
"iban": "DE00123456781234567890",
"bic": "DEUTDEDB"
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
type: 'SEPA',
beneficiary_name: 'ACME Distribution GmbH',
iban: 'DE00123456781234567890',
bic: 'DEUTDEDB'
})
};
fetch('https://api.tilta.io/v1/payout_instructions/{external_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.tilta.io/v1/payout_instructions/{external_id}"
payload = {
"type": "SEPA",
"beneficiary_name": "ACME Distribution GmbH",
"iban": "DE00123456781234567890",
"bic": "DEUTDEDB"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tilta.io/v1/payout_instructions/{external_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'type' => 'SEPA',
'beneficiary_name' => 'ACME Distribution GmbH',
'iban' => 'DE00123456781234567890',
'bic' => 'DEUTDEDB'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"external_id": "8b9f1f4c-2e2a-4a8c-9d51-1b3a3a2c8e9d",
"beneficiary_name": "<string>",
"is_verified": false,
"created_at": 1582896122,
"updated_at": 1582896122,
"type": "SEPA",
"iban": "DE03500105177178979259",
"bic": "DEUTDEFF"
}{
"code": "BAD_REQUEST",
"error": "Request validation failed. 1 issue found.",
"issues": [
{
"code": "INVALID_TYPE",
"path": "body.registered_at",
"message": "Invalid type"
}
]
}{
"error": "Unauthorized",
"code": "UNAUTHORIZED"
}{
"error": "No Entity found",
"code": "NOT_FOUND"
}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.
Path Parameters
Body
application/json
Response
- Option 1
- Option 2
- Option 3
A SEPA payout instruction.