To make a fund transfer or payment, add the counterparty that you intend to transact with.
Depending on whether a counterparty has a Revolut account and which country a counterparty account is based on, the fields that you need to specify are different.
If you are on a freelancer account, to be compliant with PSD2 Strong Customer Authentication regulations, you must manually approve the counterparty with two-factor authentication in the Revolut Business portal before you can make a payment.
This can ensure maximum security in case of access token leakages and other fraudulent activities.
It is recommended to utilize all available address fields when creating a counterparty and accurately define either the individual_name
or company_name
field for individuals and companies respectively. This significantly reduces the risk of any disruption to payments made via API.
Add a Revolut user as counterparty:
curl -X POST https://b2b.revolut.com/api/1.0/counterparty \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <your access token>' \
-d '{
"profile_type": "personal",
"name": "John Smith",
"phone": "+4412345678900"
}'
Response:
{
"id": "830e79d9-7b0a-45d3-a2a3-c0b291be3bf7",
"name": "John Smith",
"phone": "+4412345678900",
"profile_type": "personal",
"country": "GB",
"state": "created",
"created_at": "2017-12-19T15:58:34.485Z",
"updated_at": "2017-12-19T15:58:34.485Z"
}
If a counterparty has a Revolut account, you only need to provide the phone number and name. Optionally, you can provide full account details, however, it is not required.
Add a UK bank account as counterparty:
curl -X POST https://b2b.revolut.com/api/1.0/counterparty \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <your access token>' \
-d '{
"company_name": "John Smith Co.",
"bank_country": "GB",
"currency": "GBP",
"account_no": "12345678",
"sort_code": "223344",
"email": "john@smith.co",
"phone": "+447771234455",
"address": {
"street_line1": "1 Canada Square",
"street_line2": "Canary Wharf",
"region": "East End",
"postcode": "E115AB",
"city": "London",
"country": "GB"
}
}'
Response:
{
"id": "97380d65-0478-4673-9e79-21918b4ae93a",
"company_name": "Acme Corp.",
"state": "created",
"created_at": "2017-12-19T16:17:05.141Z",
"updated_at": "2017-12-19T16:17:05.141Z",
"accounts": [
{
"id": "4e32d331-68aa-4e4b-a295-3e3d7625819b",
"currency": "GBP",
"type": "external",
"account_no": "12345678",
"sort_code": "223344",
"email": "acm@me.ccq",
"name": "Acme Corp.",
"bank_country": "GB",
"recipient_charges": "free"
}
]
}
If a counterparty doesn't have a Revolut account and has a UK account, the following details are required:
account_no
: The bank account number of the counterparty.sort_code
: The sort code of the counterparty's account.address
: The address of the counterparty.Add an IBAN bank account as counterparty:
curl -X POST https://b2b.revolut.com/api/1.0/counterparty \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <your access token>' \
-d '{
"company_name": "John Smith Co.",
"bank_country": "FR",
"currency": "EUR",
"iban": "FR1420041010050500013M02606",
"bic": "PSSTFRPPLIL",
"email": "john@smith.co",
"phone": "+447771234455",
"address": {
"street_line1": "20 Central Paris",
"street_line2": "Champ de Mars",
"region": "Paris",
"postcode": "75007",
"city": "Paris",
"country": "FR"
}
}'
Response:
{
"id": "97380d65-0478-4673-9e79-21918b4ae93a",
"company_name": "John Smith Co.",
"state": "created",
"created_at": "2017-12-19T16:17:05.141Z",
"updated_at": "2017-12-19T16:17:05.141Z",
"accounts": [
{
"id": "4e32d331-68aa-4e4b-a295-3e3d7625819b",
"currency": "EUR",
"type": "external",
"iban": "FR1420041010050500013M02606",
"bic": "PSSTFRPPLIL",
"email": "john@smith.co",
"name": "John Smith Co..",
"bank_country": "FR",
"recipient_charges": "free"
}
]
}
If a counterparty doesn't have a Revolut account and has a non-UK bank account, depending on the country that the account is based in, you must specify the required fields.
See the example of an IBAN request on the right.
Check the following tables about the different fields required depending on the country:
Field | Description | Required | Format |
---|---|---|---|
account_no | bank account number | Yes | Text |
routing_number | routing transit number | Yes | Text |
Field | Description | Required | Format |
---|---|---|---|
iban | IBAN | Yes | Text |
bic | BIC | Yes | Text |
Field | Description | Required | Format |
---|---|---|---|
account_no | bank account number | Yes | Text |
bic | BIC | Yes | Text |
Field | Description | Required | Format |
---|---|---|---|
clabe | CLABE | Yes | Text |
bic | bank BIC | Yes | Text |
Field | Description | Format |
---|---|---|
account_no | bank account number | Text |
ifsc | IFSC | Text |
Field | Description | Format |
---|---|---|
account_no | bank account number | Text |
bsb_code | BSB | Text |