Adyen

Adyen Companies API

The Companies API from Adyen — 29 operation(s) for companies.

GitHub OpenAPI

Operations 44

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /companies List the company accounts I can access · Adyen Get a List of Company Accounts #
Ask an LLM
“Which Adyen company accounts can my API credential see?”
“Can I page through company accounts 100 at a time?”
Tell an agent
List all the company accounts my credential has access to.
Show page {page} of my company accounts, {size} per page.
GET /companies/{companyId} Get a company account · Adyen Get a Company Account #
Ask an LLM
“What details are stored on one specific company account?”
“Can I look up a single company account by its ID?”
Tell an agent
Get the details of company account {company}.
Show me the company account record for {company}.
GET /companies/{companyId}/androidApps List Android apps uploaded for a company · Adyen Get a List of Android Apps #
Ask an LLM
“Which Android apps are available to install on my company's payment terminals?”
“Can I filter the uploaded terminal apps by package name or version code?”
Tell an agent
List the Android terminal apps uploaded for company {company}.
Find Android apps with package {package} for company {company}.
POST /companies/{companyId}/androidApps Upload an Android app for terminals · Adyen Upload Android App #
Ask an LLM
“Can I upload my own APK so it can run on Android payment terminals?”
“What is the maximum APK size I can upload for terminals?”
Tell an agent
Upload a new Android APK to company {company} for its payment terminals.
Add my terminal app build to company {company} as an APK upload.
GET /companies/{companyId}/androidApps/{id} Get one uploaded Android app · Adyen Get Android App #
Ask an LLM
“What status and version does one uploaded terminal APK have?”
“Can I check the details of a specific Android app I uploaded?”
Tell an agent
Get Android app {app} for company {company}.
Show the details of uploaded terminal app {app} under company {company}.
GET /companies/{companyId}/androidCertificates List Android certificates for a company · Adyen Get a List of Android Certificates #
Ask an LLM
“Which Android certificates are available for running apps on my terminals?”
“Can I search the terminal certificates by certificate name?”
Tell an agent
List the Android certificates available to company {company}.
Find Android certificates named {name} for company {company}.
GET /companies/{companyId}/apiCredentials List a company's API credentials · Adyen Get a List of API Credentials #
Ask an LLM
“Which API credentials exist for my company account?”
“Can I see every API credential under the company, page by page?”
Tell an agent
List the API credentials for company {company}.
Show page {page} of API credentials for company {company}.
POST /companies/{companyId}/apiCredentials Create an API credential for a company · Adyen Create an API Credential #
Ask an LLM
“How do I create a new API credential with limited merchant account access?”
“Can I set roles and allowed origins when creating an API credential?”
Tell an agent
Create a new API credential for company {company}.
Create an API credential for company {company} with roles {roles}.
GET /companies/{companyId}/apiCredentials/{apiCredentialId} Get a company API credential · Adyen Get an API Credential #
Ask an LLM
“What roles and merchant access does a particular API credential have?”
“Is a given API credential still active?”
Tell an agent
Get API credential {cred} under company {company}.
Show roles and access for company {company} credential {cred}.
PATCH /companies/{companyId}/apiCredentials/{apiCredentialId} Update a company API credential · Adyen Update an API Credential #
Ask an LLM
“Can I change the roles on an existing API credential?”
“How can I deactivate an API credential without deleting it?”
Tell an agent
Change the roles on API credential {cred} in company {company} to {roles}.
Deactivate API credential {cred} in company {company} by setting active to {active}.
GET /companies/{companyId}/apiCredentials/{apiCredentialId}/allowedOrigins List allowed origins on a company credential · Adyen Get a List of Allowed Origins #
Ask an LLM
“Which domains are allowed to make client-side requests with this API credential?”
“Can I see all allowed origins configured on one company API credential?”
Tell an agent
List the allowed origins for API credential {cred} in company {company}.
Show which domains credential {cred} of company {company} accepts client-side calls from.
POST /companies/{companyId}/apiCredentials/{apiCredentialId}/allowedOrigins Add an allowed origin to a company credential · Adyen Create an Allowed Origin #
Ask an LLM
“How do I allow a new domain to make client-side requests with an API credential?”
“Can I add my checkout domain to an existing credential's allowed origins?”
Tell an agent
Add {domain} as an allowed origin on API credential {cred} in company {company}.
Allow client-side requests from {domain} for company {company} credential {cred}.
DELETE /companies/{companyId}/apiCredentials/{apiCredentialId}/allowedOrigins/{originId} Remove an allowed origin from a company credential · Adyen Delete an Allowed Origin #
Ask an LLM
“What happens to client-side requests once I remove an allowed origin?”
“Can I stop a domain from calling with my company API credential?”
Tell an agent destructive · confirm first
Remove allowed origin {origin} from API credential {cred} in company {company}.
Delete origin {origin} so company {company} credential {cred} no longer accepts that domain.
GET /companies/{companyId}/apiCredentials/{apiCredentialId}/allowedOrigins/{originId} Get one allowed origin of a company credential · Adyen Get an Allowed Origin #
Ask an LLM
“What domain does a specific allowed origin entry hold?”
“Can I fetch a single allowed origin by its ID?”
Tell an agent
Get allowed origin {origin} on API credential {cred} in company {company}.
Show the domain stored in origin {origin} for company {company} credential {cred}.
POST /companies/{companyId}/apiCredentials/{apiCredentialId}/generateApiKey Rotate the API key of a company credential · Adyen Generate New API Key #
Ask an LLM
“How long does the old API key keep working after I generate a new one?”
“Can I rotate the API key on a company-level credential?”
Tell an agent
Generate a new API key for credential {cred} in company {company}.
Rotate the API key of company {company} API credential {cred}.
POST /companies/{companyId}/apiCredentials/{apiCredentialId}/generateClientKey Rotate the client key of a company credential · Adyen Generate New Client Key #
Ask an LLM
“Can I generate a fresh client key for a company API credential?”
“When does the previous client key stop working after rotation?”
Tell an agent
Generate a new client key for credential {cred} in company {company}.
Replace the client key on company {company} API credential {cred}.
GET /companies/{companyId}/billingEntities List billing entities for terminal orders · Adyen Get a List of Billing Entities #
Ask an LLM
“Which billing entities can I charge a terminal order to?”
“Can I find a billing entity by name before placing an order?”
Tell an agent
List the billing entities for company {company}.
Find the billing entity named {name} in company {company}.
GET /companies/{companyId}/merchants List a company's merchant accounts · Adyen Get a List of Merchant Accounts #
Ask an LLM
“Which merchant accounts sit under my company account?”
“Does the merchant list only show accounts my credential can access?”
Tell an agent
List the merchant accounts under company {company}.
Show page {page} of merchant accounts for company {company}, {size} per page.
GET /companies/{companyId}/shippingLocations List shipping locations for terminal orders · Adyen Get a List of Shipping Locations #
Ask an LLM
“Where can my terminal orders be delivered?”
“Can I look up a shipping location by name to get its ID?”
Tell an agent
List the shipping locations for company {company}.
Find the shipping location named {name} in company {company}.
POST /companies/{companyId}/shippingLocations Create a shipping location for orders · Adyen Create a Shipping Location #
Ask an LLM
“Can I add a new delivery address for terminal orders?”
“What do I need to set up a shipping location for my company?”
Tell an agent
Create a shipping location called {name} for company {company}.
Add a delivery address {address} named {name} to company {company}.
GET /companies/{companyId}/terminalActions List scheduled terminal actions · Adyen Get a List of Terminal Actions #
Ask an LLM
“Which terminal actions have I scheduled across the company, like app installs?”
“Can I see only the terminal actions that failed?”
Tell an agent
List the terminal actions scheduled for company {company}.
Show {status} terminal actions for company {company}.
GET /companies/{companyId}/terminalActions/{actionId} Get one scheduled terminal action · Adyen Get Terminal Action #
Ask an LLM
“What is the status of a specific terminal action I scheduled?”
“Did a particular app install action on my terminals succeed?”
Tell an agent
Get terminal action {action} for company {company}.
Check the result of action {action} scheduled for company {company} terminals.
GET /companies/{companyId}/terminalLogos Get the company-level terminal logo · Adyen Get the Terminal Logo #
Ask an LLM
“What logo do my company's terminals of a given model display?”
“Is the company terminal logo returned as a Base64 image?”
Tell an agent
Get the company {company} logo for terminal model {model}.
Show the logo configured company-wide on {model} terminals for {company}.
PATCH /companies/{companyId}/terminalLogos Change the company-level terminal logo · Adyen Update the Terminal Logo #
Ask an LLM
“Can I change the logo on every terminal of one model across my company?”
“Can I update logos for more than one terminal model in a single request?”
Tell an agent
Set the company {company} logo for {model} terminals to {data}.
Replace the company-wide logo on model {model} terminals for company {company}.
GET /companies/{companyId}/terminalModels List terminal models a company can use · Adyen Get a List of Terminal Models #
Ask an LLM
“Which payment terminal models does my company have access to?”
“Where do I get the terminal model ID used to filter terminals?”
Tell an agent
List the terminal models available to company {company}.
Show company {company}'s terminal model IDs.
GET /companies/{companyId}/terminalOrders List terminal product orders · Adyen Get a List of Orders #
Ask an LLM
“Which terminal orders has my company placed?”
“Can I filter terminal orders by status or my own purchase order reference?”
Tell an agent
List the terminal orders for company {company}.
Show company {company} terminal orders with status {status}.
POST /companies/{companyId}/terminalOrders Order payment terminal products · Adyen Create an Order #
Ask an LLM
“How do I order new payment terminals for my company?”
“Does ordering terminals through the test environment ship real devices?”
Tell an agent
Order terminal products {items} for company {company}, billed to {billing} and shipped to {location}.
Place a terminal order for company {company} with purchase reference {ref}.
GET /companies/{companyId}/terminalOrders/{orderId} Get a terminal product order · Adyen Get an Order #
Ask an LLM
“What is the status of a terminal order I placed?”
“Can I see which products and shipping location are on one order?”
Tell an agent
Get terminal order {order} for company {company}.
Check where company {company} terminal order {order} stands.
PATCH /companies/{companyId}/terminalOrders/{orderId} Change a placed terminal order · Adyen Update an Order #
Ask an LLM
“Can I change the products on a terminal order after placing it?”
“Until when can a terminal order still be edited?”
Tell an agent
Update the items on terminal order {order} in company {company} to {items}.
Change the shipping location of company {company} order {order} to {location}.
POST /companies/{companyId}/terminalOrders/{orderId}/cancel Cancel a terminal product order · Adyen Cancel an Order #
Ask an LLM
“Can I cancel a terminal order that has already shipped?”
“What status must a terminal order be in before I can cancel it?”
Tell an agent destructive · confirm first
Cancel terminal order {order} for company {company}.
Call off company {company}'s placed terminal order {order}.
GET /companies/{companyId}/terminalProducts List terminal products available by country · Adyen Get a List of Terminal Products #
Ask an LLM
“Which terminal packages and parts can I order in a given country?”
“Can I see only the products for one terminal model?”
Tell an agent
List the terminal products company {company} can order in {country}.
Show {country} products for terminal model {model} available to company {company}.
GET /companies/{companyId}/terminalSettings Get company-wide terminal settings · Adyen Get Terminal Settings #
Ask an LLM
“What terminal settings apply to all terminals across my company?”
“Which receipt, tipping and connectivity defaults are set at the company level?”
Tell an agent
Get the company-level terminal settings for {company}.
Show the default terminal configuration applied across company {company}.
PATCH /companies/{companyId}/terminalSettings Update company-wide terminal settings · Adyen Update Terminal Settings #
Ask an LLM
“Can I enable tipping on every terminal in my company at once?”
“Do company terminal settings override values set on a store or merchant?”
Tell an agent
Update the gratuity settings for all terminals in company {company} to {gratuities}.
Change the company {company} terminal receipt options to {options}.
GET /companies/{companyId}/users List a company's Customer Area users · Adyen Get a List of Users #
Ask an LLM
“Who are the users on my company account?”
“Can I search company users by username?”
Tell an agent
List the users of company {company}.
Find the user with username {username} in company {company}.
POST /companies/{companyId}/users Create a company user · Adyen Create a New User #
Ask an LLM
“How do I add a new team member to my company account?”
“Can I give a new user access to only certain merchant accounts?”
Tell an agent
Create user {username} named {name} with email {email} in company {company}.
Add user {username} ({email}) to company {company} with roles {roles}.
GET /companies/{companyId}/users/{userId} Get a company user's details · Adyen Get User Details #
Ask an LLM
“What roles and merchant access does one company user have?”
“Can I look up a company user by their user ID?”
Tell an agent
Get user {user} in company {company}.
Show the roles and email of company {company} user {user}.
PATCH /companies/{companyId}/users/{userId} Update a company user · Adyen Update User Details #
Ask an LLM
“Can I deactivate a company user who left the team?”
“Can I change a company user's roles or email?”
Tell an agent
Change the roles of user {user} in company {company} to {roles}.
Deactivate company {company} user {user} by setting active to {active}.
GET /companies/{companyId}/webhooks List a company's webhooks · Adyen List All Webhooks #
Ask an LLM
“Which webhooks are configured at the company level?”
“Can I page through all company webhook configurations?”
Tell an agent
List the webhooks configured for company {company}.
Show page {page} of company {company}'s webhook configurations.
POST /companies/{companyId}/webhooks Set up a company webhook · Adyen Set Up a Webhook #
Ask an LLM
“How do I subscribe to event notifications for my whole company account?”
“Can I protect a company webhook with basic authentication?”
Tell an agent
Set up a {type} webhook for company {company} that posts to {url}.
Create a company {company} webhook to {url} in {format} format for merchant accounts {merchants}.
DELETE /companies/{companyId}/webhooks/{webhookId} Remove a company webhook · Adyen Remove a Webhook #
Ask an LLM
“Can I delete a company webhook I no longer use?”
“What happens to notifications after I remove a company webhook?”
Tell an agent destructive · confirm first
Remove webhook {webhook} from company {company}.
Delete company {company}'s webhook configuration {webhook}.
GET /companies/{companyId}/webhooks/{webhookId} Get a company webhook configuration · Adyen Get a Webhook #
Ask an LLM
“What URL and event types is a company webhook configured with?”
“Is a particular company webhook currently active?”
Tell an agent
Get webhook {webhook} for company {company}.
Show the configuration of company {company} webhook {webhook}.
PATCH /companies/{companyId}/webhooks/{webhookId} Update a company webhook · Adyen Update a Webhook #
Ask an LLM
“Can I change the endpoint URL of an existing company webhook?”
“Can I switch a company webhook off temporarily?”
Tell an agent
Change the URL of webhook {webhook} in company {company} to {url}.
Set company {company} webhook {webhook} active to {active}.
POST /companies/{companyId}/webhooks/{webhookId}/generateHmac Generate an HMAC key for a company webhook · Adyen Generate an HMAC Key #
Ask an LLM
“How can I verify company webhook notifications really came from Adyen?”
“Will notifications be HMAC-signed once I create a key?”
Tell an agent
Generate an HMAC key for webhook {webhook} in company {company}.
Start HMAC-signing notifications for company {company} webhook {webhook}.
POST /companies/{companyId}/webhooks/{webhookId}/test Send test notifications to a company webhook · Adyen Test a Webhook #
Ask an LLM
“Can I check that my company webhook endpoint receives notifications correctly?”
“For how many merchant accounts are sample notifications sent in a webhook test?”
Tell an agent
Send test notifications to webhook {webhook} in company {company}.
Test company {company} webhook {webhook} for event types {types}.

