finance
Adyen CLI for Coding Agents
Use the Adyen CLI for coding agents with headless JSON commands, schema discovery, credentials, and permission controls.
8 functions 5 read 3 write API key auth
Adyen CLI for Coding Agents
Let coding agents discover schemas and execute integration functions through CLI commands or MCP.
Use this pattern when another coding agent needs exact commands and schema discovery. 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 Coding Agents
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.