Revolut - Create Counterparty

Description

This module allows creating a new counterparty (recipient) in Revolut Business. Counterparties can be Revolut accounts, SEPA accounts (IBAN), US accounts (ACH), or UK accounts (Sort Code).

Configuration

Field	Type	Required	Description
credentials_id	credential	Yes	Revolut credentials
profile_type	select	No	Type: business or personal
name	string	Conditional	Name (required if personal)
company_name	string	Conditional	Company name (required if business)
email	string	No	Contact email
phone	string	No	Phone (+34612345678)
revolut_account	boolean	No	Is Revolut account
iban	string	No	IBAN (SEPA accounts)
bic	string	No	BIC/SWIFT code
account_no	string	No	Account number
sort_code	string	No	Sort Code (UK)
routing_number	string	No	Routing Number (US)
currency	string	No	Currency (EUR, USD, GBP)
bank_country	string	No	Bank country
address_street	string	No	Address
address_city	string	No	City
address_postcode	string	No	Postal code
address_country	string	No	Country (ISO code)

Credentials

This module requires Revolut Business type credentials with the following fields:

Field	Description
access_token	Revolut Business API access token
sandbox	Sandbox mode for testing (true/false)

Output

{
  "success": true,
  "counterparty": { ... },
  "counterparty_id": "a1b2c3d4-...",
  "name": "Proveedor XYZ",
  "type": "business",
  "state": "created",
  "accounts": [
    {
      "id": "acc-123",
      "currency": "EUR",
      "type": "external"
    }
  ],
  "message": "Contraparte Proveedor XYZ creada (a1b2c3d4-...)"
}

Examples by Account Type

Revolut account (by email)

profile_type: "business"
company_name: "Partner Company"
email: "finance@partner.com"
revolut_account: true

SEPA account (IBAN)

profile_type: "business"
company_name: "Proveedor EU"
iban: "DE89370400440532013000"
bic: "COBADEFFXXX"
currency: "EUR"
bank_country: "DE"

US account (ACH)

profile_type: "business"
company_name: "US Vendor"
account_no: "123456789"
routing_number: "021000021"
currency: "USD"
bank_country: "US"

UK account (Sort Code)

profile_type: "personal"
name: "John Smith"
account_no: "12345678"
sort_code: "040004"
currency: "GBP"
bank_country: "GB"

Usage Example

{
  "credentials_id": "revolut_empresa",
  "profile_type": "business",
  "company_name": "Proveedor EU S.L.",
  "iban": "DE89370400440532013000",
  "bic": "COBADEFFXXX",
  "currency": "EUR",
  "bank_country": "DE"
}

API Used

• API: Revolut Business API
• Endpoint: POST /api/1.0/counterparty
• Documentation: https://developer.revolut.com/docs/business/counterparties

Notes

• Revolut counterparties allow free instant transfers
• For SEPA, only IBAN is required (BIC optional)
• For US, routing number and account number are required
• For UK, sort code and account number are required

Related Nodes

• RevolutCreatePayment: Create payments to the counterparty
• RevolutGetCounterparties: List existing counterparties
• RevolutSchedulePayment: Schedule payments to the counterparty