Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Cards → Issue Card

AI-generated

Overview

This node operation, Issue Card, allows users to create and issue a new payment card linked to a specific account and fund account. It supports both physical and virtual cards, with configurable monthly spending limits and ATM usage permissions. This is useful in financial platforms or expense management systems where issuing controlled payment cards to users (cardholders) is required.

Practical examples:

  • A company issues physical debit cards to employees for business expenses.
  • A fintech app creates virtual cards for online purchases with preset spending limits.
  • An organization controls ATM access on issued cards by toggling the ATM permission.

Properties

Name Meaning
Account Id Identifier of the account to which the card will be linked.
User Id Unique identifier of the cardholder who will receive the card.
Fund Account Id Unique identifier of the fund account that backs the card's spending.
Limit Recurring monthly spending limit set on the card.
Is Physical Boolean flag indicating if the card is physical (true) or virtual (false).
Is Atm Allowed Boolean flag indicating if the card can be used at ATMs.
Name Optional name for the card, useful for differentiating multiple cards.
Delivery Address JSON object representing the delivery address for the physical card (if applicable).

Output

The node outputs JSON data representing the newly issued card details as returned from the API. This typically includes card identifiers, status, limits, type (physical/virtual), and other metadata related to the issued card.

If the card is physical, the output may also include delivery information. The node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating requests to the external card issuing service.
  • The node uses a base URL configured in credentials/environment variables to connect to the card issuing API.
  • The node depends on the external API described in the bundled OpenAPI specification (payhawk.api.json).

Troubleshooting

  • Missing required fields: Ensure all required properties (Account Id, User Id, Fund Account Id, Limit, Is Physical, Is Atm Allowed) are provided; otherwise, the API call will fail.
  • Invalid JSON in Delivery Address: If providing a delivery address, ensure it is valid JSON; parsing errors will cause failures.
  • API authentication errors: Verify that the API key credential is correctly configured and has necessary permissions.
  • Limit value issues: The monthly limit should be a positive number; invalid values might be rejected by the API.
  • Network or connectivity problems: Check network access to the API endpoint and correct base URL configuration.

Links and References

  • OpenAPI Specification (referenced internally as payhawk.api.json)
  • General concepts of card issuing and management APIs (varies by provider)
  • n8n documentation on creating custom nodes and using credentials

Discussion