A2A icon

A2A

A2A (Account to Account) transfers, account management, and Agent2Agent protocol communication

Overview

This node enables performing Account-to-Account (A2A) transfers within a financial system. Specifically, the Transfer - Create operation allows users to initiate a transfer of funds from one account to another. This is useful in scenarios such as automating payments between internal company accounts, moving funds between different currency wallets, or integrating with financial platforms that support A2A transfers.

For example, a business could use this node to automatically transfer a specified amount of money from their main operating account to a savings account on a scheduled basis, or to move funds between accounts denominated in different currencies.

Properties

Name Meaning
Amount The numeric amount of money to transfer. Supports two decimal places for precision.
Currency The currency code for the transfer. Options: USD, EUR, GBP, BRL.
From Account ID The unique identifier of the source account from which funds will be withdrawn.
To Account ID The unique identifier of the destination account where funds will be deposited.
Reference An optional reference string to label or identify the transfer transaction.
Description An optional descriptive text providing additional details about the transfer.

Output

The output JSON contains the response from the API after creating the transfer. It typically includes details such as:

  • Transfer identifiers
  • Status of the transfer
  • Amount and currency
  • Source and destination account IDs
  • Any references or descriptions provided

This output can be used downstream in workflows to track transfer status, log transactions, or trigger further actions based on the transfer result.

The node does not output binary data for this operation.

Dependencies

  • Requires an API key credential and secret configured in n8n to authenticate requests.
  • Connects to an external A2A API endpoint defined by the base URL in credentials.
  • Uses HTTP POST requests to the /transfers endpoint of the API.

Troubleshooting

  • Common issues:

    • Invalid or missing account IDs may cause the API to reject the transfer request.
    • Insufficient funds in the source account will likely result in a failed transfer.
    • Incorrect currency codes or unsupported currencies will cause errors.
    • Network or authentication failures if API keys or secrets are misconfigured.
  • Error messages:

    • Errors returned from the API will be included in the node’s output if "Continue On Fail" is enabled.
    • Typical error messages might include "Unauthorized", "Account not found", "Insufficient balance", or "Invalid currency".
  • Resolution tips:

    • Verify all required fields are correctly filled.
    • Ensure API credentials are valid and have necessary permissions.
    • Check account balances before initiating transfers.
    • Confirm currency codes match supported options.

Links and References

  • No direct external links are provided in the source code.
  • For more information, consult the documentation of the external A2A API service you connect to via this node.

Discussion