Currencytransfer icon

Currencytransfer

Easy and simple currency conversion

Actions19

Beneficiary → Update

AI-generated

Overview

This node updates an existing beneficiary record in the Currencytransfer system. It is useful for scenarios where you need to modify beneficiary details such as name, bank account information, address, or contact details. For example, updating a beneficiary's bank account number or changing their nickname for easier identification.

Use Case Examples

  1. Updating a beneficiary's bank account details after they change banks.
  2. Modifying the beneficiary's address or contact information to keep records current.

Properties

Name Meaning
UUID Unique identifier of the beneficiary resource to update.
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 the beneficiary is an individual.
Last name Last name of the beneficiary, required if the beneficiary is an individual.
Company name Name of the company, required if the beneficiary is a company.
Currency 3-letter ISO 4217 currency code associated with the beneficiary.
Bank account country 2-letter ISO 3166-1 country code of the bank account.
Email Email address to notify when money is dispatched to this bank account.
Account Number Bank account number; required in combination with other bank details depending on currency and country.
Sort code Bank sort code; part of bank account details.
IBAN International Bank Account Number; part of bank account details.
BIC/SWIFT Bank Identifier Code or SWIFT code; part of bank account details.
ABA American Bankers Association routing number; part of bank account details.
BSB Bank State Branch number; part of bank account details.
Routing Number Routing number for the bank account; part of bank account details.
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 code (2-letter ISO 3166-1).
City Beneficiary city address.
State Beneficiary state address.
Postal Code Beneficiary postal code.
Address line 1 First line of beneficiary address.
Address line 2 Second line of beneficiary address.
Request Options Additional request options such as batching, SSL handling, proxy, and timeout settings.

Output

JSON

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

Dependencies

  • An API key credential for Currencytransfer API authentication

Troubleshooting

  • Common issues include missing required fields such as UUID or beneficiary type, or providing invalid bank account details inconsistent with currency and country requirements.
  • Errors may occur if the nickname is not unique per currency or if required fields for specific countries and currencies are omitted.
  • SSL certificate validation errors can be resolved by enabling the 'Ignore SSL Issues' option if appropriate.
  • Timeout errors can be mitigated by increasing the timeout setting in request options.

Discussion