Documentation

📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/classic/configure-notifications/
📖
Documentation
https://docs.adyen.com/api-explorer/Account/6/overview
📖
Documentation
https://docs.adyen.com/development-resources/webhooks/
📖
Documentation
https://docs.adyen.com/api-explorer/BalanceControl/1/overview
📖
Documentation
https://docs.adyen.com/api-explorer/BinLookup/52/overview
📖
Documentation
https://docs.adyen.com/api-explorer/Checkout/71/overview
📖
Documentation
https://docs.adyen.com/api-explorer/balanceplatform/2/overview
📖
Documentation
https://docs.adyen.com/api-explorer/balanceplatform-webhooks/1/overview
📖
Documentation
https://docs.adyen.com/development-resources/data-protection-api/
📖
Documentation
https://docs.adyen.com/risk-management/disputes-api
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/classic/fund-transfer/
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/collect-verification-details/hosted/
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/legal-entity-management-api/
📖
Documentation
https://docs.adyen.com/api-explorer/Management/3/overview
📖
Documentation
https://docs.adyen.com/api-explorer/management-webhooks/3/overview
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/classic/notifications
📖
Documentation
https://docs.adyen.com/point-of-sale/design-your-integration/notifications/
📖
Documentation
https://docs.adyen.com/online-payments/
📖
Documentation
https://docs.adyen.com/online-payments/online-payouts
📖
Documentation
https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/
📖
Documentation
https://docs.adyen.com/online-payments/tokenization
📖
Documentation
https://docs.adyen.com/api-explorer/report-webhooks/1/overview
📖
Documentation
https://docs.adyen.com/payment-methods/gift-cards/stored-value-api/
📖
Documentation
https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/terminal-api-reference/
📖
Documentation
https://docs.adyen.com/development-resources/testing/create-test-cards
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/business-accounts/transactions/transaction-webhooks/
📖
Documentation
https://docs.adyen.com/api-explorer/transfer-webhooks/3/overview
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/payout-to-users/on-demand-payouts
📖
Documentation
https://docs.adyen.com/development-resources/webhooks

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/openapi/adyen-companies-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/asyncapi/adyen-webhooks-asyncapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/adyen-companies-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

adyen-companies-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: '3'
  x-publicVersion: true
  title: Adyen Management Companies API
  description: Configure and manage your Adyen company and merchant accounts, stores, and payment terminals.
  termsOfService: https://www.adyen.com/legal/terms-and-conditions
  contact:
    name: Adyen Developer Experience team
    url: https://github.com/Adyen/adyen-openapi
servers:
- url: https://management-test.adyen.com/v3
tags:


# --- truncated at 32 KB (435 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/openapi/adyen-companies-api-openapi.yml