Can I use Adyen as a CLI?

Yes. KosmoKrator exposes a Adyen CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Adyen through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Adyen tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Adyen credentials stored?

Adyen credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Adyen MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

finance

Adyen CLI for AI Agents

Use the Adyen CLI from KosmoKrator to call Adyen tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

8 functions 5 read 3 write API key auth

Submit Adyen feedback View package source

Adyen CLI Setup

Adyen can be configured headlessly with `kosmokrator integrations:configure adyen`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure adyen --set api_key="$ADYEN_API_KEY" --set merchant_account="$ADYEN_MERCHANT_ACCOUNT" --enable --read allow --write ask --json
kosmokrator integrations:doctor adyen --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`api_key`	`ADYEN_API_KEY`	Secret `secret`	yes	API Key
`merchant_account`	`ADYEN_MERCHANT_ACCOUNT`	Text `text`	yes	Merchant Account
`url`	`ADYEN_URL`	URL `url`	no	API Base URL

Call Adyen Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call adyen.adyen_capture_payment '{
  "psp_reference": "example_psp_reference",
  "amount": "example_amount"
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:adyen adyen_capture_payment '{
  "psp_reference": "example_psp_reference",
  "amount": "example_amount"
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities 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 --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Adyen.

`adyen.adyen_capture_payment`

Write write

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.

Parameters: psp_reference, amount

Generic CLI call

kosmo integrations:call adyen.adyen_capture_payment '{"psp_reference":"example_psp_reference","amount":"example_amount"}' --json

Provider shortcut

kosmo integrations:adyen adyen_capture_payment '{"psp_reference":"example_psp_reference","amount":"example_amount"}' --json

`adyen.adyen_get_current_merchant`

Read read

Get current merchant account information from Adyen. Verifies API connectivity and returns available payment methods for the merchant account.

Parameters: none

Generic CLI call

kosmo integrations:call adyen.adyen_get_current_merchant '{}' --json

Provider shortcut

kosmo integrations:adyen adyen_get_current_merchant '{}' --json

`adyen.adyen_get_current_user`

Read read

Verify Adyen API connectivity and retrieve current merchant account information. Useful as a health check to confirm the integration is properly configured.

Parameters: none

Generic CLI call

kosmo integrations:call adyen.adyen_get_current_user '{}' --json

Provider shortcut

kosmo integrations:adyen adyen_get_current_user '{}' --json

`adyen.adyen_get_transaction`

Read read

Get details of a specific Adyen transaction by its PSP reference. Returns the full transaction object including amount, status, and payment details.

Parameters: psp_reference

Generic CLI call

kosmo integrations:call adyen.adyen_get_transaction '{"psp_reference":"example_psp_reference"}' --json

Provider shortcut

kosmo integrations:adyen adyen_get_transaction '{"psp_reference":"example_psp_reference"}' --json

`adyen.adyen_list_stores`

Read read

List stores for the configured Adyen merchant account. Returns store details including store codes, names, and addresses. The merchant account is automatically injected.

Parameters: limit, page

Generic CLI call

kosmo integrations:call adyen.adyen_list_stores '{"limit":1,"page":"example_page"}' --json

Provider shortcut

kosmo integrations:adyen adyen_list_stores '{"limit":1,"page":"example_page"}' --json

`adyen.adyen_list_transactions`

Read read

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.

Parameters: page, size

Generic CLI call

kosmo integrations:call adyen.adyen_list_transactions '{"page":1,"size":1}' --json

Provider shortcut

kosmo integrations:adyen adyen_list_transactions '{"page":1,"size":1}' --json

`adyen.adyen_make_payment`

Write write

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.

Parameters: amount, payment_method, reference, return_url, shopper_reference, shopper_email

Generic CLI call

kosmo integrations:call adyen.adyen_make_payment '{"amount":"example_amount","payment_method":"example_payment_method","reference":"example_reference","return_url":"example_return_url","shopper_reference":"example_shopper_reference","shopper_email":"example_shopper_email"}' --json

Provider shortcut

