Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Overview

This node operation updates the status of a specific card within an account. It is useful in scenarios where you need to manage card lifecycle states such as activating a new card, blocking a compromised card, or closing a card that is no longer in use. For example, a financial service platform could use this node to programmatically block a card reported lost by a user or close a card after account termination.

Properties

Name Meaning
Account Id Identifier of the account to which the card belongs.
Card Id Identifier of the card whose status needs to be updated.
Status Requested card status. Possible values: Active, Blocked, Closed.

Output

The node outputs JSON data representing the result of the update operation. This typically includes confirmation of the card's updated status and may contain additional metadata about the card or the update request. The output does not include binary data.

Dependencies

  • Requires an API key credential for authentication with the external card management service.
  • The node expects a base URL configuration for the API endpoint.
  • The node uses standard HTTP headers for JSON content type and accepts JSON responses.

Troubleshooting

  • Common issues:
    • Invalid or missing Account Id or Card Id will cause the update to fail.
    • Providing an unsupported status value will result in an error.
    • Network or authentication errors if the API key or base URL is misconfigured.
  • Error messages:
    • "Card not found" indicates the specified Card Id does not exist under the given Account Id.
    • "Unauthorized" suggests invalid or missing API credentials.
    • "Invalid status value" means the status provided is not one of the allowed options (Active, Blocked, Closed).
  • Resolutions:
    • Verify that Account Id and Card Id are correct and exist.
    • Ensure the API key credential is valid and has necessary permissions.
    • Confirm the status value matches one of the allowed options exactly.

Links and References

  • No direct links available from the source code. Consult your card management API documentation for detailed information on card status management endpoints.

Discussion