withoneai Adyen through One
Adyen is a financial technology platform that enables businesses to accept, process, and manage payments across online, mobile, and in-store channels while offering data insights, fraud prevention, and embedded financial products through a single unified API.
One exposes Adyen through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.
How to run an action
- Find the action in the table below, or call
search_one_platform_actionswith platformadyenif it is not listed. - Call
get_one_action_knowledgewith the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters. - Call
execute_one_actionwith parameters copied from that knowledge.
Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.
Before you start
Call list_one_integrations once and confirm Adyen is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.
Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.
Before a write
Creates, updates, deletes and sends land on a real Adyen account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.
Actions
Payments
| Action | Method | Path | Action id |
|---|---|---|---|
| Cancel an Authorisation | POST | /pal/servlet/Payment/v68/cancel |
conn_mod_def::GKJ8fUe2EDg::zxRIcqwmRCKl8LwsYIcIMw |
| Cancel an Authorisation Using Your Reference | POST | /pal/servlet/Payment/v68/technicalCancel |
conn_mod_def::GKJ8fWLhnVA::YTBS0amZTRS4oN5jsHrjqQ |
| Cancel an Authorised Payment | POST | /v71/payments/{{paymentPspReference}}/cancels |
conn_mod_def::GKJ8W2atrTg::-6iIYN7NSAavKzOUUtK-NA |
| Cancel an In-Person Refund | POST | /pal/servlet/Payment/v68/voidPendingRefund |
conn_mod_def::GKJ8fUvQR7A::cIGGAQZlSd-ejaaA5GOfyQ |
| Cancel or Refund a Payment | POST | /pal/servlet/Payment/v68/cancelOrRefund |
conn_mod_def::GKJ8fUSR9Kg::VUEY1QDDQOCwMlyl4f_Gyg |
| Capture an Authorisation | POST | /pal/servlet/Payment/v68/capture |
conn_mod_def::GKJ8fXMU2Lg::PNbEzXXMQZGNb8alUo0Y8Q |
| Capture an Authorised Payment | POST | /payments/{{paymentPspReference}}/captures |
conn_mod_def::GKJ8W4EH1Ng::01qveUkmR4Cr3rksTp966A |
| Change the Authorised Amount | POST | /pal/servlet/Payment/v68/adjustAuthorisation |
conn_mod_def::GKJ8fgmsLVg::CSxeOJYTTXuzxr6DwILrqw |
| Complete a 3DS Authorisation | POST | /pal/servlet/Payment/v68/authorise3d |
conn_mod_def::GKJ8fiVSsug::g9gtoOKCQ-ePr9hSxcQanA |
| Complete a 3DS2 Authorisation | POST | /pal/servlet/Payment/v68/authorise3ds2 |
conn_mod_def::GKJ8fiUkyQA::OOoNFLiASUmPb4nNWm_Jig |
| Refund a Captured Payment | POST | /pal/servlet/Payment/v68/refund |
conn_mod_def::GKJ8frYiJ-A::oQ7kHDXPR5e71T5ykZ3KPw |
| Refund a Captured Payment | POST | /payments/{{paymentPspReference}}/refunds |
conn_mod_def::GKJ8XrqWf4A::d0pQHno0ROqp-i4-98xDJA |
4 more Payments actions are available through search.
LegalEntities
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Legal Entity | GET | /lem/v4/legalEntities/{{id}} |
conn_mod_def::GKJ8ZDGCkTg::_uly8OhwRkiMypom6E7yAQ |
| Get a Legal Entity's Accepted Terms of Service Document | GET | /lem/v4/legalEntities/{{id}}/acceptedTermsOfServiceDocument/{{termsofserviceacceptancereference}} |
conn_mod_def::GKJ8ZMDIqvg::RccxGZcWTvuMnQYZMCM_-g |
| Get a Legal Entity's PCI Questionnaire | GET | /lem/v4/legalEntities/{{id}}/pciQuestionnaires/{{pciid}} |
conn_mod_def::GKJ8ZbsSK2A::nVd1idnNTtm4i6cVE3ZcMA |
| Get a Legal Entity's Terms of Service Status | GET | /lem/v4/legalEntities/{{id}}/termsOfServiceStatus |
conn_mod_def::GKJ8Zcr0yhA::ISGgvg7DTauXhOUxPDisMQ |
| Accept Terms of Service for a Legal Entity | PATCH | /lem/v4/legalEntities/{{id}}/termsOfService/{{termsofservicedocumentid}} |
conn_mod_def::GKJ8YelFbXA::D6denQQtQBWAccAprVFlNg |
| Calculate PCI Status of a Legal Entity | POST | /lem/v4/legalEntities/{{id}}/pciQuestionnaires/signingRequired |
conn_mod_def::GKJ8Yu4dsBg::5Iq1gYSCSYOtLNqIHgj3Ew |
| Check a Legal Entity's Tax Electronic Delivery Consent Status | POST | /lem/v4/legalEntities/{{id}}/checkTaxElectronicDeliveryConsent |
conn_mod_def::GKJ8YweQqCA::xRxJBQPhR26PQIIgPWWwLQ |
| Check a Legal Entity's Verification Errors | POST | /lem/v4/legalEntities/{{id}}/checkVerificationErrors |
conn_mod_def::GKJ8YwcNqPg::RmQX0jVwTGeT1kIcL5UonA |
| Confirm Data Review for a Legal Entity | POST | /lem/v4/legalEntities/{{id}}/confirmDataReview |
conn_mod_def::GKJ8YueRY0g::znDndeERTAyO8j1X0Ei5FQ |
| Create a Legal Entity | POST | /lem/v4/legalEntities |
conn_mod_def::GKJ8Y50hy6g::2udSFvX3Qw6j6Abi3tHzIw |
| Get a Legal Entity's Terms of Service Document | POST | /lem/v4/legalEntities/{{id}}/termsOfService |
conn_mod_def::GKJ8Zc2natg::MFyX5iJgRRGc7gxQYUVsbg |
| Request Periodic Data Review for a Legal Entity | POST | /legalEntities/{{id}}/requestPeriodicReview |
conn_mod_def::GKJ8ZsfSN-A::nHjJyCa5TiOSxM1nN0R1Ug |
3 more LegalEntities actions are available through search.
AllowedOrigins
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Company's API Credential Allowed Origin | GET | /v3/companies/{{companyId}}/apiCredentials/{{apiCredentialId}}/allowedOrigins/{{originId}} |
conn_mod_def::GKJ8cYS4ioA::yr9u2DMRTAaq6FEqO1FD9A |
| Get a Merchant API Credential Allowed Origin | GET | /merchants/{{merchantId}}/apiCredentials/{{apiCredentialId}}/allowedOrigins/{{originId}} |
conn_mod_def::GKJ8ciooj7A::vgMtEvvjRN6RTLCnmKd0yg |
| Get My Allowed Origin Details | GET | /v3/me/allowedOrigins/{{originId}} |
conn_mod_def::GKJ8cVwN_PA::-i_g5sRgRgSCCz6GjjJ8CQ |
| Get My Allowed Origins | GET | /v3/me/allowedOrigins |
conn_mod_def::GKJ8cZFSgig::TrQGrKAhRmyRFFDieFNz-A |
| List a Company's API Credential Allowed Origins | GET | /v3/companies/{{companyId}}/apiCredentials/{{apiCredentialId}}/allowedOrigins |
conn_mod_def::GKJ8bImOkfg::g1LzA-7pQcabR8e6AnUWIQ |
| List a Merchant API Credential's Allowed Origins | GET | /v3/merchants/{{merchantId}}/apiCredentials/{{apiCredentialId}}/allowedOrigins |
conn_mod_def::GKJ8bJKxh2g::16RfvnbXQAmFnhLutkTdnA |
| Add Allowed Origin to Your API Credential | POST | /v3/me/allowedOrigins |
conn_mod_def::GKJ8Z5Lp_mg::0ssZKGcTSFWD3YiCBYXm4A |
| Create an API Credential Allowed Origin for a Company | POST | /v3/companies/{{companyId}}/apiCredentials/{{apiCredentialId}}/allowedOrigins |
conn_mod_def::GKJ8ahh8gPg::Ey4k585tQuuwRW0boiYr8A |
| Create an API Credential Allowed Origin for a Merchant | POST | /v3/merchants/{{merchantId}}/apiCredentials/{{apiCredentialId}}/allowedOrigins |
conn_mod_def::GKJ8ahSIcwg::esIQzecrTle31jGMOwFJ_w |
| Delete a Company's API Credential Allowed Origin | DELETE | /v3/companies/{{companyId}}/apiCredentials/{{apiCredentialId}}/allowedOrigins/{{originId}} |
conn_mod_def::GKJ8a1nQuig::_XWdjnH2Sw2t33LTDSeADA |
| Remove an Allowed Origin for the Current API Credential | DELETE | /v3/me/allowedOrigins/{{originId}} |
conn_mod_def::GKJ8doohxbg::gPHvS_T6RiCsrahD31JpQg |
TerminalOrders
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Company's Terminal Order | GET | /v3/companies/{{companyId}}/terminalOrders/{{orderId}} |
conn_mod_def::GKJ8cxfv2ng::oWxjazPqR9e55pQyDBrwMQ |
| Get a Merchant Terminal Order | GET | /v3/merchants/{{merchantId}}/terminalOrders/{{orderId}} |
conn_mod_def::GKJ8cxf5KUg::_uqjnpF7Tsy7eiK-54aMHg |
| List a Company's Terminal Orders | GET | /v3/companies/{{companyId}}/terminalOrders |
conn_mod_def::GKJ8bgxggpg::FbM1dTJ2SU-j2XSDPh4dhg |
| List a Merchant's Terminal Orders | GET | /v3/merchants/{{merchantId}}/terminalOrders |
conn_mod_def::GKJ8bjAnYng::NFVRM70MTv2SRSgU5yQglQ |
| Cancel a Company's Terminal Order | POST | /v3/companies/{{companyId}}/terminalOrders/{{orderId}}/cancel |
conn_mod_def::GKJ8aC-fZRg::iqTNpOxSQ_OmPZwYzElYbw |
| Cancel a Merchant Terminal Order | POST | /v3/merchants/{{merchantId}}/terminalOrders/{{orderId}}/cancel |
conn_mod_def::GKJ8aEIdHSA::Su0N0K2ySN-cYMqpuWsySg |
| Create a Company's Terminal Order | POST | /v3/companies/{{companyId}}/terminalOrders |
conn_mod_def::GKJ8arwSjjg::dFtsLtL4QHGBflJUrrfqPg |
| Create a Merchant Terminal Order | POST | /v3/merchants/{{merchantId}}/terminalOrders |
conn_mod_def::GKJ8aswvcuA::u37cGvGaSD6xAWBblFuYig |
| Update a Company's Terminal Order | PATCH | /v3/companies/{{companyId}}/terminalOrders/{{orderId}} |
conn_mod_def::GKJ8eIpKC-g::JnX1JRzzQYSNniew000XGw |
| Update a Merchant's Terminal Order | PATCH | /v3/merchants/{{merchantId}}/terminalOrders/{{orderId}} |
conn_mod_def::GKJ8eSksVRg::Wotx4HZxS9S02aN24CcTwQ |
TerminalSettings
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Company's Terminal Settings | GET | /v3/companies/{{companyId}}/terminalSettings |
conn_mod_def::GKJ8dEDze5A::LfLNMblQSkGXo54trD437g |
| Get a Merchant's Terminal Settings | GET | /v3/merchants/{{merchantId}}/terminalSettings |
conn_mod_def::GKJ8dEYFaRg::Cdxeh1LDTkCLVbZxLzMltw |
| Get a Store's Terminal Settings | GET | /v3/stores/{{storeId}}/terminalSettings |
conn_mod_def::GKJ8dExoubg::mEVy9oQyT-SyYmyPgAjBVw |
| Get a Store's Terminal Settings | GET | /v3/merchants/{{merchantId}}/stores/{{reference}}/terminalSettings |
conn_mod_def::GKJ8dFAK9lg::YY0RaJ0yTdeEM974CuJIow |
| Get a Terminal's Settings | GET | /v3/terminals/{{terminalId}}/terminalSettings |
conn_mod_def::GKJ8dHEMHrg::lYRJEbYuSVuRawHpyZzbnA |
| Update a Company's Terminal Settings | PATCH | /v3/companies/{{companyId}}/terminalSettings |
conn_mod_def::GKJ8eTK1ilA::itl-JsyCQgGZOizCnMJbEQ |
| Update a Merchant's Terminal Settings | PATCH | /v3/merchants/{{merchantId}}/terminalSettings |
conn_mod_def::GKJ8eSt4veg::Kp046UW3QiuFAKfeybvpjA |
| Update a Store's Terminal Settings | PATCH | /v3/merchants/{{merchantId}}/stores/{{reference}}/terminalSettings |
conn_mod_def::GKJ8eS1hKRA::dyllJjN5Q2CvH8dNZfYiOw |
| Update a Store's Terminal Settings | PATCH | /v3/stores/{{storeId}}/terminalSettings |
conn_mod_def::GKJ8eTIgQ3g::-QXSijShRIy09PbqTlzw1g |
| Update a Terminal's Settings | PATCH | /v3/terminals/{{terminalId}}/terminalSettings |
conn_mod_def::GKJ8ef4Parg::ZB0T0bB5QdmlhL-2yRtaLw |
TransactionRules
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Transaction Rule | GET | /bcl/v2/transactionRules/{{transactionRuleId}} |
conn_mod_def::GKJ8VObyRXg::J8bXD4S1SxWNSSfvAuqHRw |
| List a Balance Account's Transaction Rules | GET | /bcl/v2/balanceAccounts/{{id}}/transactionRules |
conn_mod_def::GKJ8VaE1YHg::RTrwDRKBT6eNR2Oks6w6Sw |
| List a Balance Platform's Transaction Rules | GET | /bcl/v2/balancePlatforms/{{id}}/transactionRules |
conn_mod_def::GKJ8VZh8Chg::i-A_CYycSCWPlhHoYRBMqQ |
| List a Payment Instrument Group's Transaction Rules | GET | /bcl/v2/paymentInstrumentGroups/{{id}}/transactionRules |
conn_mod_def::GKJ8Vkl90jg::l0CXP2PfSjq_kMJ7L_zzqg |
| List a Payment Instrument's Transaction Rules | GET | /paymentInstruments/{{id}}/transactionRules |
conn_mod_def::GKJ8VbV-geA::BqbNFBSWSjmQIT5ZRn7_Hg |
| List an Account Holder's Transaction Rules | GET | /bcl/v2/accountHolders/{{id}}/transactionRules |
conn_mod_def::GKJ8VknSfgA::XV8EaGk5QyKIm3Mkf0u9_g |
| Create a Transaction Rule | POST | /bcl/v2/transactionRules |
conn_mod_def::GKJ8T8bYfXA::hb8XQ3hjSX-qqMfzcTELRg |
| Delete a Transaction Rule | DELETE | /bcl/v2/transactionRules/{{transactionRuleId}} |
conn_mod_def::GKJ8UTNu6rg::lXkMHX7qR4WmETQHCtZxPw |
| Update a Transaction Rule | PATCH | /bcl/v2/transactionRules/{{transactionRuleId}} |
conn_mod_def::GKJ8WNk6fSA::YGzs46BHR2Cv2n7RdAY1ag |
PaymentInstruments
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Payment Instrument | GET | /bcl/v2/paymentInstruments/{{id}} |
conn_mod_def::GKJ8VDbn7Rg::3Dw1BVgnRGCgnwCxSr_oSQ |
| Get a Payment Instrument's Network Token Activation Data | GET | /bcl/v2/paymentInstruments/{{id}}/networkTokenActivationData |
conn_mod_def::GKJ8VveEpfA::TxbUmDj-Q_aqvIVWFuMK7Q |
| Get a Payment Instrument's PAN | GET | /bcl/v2/paymentInstruments/{{id}}/reveal |
conn_mod_def::GKJ8V4Zzi3g::zTA1gdZeTv6QL8e_-5iJZQ |
| List a Balance Account's Payment Instruments | GET | /bcl/v2/balanceAccounts/{{id}}/paymentInstruments |
conn_mod_def::GKJ8Vvqqiog::jdZK4oHiTriLUhOSdbrmtQ |
| Create a Payment Instrument | POST | /bcl/v2/paymentInstruments |
conn_mod_def::GKJ8T8FXmag::sXGAAv8GQzSv7sVZnQCdgw |
| Create Network Token Provisioning Data for a Payment Instrument | POST | /paymentInstruments/{{id}}/networkTokenActivationData |
conn_mod_def::GKJ8UKS6-vA::PfuEz9EZREKrA7eaX23feQ |
| Reveal a Payment Instrument's Data | POST | /bcl/v2/paymentInstruments/reveal |
conn_mod_def::GKJ8WC0p90A::k_CC_xDtS-ed8PAA6y6LKQ |
| Update a Payment Instrument | PATCH | /bcl/v2/paymentInstruments/{{id}} |
conn_mod_def::GKJ8WMigv4g::uS-EDypkT--BhjBOYL20hQ |
| Update a Payment Instrument's Authorized Card Users | PATCH | /bcl/v2/paymentInstruments/{{paymentInstrumentId}}/authorisedCardUsers |
conn_mod_def::GKJ8WNaYS2A::hmArFD6yQHGciYI5TVIvLA |
Stores
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Merchant Store | GET | /v3/merchants/{{merchantId}}/stores/{{storeId}} |
conn_mod_def::GKJ8cMyobIA::DGyAmQa-QCyBTjkOdQzU_Q |
| Get a Store | GET | /v3/stores/{{storeId}} |
conn_mod_def::GKJ8cMjboVg::j8HgVFmpTj2mDV_GaCInNQ |
| List a Merchant's Stores | GET | /v3/merchants/{{merchantId}}/stores |
conn_mod_def::GKJ8btkK44g::S7Ca8shuRFylMvT5hF0_BA |
| List Stores | GET | /v3/stores |
conn_mod_def::GKJ8b3dONWg::h_gV158bQrKz1EOO-tVxJw |
| Create a Merchant Store | POST | /v3/merchants/{{merchantId}}/stores |
conn_mod_def::GKJ8afAc3xg::qRUhkJsSQ3mlfCaoMXU9TQ |
| Create a Store | POST | /stores |
conn_mod_def::GKJ8afQ6oNA::NksKs7wORcSMZle_0zJtSw |
| Get Stores Under an Account | POST | /postfmapi/terminal/v1/getStoresUnderAccount |
conn_mod_def::GKJ8hINjc6g::9W6cyc2NQva9k_TG9UiEWA |
| Update a Merchant Store | PATCH | /v3/merchants/{{merchantId}}/stores/{{storeId}} |
conn_mod_def::GKJ8d_hbsaA::c2O0EO8eQYSePLYXId-acg |
| Update a Store | PATCH | /v3/stores/{{storeId}} |
conn_mod_def::GKJ8d-qeueA::yP3Q_ROyTTuYjZ-gtOHwgA |
TerminalLogos
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Company's Terminal Logo | GET | /v3/companies/{{companyId}}/terminalLogos |
conn_mod_def::GKJ8dP9x8mg::Wk3qSh9BTlCpjqwL-QConw |
| Get a Merchant's Terminal Logo | GET | /v3/merchants/{{merchantId}}/terminalLogos |
conn_mod_def::GKJ8dRefdgg::y_iqKkZvSWyLyZUV9CL2wQ |
| Get a Store Terminal Logo for a Merchant | GET | /v3/merchants/{{merchantId}}/stores/{{reference}}/terminalLogos |
conn_mod_def::GKJ8dQww_kA::DfNUgTylTP-K1Mkxvhal1g |
| Get a Terminal's Logo | GET | /v3/terminals/{{terminalId}}/terminalLogos |
conn_mod_def::GKJ8dQQUo2A::879-b3LNRe-wcQU5Nc9UYw |
| Update a Company's Terminal Logo | PATCH | /v3/companies/{{companyId}}/terminalLogos |
conn_mod_def::GKJ8epodH7g::orHfZmAYQlKLPH5XW4mExg |
| Update a Store Terminal Model Logo for a Merchant | PATCH | /v3/merchants/{{merchantId}}/stores/{{reference}}/terminalLogos |
conn_mod_def::GKJ8epA8HfA::1mNgm1r6RvGuz5sYWCwzwA |
| Update a Store's Terminal Logo | PATCH | /v3/stores/{{storeId}}/terminalLogos |
conn_mod_def::GKJ8eppIpFg::KDITJl6pRt-Ja6M74IptbQ |
| Update a Terminal's Logo | PATCH | /v3/terminals/{{terminalId}}/terminalLogos |
conn_mod_def::GKJ8ecsTWpg::8cjyQj-LSVSnGmCDe9m0Vw |
This lists 90 of 426 actions. For anything not here, call search_one_platform_actions with platform adyen. The full catalog is at https://www.withone.ai/knowledge/adyen.
When a call fails
The error comes from Adyen, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.
Full catalog: https://www.withone.ai/knowledge/adyen
Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.