Currencytransfer icon

Currencytransfer

Easy and simple currency conversion

Actions19

Beneficiary → Create

AI-generated

Overview

This node operation allows users to create a beneficiary record in the Currencytransfer system. It supports creating beneficiaries who can be either individuals or companies, with detailed bank account and address information. This operation is useful for automating the addition of new beneficiaries for currency transfers, enabling streamlined payment processes to various bank accounts worldwide.

Use Case Examples

  1. Creating a new individual beneficiary with personal and bank details for sending payments.
  2. Adding a company beneficiary with company name and bank account information for business transactions.

Properties

Name Meaning
Currency Filter Filter by currency to narrow down beneficiary selection.
Type Specifies whether the beneficiary is an individual or a company.
Nickname An easy-to-remember alias for the beneficiary record, unique per currency.
First name First name of the beneficiary, required if type is individual.
Last name Last name of the beneficiary, required if type is individual.
Company name Name of the company, required if type is company.
Currency 3-letter ISO 4217 currency code for the beneficiary.
Bank account country 2-letter ISO 3166-1 country code of the bank account.
Email Email to notify when money is dispatched to this bank account.
Account Number Bank account number, part of bank account details required depending on currency and country.
Sort code Bank sort code, part of bank account details required depending on currency and country.
IBAN International Bank Account Number, part of bank account details required depending on currency and country.
BIC/SWIFT Bank Identifier Code or SWIFT code, part of bank account details required depending on currency and country.
ABA American Bankers Association number, part of bank account details required depending on currency and country.
BSB Bank State Branch number, part of bank account details required depending on currency and country.
Routing Number Routing number, part of bank account details required depending on currency and country.
CNAPS Required if bank account country is China (CN) and currency is CNY.
Bank Branch Number Required for some currency and bank account country combinations.
CPF/CNPJ Required for some currency and bank account country combinations.
Telephone Number Required if bank account country is Brazil (BR) and currency is BRL.
Bank Code Required for some currency and bank account country combinations.
Account Type Required for some currency and bank account country combinations.
Country Beneficiary address country, 2-letter ISO 3166-1 code.
City Beneficiary address city.
State Beneficiary address state.
Postal Code Beneficiary address postal code.
Address line 1 First line of beneficiary address.
Address line 2 Second line of beneficiary address.
Request Options Settings for request behavior such as batching, SSL handling, proxy, and timeout.

Output

JSON

  • id - Unique identifier of the created beneficiary.
  • nickname - Alias of the beneficiary.
  • beneficiaryType - Type of beneficiary, individual or company.
  • firstName - First name if individual.
  • lastName - Last name if individual.
  • companyName - Company name if company.
  • currency - Currency code associated with the beneficiary.
  • bankAccountCountry - Country code of the bank account.
  • email - Notification email for the beneficiary.
  • accountNumber - Bank account number.
  • sortCode - Bank sort code.
  • iban - IBAN number.
  • bicSwift - BIC or SWIFT code.
  • aba - ABA number.
  • bsb - BSB number.
  • routingNumber - Routing number.
  • cnaps - CNAPS code for China.
  • bankBranchNumber - Bank branch number.
  • cpfCnpj - CPF or CNPJ number.
  • telephone - Telephone number for Brazil.
  • bankCode - Bank code.
  • accountType - Account type.
  • country - Beneficiary address country.
  • city - Beneficiary address city.
  • beneficiaryState - Beneficiary address state.
  • postalCode - Beneficiary address postal code.
  • line1 - Beneficiary address line 1.
  • line2 - Beneficiary address line 2.

Dependencies

  • An API key credential for Currencytransfer API authentication

Troubleshooting

  • Common issues include missing required fields depending on beneficiary type (individual or company) and bank account country/currency combinations.
  • Errors may occur if the bank account details do not match the required format for the specified currency and country.
  • Timeouts or SSL errors can happen if network settings like proxy or SSL validation are misconfigured; adjusting request options can help resolve these.

Discussion