kosmo integrations:adyen adyen_make_payment '{"amount":"example_amount","payment_method":"example_payment_method","reference":"example_reference","return_url":"example_return_url","shopper_reference":"example_shopper_reference","shopper_email":"example_shopper_email"}' --json

`adyen.adyen_refund_payment`

Write write

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.

Parameters: psp_reference, amount

Generic CLI call

kosmo integrations:call adyen.adyen_refund_payment '{"psp_reference":"example_psp_reference","amount":"example_amount"}' --json

Provider shortcut

kosmo integrations:adyen adyen_refund_payment '{"psp_reference":"example_psp_reference","amount":"example_amount"}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`adyen.adyen_capture_payment`

Operation: Write write
Schema command: kosmo integrations:schema adyen.adyen_capture_payment --json

Parameter	Type	Required	Description
`psp_reference`	string	yes	The PSP reference of the authorized payment to capture.
`amount`	object	yes	Capture amount object with "value" (in minor units, e.g., "1000" for €10.00) and "currency" (e.g., "EUR"). Example: {"value": "1000", "currency": "EUR"}.

`adyen.adyen_get_current_merchant`

Get current merchant account information from Adyen. Verifies API connectivity and returns available payment methods for the merchant account.

Operation: Read read
Schema command: kosmo integrations:schema adyen.adyen_get_current_merchant --json

Parameter	Type	Required	Description
No parameters.

`adyen.adyen_get_current_user`

Verify Adyen API connectivity and retrieve current merchant account information. Useful as a health check to confirm the integration is properly configured.

Operation: Read read
Schema command: kosmo integrations:schema adyen.adyen_get_current_user --json

Parameter	Type	Required	Description
No parameters.

`adyen.adyen_get_transaction`

Get details of a specific Adyen transaction by its PSP reference. Returns the full transaction object including amount, status, and payment details.

Operation: Read read
Schema command: kosmo integrations:schema adyen.adyen_get_transaction --json

Parameter	Type	Required	Description
`psp_reference`	string	yes	The PSP reference of the transaction to retrieve (e.g., "8535296650153317").

`adyen.adyen_list_stores`

List stores for the configured Adyen merchant account. Returns store details including store codes, names, and addresses. The merchant account is automatically injected.

Operation: Read read
Schema command: kosmo integrations:schema adyen.adyen_list_stores --json

Parameter	Type	Required	Description
`limit`	integer	no	Maximum number of stores to return per page.
`page`	string	no	Cursor for pagination — pass the value from a previous response to get the next page.

`adyen.adyen_list_transactions`

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.

Operation: Read read
Schema command: kosmo integrations:schema adyen.adyen_list_transactions --json

Parameter	Type	Required	Description
`page`	integer	no	Page number for pagination (starts at 1).
`size`	integer	no	Number of transactions per page (default: 20).

`adyen.adyen_make_payment`

Operation: Write write
Schema command: kosmo integrations:schema adyen.adyen_make_payment --json

Parameter	Type	Required	Description
`amount`	object	yes	Payment amount object with "value" (in minor units, e.g., "1000" for €10.00) and "currency" (e.g., "EUR", "USD"). Example: {"value": "1000", "currency": "EUR"}.
`payment_method`	object	yes	Payment method details. For example: {"type": "scheme", "encryptedCardNumber": "...", "encryptedExpiryMonth": "...", "encryptedExpiryYear": "...", "encryptedSecurityCode": "..."}.
`reference`	string	no	A custom reference for this payment (e.g., an order number).
`return_url`	string	no	URL to redirect the shopper back to after payment completion.
`shopper_reference`	string	no	Unique identifier for the shopper (for recurring payments).
`shopper_email`	string	no	Shopper email address.

`adyen.adyen_refund_payment`

Operation: Write write
Schema command: kosmo integrations:schema adyen.adyen_refund_payment --json

Parameter	Type	Required	Description
`psp_reference`	string	yes	The PSP reference of the payment to refund.
`amount`	object	yes	Refund amount object with "value" (in minor units, e.g., "1000" for €10.00) and "currency" (e.g., "EUR"). Example: {"value": "1000", "currency": "EUR"}.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.