Create a counterparty
Create a new counterparty to transact with.
Revtags in Sandbox
In the Sandbox environment, you cannot add real people and businesses as Revolut counterparties.
To help you simulate adding counterparties using Revtag, we created some test accounts of profile type personal that you can use.
Test accounts for Sandbox
To add a counterparty via Revtag, use one of these pairs for the name and revtag fields respectively:
Test User 1&john1pvkiTest User 2&john2pvki- ...
Test User 9&john9pvki
Address field recommendations
Some payment rails may have stricter requirements regarding the address field – for example, by also requiring the region field.
This is why we recommend that you use all available address fields (including street_line1, region and city) when creating a counterparty.
This significantly reduces the risk of any disruption to payments made via the API.
Multiple counterparties with the same details
You cannot create multiple counterparties with the same Revtag. This restriction does not apply to other details. For example:
- Revtag: If you've already added
johnsmithas a Revolut counterparty, you can't add another counterparty with thejohnsmithRevtag. If you try to do so, you'll get an error. - Other details: If you've added John Smith as an individual UK counterparty using GBP with
sort_code=54-01-05andaccount_no=12345678, you can still use the same details to create another counterparty.
Counterparty name
When creating a counterparty, ensure that you use the correct field to define the counterparty's name.
| Counterparty type | Name field to use when added with: | |
|---|---|---|
| Revtag | Other details | |
| Individual | name (string) | individual_name (object with string subfields for first and last name) |
| Company | name (string) | company_name (string) |
For more information, see the guides: Create a counterparty.
Request
Counterparty to add
Response
Added counterparty