Guides • Manage Accounts
Create a counterparty
doc

Create a counterparty

To make a fund transfer or payment, add the counterparty that you intend to transact with.

tip

You can also add a counterparty using a payout link. To do that, create the link and share it with the recipient. When claiming the payout, the recipient fills in their details, which you can then save as a counterparty.

Depending on which country a counterparty account is based in, the fields that you need to specify are different.

See the API reference: Create a counterparty

note

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 app before you can make a payment.
This can ensure maximum security in case of access token leakages and other fraudulent activities.

tip

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.

See also how to validate an account name (CoP) when adding a counterparty (UK only).

Add a UK counterparty

If a counterparty has a UK bank account, the following details are required:

FieldSubfields
(if applicable)
DescriptionFormatExample
account_noThe bank account number of the counterpartyText12345678
sort_codeThe sort code of the counterparty's accountText223344
address*The details of the counterparty's address

note
The address field is optional, however, if you do provide it, the address subfields specified here are required.
Object

{
"city":"London",
"street_line1":"20 Upping St",
"country":"GB",
"postcode":"SW1A 2AB"
}
cityText
street_line1
or
street_line2
Text
countryText
postcodeText
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",
"address": {
"city":"London",
"street_line1":"20 Upping St",
"country":"GB",
"postcode":"SW1A 2AB"
}
}'

To see more example requests and responses:

See the API reference: Create a counterparty

Add an international counterparty

If a counterparty has a non-UK bank account, depending on the country that the account is based in, you must specify the required fields.

See an example for an IBAN bank account.

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"
}'

To see more example requests and responses:

See the API reference: Create a counterparty

Add a Revolut counterparty

If a counterparty has a Revolut account, you can provide their Revtag and name.

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 Doe",
"revtag": "johndoe"
}'

To see more example requests and responses:

See the API reference: Create a counterparty

Alternatively, add a Revolut counterparty by providing their full details.

Required details depending on the country

Check the following tables for the different required fields depending on the country.

Fields for US USD accounts

FieldDescriptionFormatExample
account_noBank account numberText13719713158835300
routing_numberRouting transit numberText082000510
addressAddress detailsObjectExample

Fields for IBAN countries

FieldDescriptionFormatExample
ibanIBANTextFR1420041010050500013M02606
bic*BIC

*For SEPA transfers, it's optional.
TextPSSTFRPPLILBIC
address*Address details

*For eurozone countries when using EUR as the currency, it's optional.
ObjectExample

Fields for SWIFT

FieldDescriptionFormatExample
account_noBank account numberText1234567890
bicBICTextBOJPJPJT123
addressAddress detailsObjectExample

Fields for SWIFT MX

FieldDescriptionFormatExample
clabeCLABEText032180000118359719
bicBank BICTextBDEMMXMMXXX
addressAddress detailsObjectExample

Fields for IN INR accounts

FieldDescriptionFormatExample
account_noBank account numberText123456789
ifscIFSCTextSBIN0005943
addressAddress detailsObjectExample

Fields for AU AUD accounts

FieldDescriptionFormatExample
account_noBank account numberText011623852
bsb_codeBSBText007621
addressAddress detailsObjectExample

Test accounts for Sandbox

In the Sandbox environment, you cannot add real people and businesses as Revolut counterparties. To simulate Create a counterparty requests, use one of the test accounts.

Was this page helpful?