Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Overview

This node operation retrieves deposit records associated with a specific fund account. It is useful for financial workflows where you need to track or analyze deposits made into fund accounts, such as reconciliation processes, reporting, or auditing transactions.

For example, you might use this node to:

  • Fetch all deposits made to a particular fund account within a date range.
  • Retrieve a paginated list of deposits for review or export.
  • Apply complex filters to find deposits matching certain criteria (e.g., amount thresholds, dates).

Properties

Name Meaning
Account Id Identifier of the account to which the fund account belongs.
Fund Account Id Identifier of the specific fund account whose deposits are being retrieved.
Filter JSON-stringified and URL-encoded filter expression object that conforms to a deposit filter schema. Used to specify conditions like date ranges or other deposit attributes.
Skip Number of deposit records to skip from the beginning of the result set (for pagination).
Take Maximum number of deposit records to return (for pagination).

Output

The output contains a JSON array of deposit objects corresponding to the specified fund account and filter criteria. Each deposit object includes details such as deposit date, amount, and any other relevant metadata defined by the API.

If binary data were involved (e.g., attachments), it would be summarized here, but this operation focuses on JSON data representing deposits.

Dependencies

  • Requires an API key credential or similar authentication token configured in n8n to access the external service managing fund accounts and deposits.
  • The node uses HTTP requests to interact with the external API endpoint for fund account deposits.
  • Proper base URL configuration for the API is necessary in the credentials.

Troubleshooting

  • Missing or invalid Account Id / Fund Account Id: Ensure these identifiers are correctly provided; otherwise, the API will return errors or empty results.
  • Malformed Filter JSON: The filter property must be a valid JSON string conforming to the expected schema. Invalid JSON or incorrect filter structure can cause request failures.
  • Pagination issues: Setting Skip or Take incorrectly may lead to unexpected results or no data returned.
  • Authentication errors: Verify that the API key or authentication token is valid and has sufficient permissions to read fund account deposits.
  • API rate limits or connectivity problems: Network issues or API throttling can cause errors; check logs and retry policies.

Links and References

  • Refer to the external API documentation for the fund accounts and deposits endpoints to understand filter schema and response structure.
  • n8n documentation on using HTTP Request nodes and handling pagination may provide additional context for advanced usage.

Discussion