card_create
Create a new card; handles SCA by polling inline (default 30s) and falls back to a structured pending response for caller to complete authentication via session token.
Instructions
Create a new card. SCA: this operation may require Strong Customer Authentication; the tool polls inline by default (wait=30s) and falls back to a structured pending response so the caller can continue via sca_session_show + sca_session_token.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Maximum seconds (0-120) to poll inline for SCA approval before returning a structured pending response. Use false or 0 for a pure two-step flow (return immediately on SCA required). Default 30. | |
| holder_id | Yes | Cardholder membership ID | |
| atm_option | No | Enable ATM withdrawals | |
| card_level | Yes | Card level | |
| categories | No | Allowed merchant categories | |
| nfc_option | No | Enable contactless payments | |
| active_days | No | Active weekdays (1=Mon, 7=Sun) | |
| card_design | No | Card design identifier | |
| initiator_id | Yes | Order initiator membership ID | |
| online_option | No | Enable online payments | |
| type_of_print | No | Print type (Plus cards only) | |
| foreign_option | No | Enable international payments | |
| pre_expires_at | No | Flash card validity end (ISO 8601) | |
| atm_daily_limit | No | Daily ATM withdrawal limit (EUR) | |
| bank_account_id | Yes | Bank account ID | |
| organization_id | Yes | Organization ID | |
| ship_to_business | No | Ship card to organization address | |
| atm_monthly_limit | No | Monthly ATM withdrawal limit (EUR) | |
| sca_session_token | No | SCA session token from a prior call to bind a previously approved SCA challenge to this retry. When set, no polling occurs and the operation runs exactly once with the token attached. | |
| payment_daily_limit | No | Daily payment limit (EUR) | |
| payment_monthly_limit | No | Monthly payment limit (EUR) | |
| atm_daily_limit_option | No | Enable daily ATM limit | |
| payment_lifespan_limit | No | Total spending cap (flash cards, EUR) | |
| payment_transaction_limit | No | Per-transaction limit (EUR) | |
| payment_daily_limit_option | No | Enable daily payment limit | |
| payment_transaction_limit_option | No | Enable per-transaction limit |