finance
Adyen CLI for Headless Automation
Use the Adyen CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
8 functions 5 read 3 write API key auth
Adyen CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Adyen CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Adyen CLI for Headless Automation
kosmokrator integrations:configure adyen --set api_key="$ADYEN_API_KEY" --set merchant_account="$ADYEN_MERCHANT_ACCOUNT" --enable --read allow --write ask --json
kosmo integrations:call adyen.adyen_capture_payment '{"psp_reference":"example_psp_reference","amount":"example_amount"}' --jsonDiscovery Before Execution
Agents and scripts can inspect Adyen docs and schemas before choosing a function.
kosmo integrations:docs adyen --json
kosmo integrations:docs adyen.adyen_capture_payment --json
kosmo integrations:schema adyen.adyen_capture_payment --json
kosmo integrations:search "Adyen" --json
kosmo integrations:list --jsonUseful Adyen CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
adyen.adyen_capture_payment | Write | psp_reference, amount | Capture a previously authorized Adyen payment. Requires the PSP reference of the original payment and the amount to capture (value in minor units + currency). The merchant account is automatically injected. |
adyen.adyen_get_current_merchant | Read | none | Get current merchant account information from Adyen. Verifies API connectivity and returns available payment methods for the merchant account. |
adyen.adyen_get_current_user | Read | none | Verify Adyen API connectivity and retrieve current merchant account information. Useful as a health check to confirm the integration is properly configured. |
adyen.adyen_get_transaction | Read | psp_reference | Get details of a specific Adyen transaction by its PSP reference. Returns the full transaction object including amount, status, and payment details. |
adyen.adyen_list_stores | Read | limit, page | List stores for the configured Adyen merchant account. Returns store details including store codes, names, and addresses. The merchant account is automatically injected. |
adyen.adyen_list_transactions | Read | page, size | List transactions from the Adyen transaction feed. Returns a paginated list of transactions for the merchant account. Use page and size parameters to control pagination. |
adyen.adyen_make_payment | Write | amount, payment_method, reference, return_url, shopper_reference, shopper_email | Initiate a payment through Adyen. Requires amount (value in minor units + currency) and payment method. The merchant account is automatically injected from the integration configuration. Returns the payment result including PSP reference. |
adyen.adyen_refund_payment | Write | psp_reference, amount | Refund an Adyen payment (full or partial). Requires the PSP reference of the original payment and the amount to refund (value in minor units + currency). The merchant account is automatically injected. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.