Numi Bank Account icon

Numi Bank Account

Numi Bank Account Node
Join our community

Overview

The Numi Bank Account node allows you to retrieve bank account information associated with a user, identified by their phone number, from the Numi service. This node is useful in workflows where you need to fetch or filter payment methods (bank accounts) for a user, such as automating onboarding processes, verifying available payment options, or integrating with financial services.

Example scenarios:

  • Fetching all bank accounts linked to a user's phone number.
  • Retrieving details of a specific bank account by its name.
  • Integrating user payment method checks into automated approval or KYC flows.

Properties

Name Meaning
Operation The action to perform. Options:
• Get Bank Account – Get a Numi payment methods
User Phone Number User telephone number to obtain contacts. Required.
Bank AccountName Name Payment Method Name. Used to filter results by a specific bank account name (optional).

Output

The node outputs data in the following structure within the json field:

{
  "bankAccount": [
    // Array of bank account objects (structure depends on Numi API)
  ],
  "response_bankAccount": {
    "message": "..." // A string summarizing the bank account(s) found (names concatenated)
  }
}
  • If Bank AccountName Name is provided and set to "0", only the first bank account is returned.
  • If a specific name is provided, only the matching bank account is returned.
  • If left empty, all bank accounts for the user are returned, and their names are concatenated in the message.

Dependencies

  • External Service: Requires access to the Numi partner service via the PartnerServiceFactory.
  • Credentials: Needs a valid numiKeyApi credential configured in n8n.

Troubleshooting

Common issues:

  • Missing or invalid credentials: Ensure that the numiKeyApi credential is correctly set up in n8n.
  • User not found or no bank accounts: If the phone number does not correspond to a user or there are no linked bank accounts, the output array may be empty.
  • Incorrect Bank AccountName Name: If the specified name does not match any bank account, the result will contain null or an empty object.

Error messages:

  • Errors related to missing required fields (e.g., User Phone Number) will prevent execution.
  • API errors from the Numi service (such as authentication failures or network issues) will propagate as node errors.

Links and References

Discussion