Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Overview

This node operation allows you to add payment details to a specific bank expense and mark that expense as paid. It is useful in financial workflows where expenses need to be updated with payment information after the payment has been made, ensuring accurate tracking of paid expenses within an accounting or expense management system.

Practical examples include:

  • Automatically updating an expense record with payment confirmation details once a bank transfer is completed.
  • Marking expenses as paid in bulk after reconciliation with bank statements.
  • Integrating payment status updates into automated bookkeeping processes.

Properties

Name Meaning
Account Id Identifier of the account related to the expense.
Expense Id Identifier of the specific expense to update with payment details.
Date Date when the payment was made.
Payment Reference Reference text or code associated with the payment transaction.
Account Number Bank account IBAN or number from which the payment was made.

Output

The node outputs JSON data representing the updated expense object after adding the payment details and marking it as paid. This typically includes the expense's updated status and payment information fields reflecting the changes made by this operation.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the external service managing expenses (referred generically as "an API key credential").
  • The node uses a base URL configured in credentials to send HTTP requests.
  • The operation depends on the external expense management API to update expense records.

Troubleshooting

  • Common issues:
    • Invalid or missing Account Id or Expense Id can cause the update to fail.
    • Incorrect date format for the Date property may result in validation errors.
    • Network or authentication failures if the API key credential is not set up correctly.
  • Error messages:
    • "Expense not found" indicates the provided Expense Id does not exist; verify the ID.
    • "Unauthorized" or "Authentication failed" suggests issues with the API key credential.
    • "Invalid date format" means the Date property value does not meet expected formatting; use ISO 8601 format (e.g., YYYY-MM-DD).

Links and References

Discussion