curl --request POST \
--url https://api.sandbox.finsei.com/v2/beneficiary \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"currency_id": "EUR",
"entity_type": "company",
"uuid": "<string>",
"name": "Aliaksandr",
"bank_country": "LT",
"iban": "NL13RABO4448094871",
"bic_swift": "AGBLLT2X",
"account_number": 123,
"sort_code": 123,
"street": "Gagarina street",
"house": "22",
"city": "London",
"country_id": "GB",
"postal_code": "10001",
"company_name": "Finsei Ltd.",
"first_name": "Aliaksandr",
"last_name": "Lastname"
}
'import requests
url = "https://api.sandbox.finsei.com/v2/beneficiary"
payload = {
"currency_id": "EUR",
"entity_type": "company",
"uuid": "<string>",
"name": "Aliaksandr",
"bank_country": "LT",
"iban": "NL13RABO4448094871",
"bic_swift": "AGBLLT2X",
"account_number": 123,
"sort_code": 123,
"street": "Gagarina street",
"house": "22",
"city": "London",
"country_id": "GB",
"postal_code": "10001",
"company_name": "Finsei Ltd.",
"first_name": "Aliaksandr",
"last_name": "Lastname"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
currency_id: 'EUR',
entity_type: 'company',
uuid: '<string>',
name: 'Aliaksandr',
bank_country: 'LT',
iban: 'NL13RABO4448094871',
bic_swift: 'AGBLLT2X',
account_number: 123,
sort_code: 123,
street: 'Gagarina street',
house: '22',
city: 'London',
country_id: 'GB',
postal_code: '10001',
company_name: 'Finsei Ltd.',
first_name: 'Aliaksandr',
last_name: 'Lastname'
})
};
fetch('https://api.sandbox.finsei.com/v2/beneficiary', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sandbox.finsei.com/v2/beneficiary",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'currency_id' => 'EUR',
'entity_type' => 'company',
'uuid' => '<string>',
'name' => 'Aliaksandr',
'bank_country' => 'LT',
'iban' => 'NL13RABO4448094871',
'bic_swift' => 'AGBLLT2X',
'account_number' => 123,
'sort_code' => 123,
'street' => 'Gagarina street',
'house' => '22',
'city' => 'London',
'country_id' => 'GB',
'postal_code' => '10001',
'company_name' => 'Finsei Ltd.',
'first_name' => 'Aliaksandr',
'last_name' => 'Lastname'
]),
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;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.sandbox.finsei.com/v2/beneficiary"
payload := strings.NewReader("{\n \"currency_id\": \"EUR\",\n \"entity_type\": \"company\",\n \"uuid\": \"<string>\",\n \"name\": \"Aliaksandr\",\n \"bank_country\": \"LT\",\n \"iban\": \"NL13RABO4448094871\",\n \"bic_swift\": \"AGBLLT2X\",\n \"account_number\": 123,\n \"sort_code\": 123,\n \"street\": \"Gagarina street\",\n \"house\": \"22\",\n \"city\": \"London\",\n \"country_id\": \"GB\",\n \"postal_code\": \"10001\",\n \"company_name\": \"Finsei Ltd.\",\n \"first_name\": \"Aliaksandr\",\n \"last_name\": \"Lastname\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.sandbox.finsei.com/v2/beneficiary")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"currency_id\": \"EUR\",\n \"entity_type\": \"company\",\n \"uuid\": \"<string>\",\n \"name\": \"Aliaksandr\",\n \"bank_country\": \"LT\",\n \"iban\": \"NL13RABO4448094871\",\n \"bic_swift\": \"AGBLLT2X\",\n \"account_number\": 123,\n \"sort_code\": 123,\n \"street\": \"Gagarina street\",\n \"house\": \"22\",\n \"city\": \"London\",\n \"country_id\": \"GB\",\n \"postal_code\": \"10001\",\n \"company_name\": \"Finsei Ltd.\",\n \"first_name\": \"Aliaksandr\",\n \"last_name\": \"Lastname\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.finsei.com/v2/beneficiary")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"currency_id\": \"EUR\",\n \"entity_type\": \"company\",\n \"uuid\": \"<string>\",\n \"name\": \"Aliaksandr\",\n \"bank_country\": \"LT\",\n \"iban\": \"NL13RABO4448094871\",\n \"bic_swift\": \"AGBLLT2X\",\n \"account_number\": 123,\n \"sort_code\": 123,\n \"street\": \"Gagarina street\",\n \"house\": \"22\",\n \"city\": \"London\",\n \"country_id\": \"GB\",\n \"postal_code\": \"10001\",\n \"company_name\": \"Finsei Ltd.\",\n \"first_name\": \"Aliaksandr\",\n \"last_name\": \"Lastname\"\n}"
response = http.request(request)
puts response.read_body{
"errors": [],
"notice": [],
"data": {
"id": 84,
"uuid": "019ce5b3-6a71-724a-8a44-267480d63534"
}
}{
"name": "Unauthorized",
"message": "Your request was made with invalid credentials.",
"status": 401
}{
"name": "Forbidden",
"message": "String",
"status": 403
}POST /v2/beneficiary
curl --request POST \
--url https://api.sandbox.finsei.com/v2/beneficiary \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"currency_id": "EUR",
"entity_type": "company",
"uuid": "<string>",
"name": "Aliaksandr",
"bank_country": "LT",
"iban": "NL13RABO4448094871",
"bic_swift": "AGBLLT2X",
"account_number": 123,
"sort_code": 123,
"street": "Gagarina street",
"house": "22",
"city": "London",
"country_id": "GB",
"postal_code": "10001",
"company_name": "Finsei Ltd.",
"first_name": "Aliaksandr",
"last_name": "Lastname"
}
'import requests
url = "https://api.sandbox.finsei.com/v2/beneficiary"
payload = {
"currency_id": "EUR",
"entity_type": "company",
"uuid": "<string>",
"name": "Aliaksandr",
"bank_country": "LT",
"iban": "NL13RABO4448094871",
"bic_swift": "AGBLLT2X",
"account_number": 123,
"sort_code": 123,
"street": "Gagarina street",
"house": "22",
"city": "London",
"country_id": "GB",
"postal_code": "10001",
"company_name": "Finsei Ltd.",
"first_name": "Aliaksandr",
"last_name": "Lastname"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
currency_id: 'EUR',
entity_type: 'company',
uuid: '<string>',
name: 'Aliaksandr',
bank_country: 'LT',
iban: 'NL13RABO4448094871',
bic_swift: 'AGBLLT2X',
account_number: 123,
sort_code: 123,
street: 'Gagarina street',
house: '22',
city: 'London',
country_id: 'GB',
postal_code: '10001',
company_name: 'Finsei Ltd.',
first_name: 'Aliaksandr',
last_name: 'Lastname'
})
};
fetch('https://api.sandbox.finsei.com/v2/beneficiary', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sandbox.finsei.com/v2/beneficiary",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'currency_id' => 'EUR',
'entity_type' => 'company',
'uuid' => '<string>',
'name' => 'Aliaksandr',
'bank_country' => 'LT',
'iban' => 'NL13RABO4448094871',
'bic_swift' => 'AGBLLT2X',
'account_number' => 123,
'sort_code' => 123,
'street' => 'Gagarina street',
'house' => '22',
'city' => 'London',
'country_id' => 'GB',
'postal_code' => '10001',
'company_name' => 'Finsei Ltd.',
'first_name' => 'Aliaksandr',
'last_name' => 'Lastname'
]),
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;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.sandbox.finsei.com/v2/beneficiary"
payload := strings.NewReader("{\n \"currency_id\": \"EUR\",\n \"entity_type\": \"company\",\n \"uuid\": \"<string>\",\n \"name\": \"Aliaksandr\",\n \"bank_country\": \"LT\",\n \"iban\": \"NL13RABO4448094871\",\n \"bic_swift\": \"AGBLLT2X\",\n \"account_number\": 123,\n \"sort_code\": 123,\n \"street\": \"Gagarina street\",\n \"house\": \"22\",\n \"city\": \"London\",\n \"country_id\": \"GB\",\n \"postal_code\": \"10001\",\n \"company_name\": \"Finsei Ltd.\",\n \"first_name\": \"Aliaksandr\",\n \"last_name\": \"Lastname\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.sandbox.finsei.com/v2/beneficiary")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"currency_id\": \"EUR\",\n \"entity_type\": \"company\",\n \"uuid\": \"<string>\",\n \"name\": \"Aliaksandr\",\n \"bank_country\": \"LT\",\n \"iban\": \"NL13RABO4448094871\",\n \"bic_swift\": \"AGBLLT2X\",\n \"account_number\": 123,\n \"sort_code\": 123,\n \"street\": \"Gagarina street\",\n \"house\": \"22\",\n \"city\": \"London\",\n \"country_id\": \"GB\",\n \"postal_code\": \"10001\",\n \"company_name\": \"Finsei Ltd.\",\n \"first_name\": \"Aliaksandr\",\n \"last_name\": \"Lastname\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.finsei.com/v2/beneficiary")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"currency_id\": \"EUR\",\n \"entity_type\": \"company\",\n \"uuid\": \"<string>\",\n \"name\": \"Aliaksandr\",\n \"bank_country\": \"LT\",\n \"iban\": \"NL13RABO4448094871\",\n \"bic_swift\": \"AGBLLT2X\",\n \"account_number\": 123,\n \"sort_code\": 123,\n \"street\": \"Gagarina street\",\n \"house\": \"22\",\n \"city\": \"London\",\n \"country_id\": \"GB\",\n \"postal_code\": \"10001\",\n \"company_name\": \"Finsei Ltd.\",\n \"first_name\": \"Aliaksandr\",\n \"last_name\": \"Lastname\"\n}"
response = http.request(request)
puts response.read_body{
"errors": [],
"notice": [],
"data": {
"id": 84,
"uuid": "019ce5b3-6a71-724a-8a44-267480d63534"
}
}{
"name": "Unauthorized",
"message": "Your request was made with invalid credentials.",
"status": 401
}{
"name": "Forbidden",
"message": "String",
"status": 403
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Currency code
3"EUR"
Beneficiary entity type
individual, company "company"
UUID of beneficiary
Name of beneficiary
255"Aliaksandr"
Alpha-2 bank country code. Used for DEFAULT bank details.
2"LT"
IBAN. Used for DEFAULT bank details.
255"NL13RABO4448094871"
BIC/SWIFT. Used for DEFAULT bank details and not required for SEPA accounts.
"AGBLLT2X"
Account number. Used for LOCAL bank details.
Sort code. Used for LOCAL bank details.
Bank details type
DEFAULT, LOCAL Beneficiary address street. Required for non-SEPA accounts.
64"Gagarina street"
Beneficiary house number. Required for non-SEPA accounts.
32"22"
Beneficiary city. Required for non-SEPA accounts.
64"London"
Beneficiary address country Alpha-2 code. Required for non-SEPA accounts.
"GB"
Beneficiary postal code. Required for non-SEPA accounts.
32"10001"
Company name. Required when entity_type is company.
35"Finsei Ltd."
Beneficiary first name. Required when entity_type is individual.
64"Aliaksandr"
Beneficiary last name. Required when entity_type is individual.
64"Lastname"