For Agents
Initiate and authorise online payments across cards, wallets, and local methods, plus refunds, captures, payment links, and recurring billing.
Get started with Adyen Checkout API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"process a credit card payment with adyen"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Adyen Checkout API API.
Initiate a payment via POST /payments with card, wallet, or local payment method details
Submit additional payment details (3DS challenge results, redirect returns) via POST /payments/details
Capture, cancel, refund, or reverse an authorised payment using the modifications endpoints
Generate hosted payment links via POST /paymentLinks for invoicing and async checkout flows
GET STARTED
Use for: Process a card payment with 3D Secure authentication, Create a hosted payment link for an invoice, Capture a previously authorised payment, Refund a settled card payment
Not supported: Does not handle balance platform configuration, BIN lookup, settlement reporting, or in-person POS terminals — use for online payment authorisation, modifications, and recurring tokens only.
The Adyen Checkout API is Adyen's primary surface for initiating and authorising online payments — cards (including 3D Secure), mobile wallets, local payment methods, and recurring billing. The 26 endpoints in v70 cover the full payment lifecycle: list available payment methods for a session, create payments, post payment details for redirects and 3DS challenges, capture and cancel authorisations, refund, manage payment links, handle Apple Pay sessions, support recurring stored details, and process orders for partial-method splits and donations.
Create Apple Pay merchant sessions via POST /applePay/sessions for in-app and web Apple Pay checkouts
Use POST /sessions to launch a Drop-in or Components session that handles payment method selection client-side
Manage stored payment details and recurring tokens for subscription billing
Patterns agents use Adyen Checkout API API for, with concrete tasks.
★ Card Checkout with 3D Secure
The classic card-payment flow uses POST /sessions to launch a Drop-in or Components session, then POST /payments and POST /payments/details to handle the 3DS2 round-trip. Adyen returns the resultCode (Authorised, ChallengeShopper, RedirectShopper) and the front end follows the prescribed step. The API handles 135+ payment methods and 100+ currencies with the same surface.
Call POST /payments with paymentMethod.type=scheme, encryptedCardNumber, amount, and merchantAccount, then if resultCode=ChallengeShopper post the 3DS challenge result to POST /payments/details
Hosted Payment Links for Invoicing
When a payment cannot be collected synchronously — invoicing a customer, sending a quote — POST /paymentLinks generates a hosted Adyen-branded URL that the customer can open from email or SMS. The link supports the same 135+ methods, returns a webhook on completion, and can be voided with PATCH /paymentLinks/{linkId} if the invoice is cancelled.
Call POST /paymentLinks with amount, reference, expiresAt, and shopperEmail, then email the returned link.url to the customer
Recurring Subscription Billing
Subscription products tokenize a card on the first payment and reuse the recurringDetailReference for renewals. POST /payments with recurringProcessingModel=Subscription captures the token; subsequent renewals call POST /payments referencing the stored token, with no shopper interaction required. Stored details can be revoked via DELETE on the storedPaymentMethods resource.
Call POST /payments with shopperReference, recurringProcessingModel=Subscription, and storePaymentMethod=true on the first charge, then renewals call POST /payments referencing storedPaymentMethodId
Refunds and Modifications
Operational tools need to capture an authorisation, partially refund a settled payment, or reverse a pending one. The modifications endpoints — POST /payments/{paymentPspReference}/captures, /refunds, /reversals, /cancels — accept a pspReference and an amount, and Adyen handles the corresponding webhook acknowledgement asynchronously.
Call POST /payments/{paymentPspReference}/refunds with the original pspReference and the amount to refund, then track the refund webhook for confirmation
Agent-Driven Checkout via Jentic
A commerce agent can use Jentic to discover the right Checkout operation across 26 endpoints — payments, payment links, captures, refunds, sessions — and execute it with X-API-Key managed in the Jentic vault. This is the highest-value surface in the Adyen catalogue for agent-driven workflows because of the breadth of operations and the criticality of the credentials.
Use Jentic to search 'process credit card payment adyen', load POST /payments, and execute it for the requested amount and card details
26 endpoints — the adyen checkout api is adyen's primary surface for initiating and authorising online payments — cards (including 3d secure), mobile wallets, local payment methods, and recurring billing.
METHOD
PATH
DESCRIPTION
/payments
Initiate a payment
/payments/details
Submit 3DS or redirect details
/sessions
Create a Drop-in/Components checkout session
/paymentLinks
Create a hosted payment link
/cancels
Cancel a pending authorisation
/applePay/sessions
Create an Apple Pay merchant session
/orders
Create a multi-method order
/donations
Process a donation alongside a payment
/payments
Initiate a payment
/payments/details
Submit 3DS or redirect details
/sessions
Create a Drop-in/Components checkout session
/paymentLinks
Create a hosted payment link
/cancels
Cancel a pending authorisation
Three things that make agents converge on Jentic-routed access.
Credential isolation
Adyen X-API-Key and basic auth credentials are stored encrypted in the Jentic vault. The Checkout key can authorise payments and refunds, so isolating it from the agent's prompt context is critical — agents receive scoped execution access only.
Intent-based discovery
Agents search Jentic by intent (for example 'process credit card payment' or 'create payment link') and Jentic returns the right Checkout operation among 26 endpoints with its full input schema, so the agent doesn't have to map operations from the developer portal.
Time to first call
Direct Adyen Checkout integration: 1-2 weeks for client-side Drop-in plus server-side payments, 3DS, modifications, and webhooks. Through Jentic: under a day for the equivalent operations — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Adyen BIN Lookup API
Pre-checkout 3DS routing and cost estimate that informs the Checkout request
Pair with BIN Lookup at the front of the flow before calling POST /payments to choose the right authentication path
Stripe
Stripe Payment Intents covers an equivalent card, wallet, and recurring surface
Choose Stripe when the processor is Stripe rather than Adyen; Payment Intents has different idempotency and 3DS conventions
Braintree
Braintree's Transactions API offers a comparable card and wallet surface from PayPal
Choose Braintree when the processor is PayPal/Braintree rather than Adyen
Specific to using Adyen Checkout API API through Jentic.
What authentication does the Adyen Checkout API use?
The API supports an apiKey scheme using the X-API-Key header and HTTP basic auth with Customer Area credentials. Through Jentic, the X-API-Key is stored encrypted in the vault and injected at request time, so agents calling POST /payments never hold the raw key.
Can I process refunds with the Adyen Checkout API?
Yes. POST /payments/{paymentPspReference}/refunds accepts the original payment's pspReference and the amount to refund (full or partial). Adyen confirms the refund asynchronously via the corresponding webhook.
What are the rate limits for the Adyen Checkout API?
The OpenAPI spec does not declare programmatic rate limits. Adyen documents per-merchant-account throughput limits in their developer portal — coordinate large surge events with your Adyen account manager and use idempotency keys on POST /payments and modifications.
How do I create a hosted payment link through Jentic?
Search Jentic for 'create adyen payment link', load the POST /paymentLinks operation, and execute it with amount, reference, expiresAt, and the shopperEmail. Jentic returns the structured response containing the link.url.
Can I tokenize a card for subscription billing?
Yes. On the first POST /payments call, set storePaymentMethod=true and pass shopperReference plus recurringProcessingModel=Subscription. Subsequent renewals POST /payments referencing the storedPaymentMethodId without shopper interaction.
How do I capture an authorisation and not just authorise it?
By default, set captureDelayHours appropriately on POST /payments, or call POST /payments/{paymentPspReference}/captures with the amount to capture. Auto-capture and manual-capture behaviour is controlled per merchant account in the Customer Area.
/applePay/sessions
Create an Apple Pay merchant session
/orders
Create a multi-method order
/donations
Process a donation alongside a payment