Guides • Manage Accounts
Create a counterparty

Create a counterparty

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.

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 portal 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.

Add a Revolut counterparty​

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 counterparty​

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 international 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:

Fields for US USD accounts​

FieldDescriptionRequiredFormat
account_nobank account numberYesText
routing_numberrouting transit numberYesText

Fields for IBAN countries​

FieldDescriptionRequiredFormat
ibanIBANYesText
bicBICYesText

Fields for SWIFT​

FieldDescriptionRequiredFormat
account_nobank account numberYesText
bicBICYesText

Fields for SWIFT MX​

FieldDescriptionRequiredFormat
clabeCLABEYesText
bicbank BICYesText

Fields for IN INR accounts​

FieldDescriptionFormat
account_nobank account numberText
ifscIFSCText

Fields for AU AUD accounts​

FieldDescriptionFormat
account_nobank account numberText
bsb_codeBSBText
Previous3. Make your first API request
NextRetrieve counterparties
Was this page helpful?