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.
  • Integrating with accounting software to reflect the payment status of expenses in real-time.
  • Streamlining bookkeeping by marking expenses as paid when payment data is received from a banking API.

Properties

Name Meaning
Account Id Identifier of the account related to the expense.
Expense Id Identifier of the expense to update with payment details.
Date Date of the payment (required).
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, payment date, reference, and bank account information.

If binary data were involved (e.g., receipts), it would be summarized here, but this operation focuses on JSON updates only.

Dependencies

  • Requires an API key credential for authenticating requests to the external expense management or banking API.
  • The node uses a base URL configured in credentials to send HTTP requests.
  • Depends on the external service's API supporting updating expenses with payment details and changing their status.

Troubleshooting

  • Missing Required Fields: Ensure all required properties (Account Id, Expense Id, and Date) are provided; otherwise, the API call will fail.
  • Invalid Identifiers: Using incorrect or non-existent account or expense IDs will result in errors indicating resource not found.
  • Authentication Errors: Verify that the API key or authentication token is correctly set up in the node credentials.
  • API Endpoint Issues: Confirm the base URL and endpoint paths are correct and accessible.
  • Date Format: The payment date should be in a valid format accepted by the API; invalid formats may cause request rejection.

Links and References

Discussion