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"
}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.
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"
}Authorizations
Your Tilta API key, sent as Bearer <key>.
Path Parameters
Unique identifier of a payout instruction.
"8b9f1f4c-2e2a-4a8c-9d51-1b3a3a2c8e9d"
Body
Response
- Option 1
- Option 2
- Option 3
A SEPA payout instruction.
Unique identifier of a payout instruction.
"8b9f1f4c-2e2a-4a8c-9d51-1b3a3a2c8e9d"
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.
false
Timestamp in unix time (seconds).
1582896122
Timestamp in unix time (seconds).
1582896122
SEPA "DE03500105177178979259"
"DEUTDEFF"