Create a multi payment instruction
curl --request POST \
--url https://{environment}.ebury.io/multipayments \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
[
{
"account_number": 9999999999,
"bank_address": "1 Test Street",
"bank_code": 999999,
"bank_country": "N",
"bank_name": "Test Bank 1",
"beneficiary_address": "2 Test Street",
"beneficiary_country": "NZ",
"beneficiary_name": "Functional Test New Zealand",
"beneficiary_reference": "Beneficiary bank",
"direction": "buy",
"iban": null,
"inn": null,
"kio": null,
"payment_amount": 110.01,
"payment_currency": "NZD",
"payment_reference": "MULTIPAYMENTSTEST",
"purpose_of_payment": null,
"reason_for_trade": "Execute payments",
"russian_central_bank_account": null,
"swift_code": "TESTNZ99",
"trade_type": "spot",
"value_date": "2016-04-18T00:00:00.000Z",
"vo": null
},
{
"account_number": null,
"bank_address": "1 Test Street",
"bank_code": null,
"bank_country": "ES,",
"bank_name": "Test Bank 2",
"beneficiary_address": "2 Test Street",
"beneficiary_country": "GB",
"beneficiary_name": "Test beneficiary",
"beneficiary_reference": null,
"direction": "buy",
"iban": "ES6710067038260971665568",
"inn": null,
"kio": null,
"payment_amount": 32.02,
"payment_currency": "EUR",
"payment_reference": "MULTIPAYMENTSTEST",
"purpose_of_payment": null,
"reason_for_trade": "Execute payments",
"russian_central_bank_account": null,
"swift_code": "TESTES99",
"trade_type": "spot",
"value_date": "2016-04-18T00:00:00.000Z",
"vo": null
}
]
'import requests
url = "https://{environment}.ebury.io/multipayments"
payload = [
{
"account_number": 9999999999,
"bank_address": "1 Test Street",
"bank_code": 999999,
"bank_country": "N",
"bank_name": "Test Bank 1",
"beneficiary_address": "2 Test Street",
"beneficiary_country": "NZ",
"beneficiary_name": "Functional Test New Zealand",
"beneficiary_reference": "Beneficiary bank",
"direction": "buy",
"iban": None,
"inn": None,
"kio": None,
"payment_amount": 110.01,
"payment_currency": "NZD",
"payment_reference": "MULTIPAYMENTSTEST",
"purpose_of_payment": None,
"reason_for_trade": "Execute payments",
"russian_central_bank_account": None,
"swift_code": "TESTNZ99",
"trade_type": "spot",
"value_date": "2016-04-18T00:00:00.000Z",
"vo": None
},
{
"account_number": None,
"bank_address": "1 Test Street",
"bank_code": None,
"bank_country": "ES,",
"bank_name": "Test Bank 2",
"beneficiary_address": "2 Test Street",
"beneficiary_country": "GB",
"beneficiary_name": "Test beneficiary",
"beneficiary_reference": None,
"direction": "buy",
"iban": "ES6710067038260971665568",
"inn": None,
"kio": None,
"payment_amount": 32.02,
"payment_currency": "EUR",
"payment_reference": "MULTIPAYMENTSTEST",
"purpose_of_payment": None,
"reason_for_trade": "Execute payments",
"russian_central_bank_account": None,
"swift_code": "TESTES99",
"trade_type": "spot",
"value_date": "2016-04-18T00:00:00.000Z",
"vo": None
}
]
headers = {
"Authorization": "<authorization>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: '<authorization>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify([
{
account_number: 9999999999,
bank_address: '1 Test Street',
bank_code: 999999,
bank_country: 'N',
bank_name: 'Test Bank 1',
beneficiary_address: '2 Test Street',
beneficiary_country: 'NZ',
beneficiary_name: 'Functional Test New Zealand',
beneficiary_reference: 'Beneficiary bank',
direction: 'buy',
iban: null,
inn: null,
kio: null,
payment_amount: 110.01,
payment_currency: 'NZD',
payment_reference: 'MULTIPAYMENTSTEST',
purpose_of_payment: null,
reason_for_trade: 'Execute payments',
russian_central_bank_account: null,
swift_code: 'TESTNZ99',
trade_type: 'spot',
value_date: '2016-04-18T00:00:00.000Z',
vo: null
},
{
account_number: null,
bank_address: '1 Test Street',
bank_code: null,
bank_country: 'ES,',
bank_name: 'Test Bank 2',
beneficiary_address: '2 Test Street',
beneficiary_country: 'GB',
beneficiary_name: 'Test beneficiary',
beneficiary_reference: null,
direction: 'buy',
iban: 'ES6710067038260971665568',
inn: null,
kio: null,
payment_amount: 32.02,
payment_currency: 'EUR',
payment_reference: 'MULTIPAYMENTSTEST',
purpose_of_payment: null,
reason_for_trade: 'Execute payments',
russian_central_bank_account: null,
swift_code: 'TESTES99',
trade_type: 'spot',
value_date: '2016-04-18T00:00:00.000Z',
vo: null
}
])
};
fetch('https://{environment}.ebury.io/multipayments', 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://{environment}.ebury.io/multipayments",
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([
[
'account_number' => 9999999999,
'bank_address' => '1 Test Street',
'bank_code' => 999999,
'bank_country' => 'N',
'bank_name' => 'Test Bank 1',
'beneficiary_address' => '2 Test Street',
'beneficiary_country' => 'NZ',
'beneficiary_name' => 'Functional Test New Zealand',
'beneficiary_reference' => 'Beneficiary bank',
'direction' => 'buy',
'iban' => null,
'inn' => null,
'kio' => null,
'payment_amount' => 110.01,
'payment_currency' => 'NZD',
'payment_reference' => 'MULTIPAYMENTSTEST',
'purpose_of_payment' => null,
'reason_for_trade' => 'Execute payments',
'russian_central_bank_account' => null,
'swift_code' => 'TESTNZ99',
'trade_type' => 'spot',
'value_date' => '2016-04-18T00:00:00.000Z',
'vo' => null
],
[
'account_number' => null,
'bank_address' => '1 Test Street',
'bank_code' => null,
'bank_country' => 'ES,',
'bank_name' => 'Test Bank 2',
'beneficiary_address' => '2 Test Street',
'beneficiary_country' => 'GB',
'beneficiary_name' => 'Test beneficiary',
'beneficiary_reference' => null,
'direction' => 'buy',
'iban' => 'ES6710067038260971665568',
'inn' => null,
'kio' => null,
'payment_amount' => 32.02,
'payment_currency' => 'EUR',
'payment_reference' => 'MULTIPAYMENTSTEST',
'purpose_of_payment' => null,
'reason_for_trade' => 'Execute payments',
'russian_central_bank_account' => null,
'swift_code' => 'TESTES99',
'trade_type' => 'spot',
'value_date' => '2016-04-18T00:00:00.000Z',
'vo' => null
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$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://{environment}.ebury.io/multipayments"
payload := strings.NewReader("[\n {\n \"account_number\": 9999999999,\n \"bank_address\": \"1 Test Street\",\n \"bank_code\": 999999,\n \"bank_country\": \"N\",\n \"bank_name\": \"Test Bank 1\",\n \"beneficiary_address\": \"2 Test Street\",\n \"beneficiary_country\": \"NZ\",\n \"beneficiary_name\": \"Functional Test New Zealand\",\n \"beneficiary_reference\": \"Beneficiary bank\",\n \"direction\": \"buy\",\n \"iban\": null,\n \"inn\": null,\n \"kio\": null,\n \"payment_amount\": 110.01,\n \"payment_currency\": \"NZD\",\n \"payment_reference\": \"MULTIPAYMENTSTEST\",\n \"purpose_of_payment\": null,\n \"reason_for_trade\": \"Execute payments\",\n \"russian_central_bank_account\": null,\n \"swift_code\": \"TESTNZ99\",\n \"trade_type\": \"spot\",\n \"value_date\": \"2016-04-18T00:00:00.000Z\",\n \"vo\": null\n },\n {\n \"account_number\": null,\n \"bank_address\": \"1 Test Street\",\n \"bank_code\": null,\n \"bank_country\": \"ES,\",\n \"bank_name\": \"Test Bank 2\",\n \"beneficiary_address\": \"2 Test Street\",\n \"beneficiary_country\": \"GB\",\n \"beneficiary_name\": \"Test beneficiary\",\n \"beneficiary_reference\": null,\n \"direction\": \"buy\",\n \"iban\": \"ES6710067038260971665568\",\n \"inn\": null,\n \"kio\": null,\n \"payment_amount\": 32.02,\n \"payment_currency\": \"EUR\",\n \"payment_reference\": \"MULTIPAYMENTSTEST\",\n \"purpose_of_payment\": null,\n \"reason_for_trade\": \"Execute payments\",\n \"russian_central_bank_account\": null,\n \"swift_code\": \"TESTES99\",\n \"trade_type\": \"spot\",\n \"value_date\": \"2016-04-18T00:00:00.000Z\",\n \"vo\": null\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("x-api-key", "<api-key>")
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://{environment}.ebury.io/multipayments")
.header("Authorization", "<authorization>")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("[\n {\n \"account_number\": 9999999999,\n \"bank_address\": \"1 Test Street\",\n \"bank_code\": 999999,\n \"bank_country\": \"N\",\n \"bank_name\": \"Test Bank 1\",\n \"beneficiary_address\": \"2 Test Street\",\n \"beneficiary_country\": \"NZ\",\n \"beneficiary_name\": \"Functional Test New Zealand\",\n \"beneficiary_reference\": \"Beneficiary bank\",\n \"direction\": \"buy\",\n \"iban\": null,\n \"inn\": null,\n \"kio\": null,\n \"payment_amount\": 110.01,\n \"payment_currency\": \"NZD\",\n \"payment_reference\": \"MULTIPAYMENTSTEST\",\n \"purpose_of_payment\": null,\n \"reason_for_trade\": \"Execute payments\",\n \"russian_central_bank_account\": null,\n \"swift_code\": \"TESTNZ99\",\n \"trade_type\": \"spot\",\n \"value_date\": \"2016-04-18T00:00:00.000Z\",\n \"vo\": null\n },\n {\n \"account_number\": null,\n \"bank_address\": \"1 Test Street\",\n \"bank_code\": null,\n \"bank_country\": \"ES,\",\n \"bank_name\": \"Test Bank 2\",\n \"beneficiary_address\": \"2 Test Street\",\n \"beneficiary_country\": \"GB\",\n \"beneficiary_name\": \"Test beneficiary\",\n \"beneficiary_reference\": null,\n \"direction\": \"buy\",\n \"iban\": \"ES6710067038260971665568\",\n \"inn\": null,\n \"kio\": null,\n \"payment_amount\": 32.02,\n \"payment_currency\": \"EUR\",\n \"payment_reference\": \"MULTIPAYMENTSTEST\",\n \"purpose_of_payment\": null,\n \"reason_for_trade\": \"Execute payments\",\n \"russian_central_bank_account\": null,\n \"swift_code\": \"TESTES99\",\n \"trade_type\": \"spot\",\n \"value_date\": \"2016-04-18T00:00:00.000Z\",\n \"vo\": null\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://{environment}.ebury.io/multipayments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"account_number\": 9999999999,\n \"bank_address\": \"1 Test Street\",\n \"bank_code\": 999999,\n \"bank_country\": \"N\",\n \"bank_name\": \"Test Bank 1\",\n \"beneficiary_address\": \"2 Test Street\",\n \"beneficiary_country\": \"NZ\",\n \"beneficiary_name\": \"Functional Test New Zealand\",\n \"beneficiary_reference\": \"Beneficiary bank\",\n \"direction\": \"buy\",\n \"iban\": null,\n \"inn\": null,\n \"kio\": null,\n \"payment_amount\": 110.01,\n \"payment_currency\": \"NZD\",\n \"payment_reference\": \"MULTIPAYMENTSTEST\",\n \"purpose_of_payment\": null,\n \"reason_for_trade\": \"Execute payments\",\n \"russian_central_bank_account\": null,\n \"swift_code\": \"TESTNZ99\",\n \"trade_type\": \"spot\",\n \"value_date\": \"2016-04-18T00:00:00.000Z\",\n \"vo\": null\n },\n {\n \"account_number\": null,\n \"bank_address\": \"1 Test Street\",\n \"bank_code\": null,\n \"bank_country\": \"ES,\",\n \"bank_name\": \"Test Bank 2\",\n \"beneficiary_address\": \"2 Test Street\",\n \"beneficiary_country\": \"GB\",\n \"beneficiary_name\": \"Test beneficiary\",\n \"beneficiary_reference\": null,\n \"direction\": \"buy\",\n \"iban\": \"ES6710067038260971665568\",\n \"inn\": null,\n \"kio\": null,\n \"payment_amount\": 32.02,\n \"payment_currency\": \"EUR\",\n \"payment_reference\": \"MULTIPAYMENTSTEST\",\n \"purpose_of_payment\": null,\n \"reason_for_trade\": \"Execute payments\",\n \"russian_central_bank_account\": null,\n \"swift_code\": \"TESTES99\",\n \"trade_type\": \"spot\",\n \"value_date\": \"2016-04-18T00:00:00.000Z\",\n \"vo\": null\n }\n]"
response = http.request(request)
puts response.read_body{
"account_details": [
{
"account_number": 99999999,
"bank_identifier": 999999,
"bank_identifier_type": "SC UK Sort Code",
"iban": "GB82TEST9999999999999999",
"swift_code": "TESTGB99"
}
],
"multipayment_id": 1,
"trade_details": [
{
"buy_amount": 32,
"buy_currency": "EUR",
"client_rate": 0.814273,
"client_rate_symbol": "EURGBP",
"inverse_rate": 1.228089,
"inverse_rate_symbol": "GBPEUR",
"sell_amount": 26.06,
"sell_currency": "GBP",
"value_date": "2016-04-18T00:00:00.000Z"
},
{
"buy_amount": 110,
"buy_currency": "NZD",
"client_rate": 2.013132,
"client_rate_symbol": "GBPNZD",
"inverse_rate": 0.496738,
"inverse_rate_symbol": "NZDGBP",
"sell_amount": 54.64,
"sell_currency": "GBP",
"value_date": "2016-04-18T00:00:00.000Z"
}
]
}{
"account_details": [
{
"account_number": 99999999,
"bank_identifier": 999999,
"bank_identifier_type": "SC UK Sort Code",
"iban": "GB82TEST9999999999999999",
"swift_code": "TESTGB99"
}
],
"multipayment_id": 1,
"trade_details": [
{
"buy_amount": 32,
"buy_currency": "EUR",
"client_rate": 0.814273,
"client_rate_symbol": "EURGBP",
"inverse_rate": 1.228089,
"inverse_rate_symbol": "GBPEUR",
"sell_amount": 26.06,
"sell_currency": "GBP",
"value_date": "2016-04-18T00:00:00.000Z"
},
{
"buy_amount": 110,
"buy_currency": "NZD",
"client_rate": 2.013132,
"client_rate_symbol": "GBPNZD",
"inverse_rate": 0.496738,
"inverse_rate_symbol": "NZDGBP",
"sell_amount": 54.64,
"sell_currency": "GBP",
"value_date": "2016-04-18T00:00:00.000Z"
}
]
}{
"code": "<string>",
"details": "<string>",
"message": "<string>"
}{
"code": "<string>",
"details": "<string>",
"message": "<string>"
}[
"<unknown>"
]{
"code": "<string>",
"details": "<string>",
"message": "<string>"
}{
"code": "<string>",
"details": "<string>",
"message": "<string>"
}Executing Multipayments
Create a multi payment instruction
POST
/
multipayments
Create a multi payment instruction
curl --request POST \
--url https://{environment}.ebury.io/multipayments \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
[
{
"account_number": 9999999999,
"bank_address": "1 Test Street",
"bank_code": 999999,
"bank_country": "N",
"bank_name": "Test Bank 1",
"beneficiary_address": "2 Test Street",
"beneficiary_country": "NZ",
"beneficiary_name": "Functional Test New Zealand",
"beneficiary_reference": "Beneficiary bank",
"direction": "buy",
"iban": null,
"inn": null,
"kio": null,
"payment_amount": 110.01,
"payment_currency": "NZD",
"payment_reference": "MULTIPAYMENTSTEST",
"purpose_of_payment": null,
"reason_for_trade": "Execute payments",
"russian_central_bank_account": null,
"swift_code": "TESTNZ99",
"trade_type": "spot",
"value_date": "2016-04-18T00:00:00.000Z",
"vo": null
},
{
"account_number": null,
"bank_address": "1 Test Street",
"bank_code": null,
"bank_country": "ES,",
"bank_name": "Test Bank 2",
"beneficiary_address": "2 Test Street",
"beneficiary_country": "GB",
"beneficiary_name": "Test beneficiary",
"beneficiary_reference": null,
"direction": "buy",
"iban": "ES6710067038260971665568",
"inn": null,
"kio": null,
"payment_amount": 32.02,
"payment_currency": "EUR",
"payment_reference": "MULTIPAYMENTSTEST",
"purpose_of_payment": null,
"reason_for_trade": "Execute payments",
"russian_central_bank_account": null,
"swift_code": "TESTES99",
"trade_type": "spot",
"value_date": "2016-04-18T00:00:00.000Z",
"vo": null
}
]
'import requests
url = "https://{environment}.ebury.io/multipayments"
payload = [
{
"account_number": 9999999999,
"bank_address": "1 Test Street",
"bank_code": 999999,
"bank_country": "N",
"bank_name": "Test Bank 1",
"beneficiary_address": "2 Test Street",
"beneficiary_country": "NZ",
"beneficiary_name": "Functional Test New Zealand",
"beneficiary_reference": "Beneficiary bank",
"direction": "buy",
"iban": None,
"inn": None,
"kio": None,
"payment_amount": 110.01,
"payment_currency": "NZD",
"payment_reference": "MULTIPAYMENTSTEST",
"purpose_of_payment": None,
"reason_for_trade": "Execute payments",
"russian_central_bank_account": None,
"swift_code": "TESTNZ99",
"trade_type": "spot",
"value_date": "2016-04-18T00:00:00.000Z",
"vo": None
},
{
"account_number": None,
"bank_address": "1 Test Street",
"bank_code": None,
"bank_country": "ES,",
"bank_name": "Test Bank 2",
"beneficiary_address": "2 Test Street",
"beneficiary_country": "GB",
"beneficiary_name": "Test beneficiary",
"beneficiary_reference": None,
"direction": "buy",
"iban": "ES6710067038260971665568",
"inn": None,
"kio": None,
"payment_amount": 32.02,
"payment_currency": "EUR",
"payment_reference": "MULTIPAYMENTSTEST",
"purpose_of_payment": None,
"reason_for_trade": "Execute payments",
"russian_central_bank_account": None,
"swift_code": "TESTES99",
"trade_type": "spot",
"value_date": "2016-04-18T00:00:00.000Z",
"vo": None
}
]
headers = {
"Authorization": "<authorization>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: '<authorization>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify([
{
account_number: 9999999999,
bank_address: '1 Test Street',
bank_code: 999999,
bank_country: 'N',
bank_name: 'Test Bank 1',
beneficiary_address: '2 Test Street',
beneficiary_country: 'NZ',
beneficiary_name: 'Functional Test New Zealand',
beneficiary_reference: 'Beneficiary bank',
direction: 'buy',
iban: null,
inn: null,
kio: null,
payment_amount: 110.01,
payment_currency: 'NZD',
payment_reference: 'MULTIPAYMENTSTEST',
purpose_of_payment: null,
reason_for_trade: 'Execute payments',
russian_central_bank_account: null,
swift_code: 'TESTNZ99',
trade_type: 'spot',
value_date: '2016-04-18T00:00:00.000Z',
vo: null
},
{
account_number: null,
bank_address: '1 Test Street',
bank_code: null,
bank_country: 'ES,',
bank_name: 'Test Bank 2',
beneficiary_address: '2 Test Street',
beneficiary_country: 'GB',
beneficiary_name: 'Test beneficiary',
beneficiary_reference: null,
direction: 'buy',
iban: 'ES6710067038260971665568',
inn: null,
kio: null,
payment_amount: 32.02,
payment_currency: 'EUR',
payment_reference: 'MULTIPAYMENTSTEST',
purpose_of_payment: null,
reason_for_trade: 'Execute payments',
russian_central_bank_account: null,
swift_code: 'TESTES99',
trade_type: 'spot',
value_date: '2016-04-18T00:00:00.000Z',
vo: null
}
])
};
fetch('https://{environment}.ebury.io/multipayments', 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://{environment}.ebury.io/multipayments",
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([
[
'account_number' => 9999999999,
'bank_address' => '1 Test Street',
'bank_code' => 999999,
'bank_country' => 'N',
'bank_name' => 'Test Bank 1',
'beneficiary_address' => '2 Test Street',
'beneficiary_country' => 'NZ',
'beneficiary_name' => 'Functional Test New Zealand',
'beneficiary_reference' => 'Beneficiary bank',
'direction' => 'buy',
'iban' => null,
'inn' => null,
'kio' => null,
'payment_amount' => 110.01,
'payment_currency' => 'NZD',
'payment_reference' => 'MULTIPAYMENTSTEST',
'purpose_of_payment' => null,
'reason_for_trade' => 'Execute payments',
'russian_central_bank_account' => null,
'swift_code' => 'TESTNZ99',
'trade_type' => 'spot',
'value_date' => '2016-04-18T00:00:00.000Z',
'vo' => null
],
[
'account_number' => null,
'bank_address' => '1 Test Street',
'bank_code' => null,
'bank_country' => 'ES,',
'bank_name' => 'Test Bank 2',
'beneficiary_address' => '2 Test Street',
'beneficiary_country' => 'GB',
'beneficiary_name' => 'Test beneficiary',
'beneficiary_reference' => null,
'direction' => 'buy',
'iban' => 'ES6710067038260971665568',
'inn' => null,
'kio' => null,
'payment_amount' => 32.02,
'payment_currency' => 'EUR',
'payment_reference' => 'MULTIPAYMENTSTEST',
'purpose_of_payment' => null,
'reason_for_trade' => 'Execute payments',
'russian_central_bank_account' => null,
'swift_code' => 'TESTES99',
'trade_type' => 'spot',
'value_date' => '2016-04-18T00:00:00.000Z',
'vo' => null
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$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://{environment}.ebury.io/multipayments"
payload := strings.NewReader("[\n {\n \"account_number\": 9999999999,\n \"bank_address\": \"1 Test Street\",\n \"bank_code\": 999999,\n \"bank_country\": \"N\",\n \"bank_name\": \"Test Bank 1\",\n \"beneficiary_address\": \"2 Test Street\",\n \"beneficiary_country\": \"NZ\",\n \"beneficiary_name\": \"Functional Test New Zealand\",\n \"beneficiary_reference\": \"Beneficiary bank\",\n \"direction\": \"buy\",\n \"iban\": null,\n \"inn\": null,\n \"kio\": null,\n \"payment_amount\": 110.01,\n \"payment_currency\": \"NZD\",\n \"payment_reference\": \"MULTIPAYMENTSTEST\",\n \"purpose_of_payment\": null,\n \"reason_for_trade\": \"Execute payments\",\n \"russian_central_bank_account\": null,\n \"swift_code\": \"TESTNZ99\",\n \"trade_type\": \"spot\",\n \"value_date\": \"2016-04-18T00:00:00.000Z\",\n \"vo\": null\n },\n {\n \"account_number\": null,\n \"bank_address\": \"1 Test Street\",\n \"bank_code\": null,\n \"bank_country\": \"ES,\",\n \"bank_name\": \"Test Bank 2\",\n \"beneficiary_address\": \"2 Test Street\",\n \"beneficiary_country\": \"GB\",\n \"beneficiary_name\": \"Test beneficiary\",\n \"beneficiary_reference\": null,\n \"direction\": \"buy\",\n \"iban\": \"ES6710067038260971665568\",\n \"inn\": null,\n \"kio\": null,\n \"payment_amount\": 32.02,\n \"payment_currency\": \"EUR\",\n \"payment_reference\": \"MULTIPAYMENTSTEST\",\n \"purpose_of_payment\": null,\n \"reason_for_trade\": \"Execute payments\",\n \"russian_central_bank_account\": null,\n \"swift_code\": \"TESTES99\",\n \"trade_type\": \"spot\",\n \"value_date\": \"2016-04-18T00:00:00.000Z\",\n \"vo\": null\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("x-api-key", "<api-key>")
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://{environment}.ebury.io/multipayments")
.header("Authorization", "<authorization>")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("[\n {\n \"account_number\": 9999999999,\n \"bank_address\": \"1 Test Street\",\n \"bank_code\": 999999,\n \"bank_country\": \"N\",\n \"bank_name\": \"Test Bank 1\",\n \"beneficiary_address\": \"2 Test Street\",\n \"beneficiary_country\": \"NZ\",\n \"beneficiary_name\": \"Functional Test New Zealand\",\n \"beneficiary_reference\": \"Beneficiary bank\",\n \"direction\": \"buy\",\n \"iban\": null,\n \"inn\": null,\n \"kio\": null,\n \"payment_amount\": 110.01,\n \"payment_currency\": \"NZD\",\n \"payment_reference\": \"MULTIPAYMENTSTEST\",\n \"purpose_of_payment\": null,\n \"reason_for_trade\": \"Execute payments\",\n \"russian_central_bank_account\": null,\n \"swift_code\": \"TESTNZ99\",\n \"trade_type\": \"spot\",\n \"value_date\": \"2016-04-18T00:00:00.000Z\",\n \"vo\": null\n },\n {\n \"account_number\": null,\n \"bank_address\": \"1 Test Street\",\n \"bank_code\": null,\n \"bank_country\": \"ES,\",\n \"bank_name\": \"Test Bank 2\",\n \"beneficiary_address\": \"2 Test Street\",\n \"beneficiary_country\": \"GB\",\n \"beneficiary_name\": \"Test beneficiary\",\n \"beneficiary_reference\": null,\n \"direction\": \"buy\",\n \"iban\": \"ES6710067038260971665568\",\n \"inn\": null,\n \"kio\": null,\n \"payment_amount\": 32.02,\n \"payment_currency\": \"EUR\",\n \"payment_reference\": \"MULTIPAYMENTSTEST\",\n \"purpose_of_payment\": null,\n \"reason_for_trade\": \"Execute payments\",\n \"russian_central_bank_account\": null,\n \"swift_code\": \"TESTES99\",\n \"trade_type\": \"spot\",\n \"value_date\": \"2016-04-18T00:00:00.000Z\",\n \"vo\": null\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://{environment}.ebury.io/multipayments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"account_number\": 9999999999,\n \"bank_address\": \"1 Test Street\",\n \"bank_code\": 999999,\n \"bank_country\": \"N\",\n \"bank_name\": \"Test Bank 1\",\n \"beneficiary_address\": \"2 Test Street\",\n \"beneficiary_country\": \"NZ\",\n \"beneficiary_name\": \"Functional Test New Zealand\",\n \"beneficiary_reference\": \"Beneficiary bank\",\n \"direction\": \"buy\",\n \"iban\": null,\n \"inn\": null,\n \"kio\": null,\n \"payment_amount\": 110.01,\n \"payment_currency\": \"NZD\",\n \"payment_reference\": \"MULTIPAYMENTSTEST\",\n \"purpose_of_payment\": null,\n \"reason_for_trade\": \"Execute payments\",\n \"russian_central_bank_account\": null,\n \"swift_code\": \"TESTNZ99\",\n \"trade_type\": \"spot\",\n \"value_date\": \"2016-04-18T00:00:00.000Z\",\n \"vo\": null\n },\n {\n \"account_number\": null,\n \"bank_address\": \"1 Test Street\",\n \"bank_code\": null,\n \"bank_country\": \"ES,\",\n \"bank_name\": \"Test Bank 2\",\n \"beneficiary_address\": \"2 Test Street\",\n \"beneficiary_country\": \"GB\",\n \"beneficiary_name\": \"Test beneficiary\",\n \"beneficiary_reference\": null,\n \"direction\": \"buy\",\n \"iban\": \"ES6710067038260971665568\",\n \"inn\": null,\n \"kio\": null,\n \"payment_amount\": 32.02,\n \"payment_currency\": \"EUR\",\n \"payment_reference\": \"MULTIPAYMENTSTEST\",\n \"purpose_of_payment\": null,\n \"reason_for_trade\": \"Execute payments\",\n \"russian_central_bank_account\": null,\n \"swift_code\": \"TESTES99\",\n \"trade_type\": \"spot\",\n \"value_date\": \"2016-04-18T00:00:00.000Z\",\n \"vo\": null\n }\n]"
response = http.request(request)
puts response.read_body{
"account_details": [
{
"account_number": 99999999,
"bank_identifier": 999999,
"bank_identifier_type": "SC UK Sort Code",
"iban": "GB82TEST9999999999999999",
"swift_code": "TESTGB99"
}
],
"multipayment_id": 1,
"trade_details": [
{
"buy_amount": 32,
"buy_currency": "EUR",
"client_rate": 0.814273,
"client_rate_symbol": "EURGBP",
"inverse_rate": 1.228089,
"inverse_rate_symbol": "GBPEUR",
"sell_amount": 26.06,
"sell_currency": "GBP",
"value_date": "2016-04-18T00:00:00.000Z"
},
{
"buy_amount": 110,
"buy_currency": "NZD",
"client_rate": 2.013132,
"client_rate_symbol": "GBPNZD",
"inverse_rate": 0.496738,
"inverse_rate_symbol": "NZDGBP",
"sell_amount": 54.64,
"sell_currency": "GBP",
"value_date": "2016-04-18T00:00:00.000Z"
}
]
}{
"account_details": [
{
"account_number": 99999999,
"bank_identifier": 999999,
"bank_identifier_type": "SC UK Sort Code",
"iban": "GB82TEST9999999999999999",
"swift_code": "TESTGB99"
}
],
"multipayment_id": 1,
"trade_details": [
{
"buy_amount": 32,
"buy_currency": "EUR",
"client_rate": 0.814273,
"client_rate_symbol": "EURGBP",
"inverse_rate": 1.228089,
"inverse_rate_symbol": "GBPEUR",
"sell_amount": 26.06,
"sell_currency": "GBP",
"value_date": "2016-04-18T00:00:00.000Z"
},
{
"buy_amount": 110,
"buy_currency": "NZD",
"client_rate": 2.013132,
"client_rate_symbol": "GBPNZD",
"inverse_rate": 0.496738,
"inverse_rate_symbol": "NZDGBP",
"sell_amount": 54.64,
"sell_currency": "GBP",
"value_date": "2016-04-18T00:00:00.000Z"
}
]
}{
"code": "<string>",
"details": "<string>",
"message": "<string>"
}{
"code": "<string>",
"details": "<string>",
"message": "<string>"
}[
"<unknown>"
]{
"code": "<string>",
"details": "<string>",
"message": "<string>"
}{
"code": "<string>",
"details": "<string>",
"message": "<string>"
}Create a new multi payment instruction. Requires either a sell currency or existing trade ID to create the instruction
Authorizations
An API Key.
Query Parameters
The ID of the client
Trade ID to book payments against. Omit if trade should be executed to fund payments
If trade_id omitted, a sell currency must be supplied
Accept a partially successful instruction. If true, send successful instructions for payment. If false, reject the entire instruction
Set to true. Accept quote immediately, do not require confirmation
VoP authorization ID to confirm not full-match payment
Body
application/json
Request Payload
Destination account number
Destination bank address
Destination bank code
Destination bank country
Minimum string length:
1Destination bank name
Address of beneficiary
Name of beneficiary
Country of beneficiary
Type of payment, 'buy' or 'sell'
Available options:
buy, sell IBAN of the destination account
Destination currency
Minimum string length:
1Amount to be paid
Required range:
x >= 0Reason for trade
SWIFT code of destination bank
Type of trade. 'spot' is the only supported value at the moment
Available options:
spot Date when the transaction will be performed
Reference of payment
Reference of beneficiary
Text describing the purpose of the payment
Payment reference
The INN of the bank account
Pattern:
^[0-9]{10}([0-9]{2})?$The VO of the bank account
The KIO of the bank account
Russian central bank account
Example:
[
{
"account_number": 9999999999,
"bank_address": "1 Test Street",
"bank_code": 999999,
"bank_country": "N",
"bank_name": "Test Bank 1",
"beneficiary_address": "2 Test Street",
"beneficiary_country": "NZ",
"beneficiary_name": "Functional Test New Zealand",
"beneficiary_reference": "Beneficiary bank",
"direction": "buy",
"iban": null,
"inn": null,
"kio": null,
"payment_amount": 110.01,
"payment_currency": "NZD",
"payment_reference": "MULTIPAYMENTSTEST",
"purpose_of_payment": null,
"reason_for_trade": "Execute payments",
"russian_central_bank_account": null,
"swift_code": "TESTNZ99",
"trade_type": "spot",
"value_date": "2016-04-18T00:00:00.000Z",
"vo": null
},
{
"account_number": null,
"bank_address": "1 Test Street",
"bank_code": null,
"bank_country": "ES,",
"bank_name": "Test Bank 2",
"beneficiary_address": "2 Test Street",
"beneficiary_country": "GB",
"beneficiary_name": "Test beneficiary",
"beneficiary_reference": null,
"direction": "buy",
"iban": "ES6710067038260971665568",
"inn": null,
"kio": null,
"payment_amount": 32.02,
"payment_currency": "EUR",
"payment_reference": "MULTIPAYMENTSTEST",
"purpose_of_payment": null,
"reason_for_trade": "Execute payments",
"russian_central_bank_account": null,
"swift_code": "TESTES99",
"trade_type": "spot",
"value_date": "2016-04-18T00:00:00.000Z",
"vo": null
}
]