Adyen

Adyen Payments API

The Payments API from Adyen — 23 operation(s) for payments.

Documentation GitHub OpenAPI

Business capability

Payment Initiation Management BC-1340.10

Operations 6

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

POST /paymentSession Create a legacy Checkout SDK payment session · Adyen Create a Payment Session #

Ask an LLM

“Where do I get the payment session data the older Checkout SDK needs to start?”

“Can I enable one-click or recurring when creating a payment session?”

Tell an agent

Create a payment session for {amount} in {countryCode} on merchant {merchantAccount}, reference {reference}, returning to {returnUrl}.

Start a Checkout SDK session for shopper {shopperReference} with recurring enabled {enableRecurring}.

POST /payments Start a payment · Adyen Start a Transaction #

Ask an LLM

“How do I charge a shopper's card with Adyen Checkout?”

“Can I pay in installments or split the funds when I start a payment?”

Tell an agent

Charge {amount} with payment method {paymentMethod} on merchant {merchantAccount}, reference {reference}, return URL {returnUrl}.

Start a payment for shopper {shopperReference} and store the payment method {storePaymentMethod}.

POST /payments/details Submit extra details to finish a payment · Adyen Submit Details for a Payment #

Ask an LLM

“What call completes a payment after the shopper returns from a redirect?”

“Where do I send the 3D Secure result to finalize a payment?”

Tell an agent

Submit payment details {details} to complete the pending payment.

Finish the redirect payment with details {details} and payment data {paymentData}.

POST /payments/result Verify a payment result from the SDK · Adyen Verify a Payment Result #

Ask an LLM

“How do I confirm the final result of a payment the Checkout SDK returned?”

“Can I verify an SDK payment payload server-side?”

Tell an agent

Verify the payment result payload {payload}.

Check the outcome of the SDK payment using {payload}.

POST /payments/{paymentPspReference}/refunds Refund a captured payment · Adyen Refund a Captured Payment #

Ask an LLM

“How do I refund a payment that has already been captured?”

“Can I refund only part of a captured payment?”

Tell an agent

Refund {amount} of payment {paymentPspReference} on merchant {merchantAccount}.

Refund captured payment {paymentPspReference} for {amount} with reason {merchantRefundReason}, merchant {merchantAccount}.

POST /payments/{paymentPspReference}/reversals Reverse a payment whether captured or not · Adyen Refund or Cancel a Payment #

Ask an LLM

“What if I don't know whether a payment was captured and just want the money back to the shopper?”

“Does a reversal cancel an uncaptured payment instead of refunding it?”

Tell an agent destructive · confirm first

Reverse payment {paymentPspReference} on merchant {merchantAccount}.

Refund or cancel {paymentPspReference} in full for {merchantAccount} with reference {reference}.

Documentation

https://docs.adyen.com/marketplaces-and-platforms/classic/configure-notifications/

https://docs.adyen.com/api-explorer/Account/6/overview

https://docs.adyen.com/development-resources/webhooks/

https://docs.adyen.com/api-explorer/BalanceControl/1/overview

https://docs.adyen.com/api-explorer/BinLookup/52/overview

https://docs.adyen.com/api-explorer/Checkout/71/overview

https://docs.adyen.com/api-explorer/balanceplatform/2/overview

https://docs.adyen.com/api-explorer/balanceplatform-webhooks/1/overview

https://docs.adyen.com/development-resources/data-protection-api/

https://docs.adyen.com/risk-management/disputes-api

https://docs.adyen.com/marketplaces-and-platforms/classic/fund-transfer/

https://docs.adyen.com/marketplaces-and-platforms/collect-verification-details/hosted/

https://docs.adyen.com/marketplaces-and-platforms/legal-entity-management-api/

https://docs.adyen.com/api-explorer/Management/3/overview

https://docs.adyen.com/api-explorer/management-webhooks/3/overview

https://docs.adyen.com/marketplaces-and-platforms/classic/notifications

https://docs.adyen.com/point-of-sale/design-your-integration/notifications/

https://docs.adyen.com/online-payments/

https://docs.adyen.com/online-payments/online-payouts

https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/

https://docs.adyen.com/online-payments/tokenization

https://docs.adyen.com/api-explorer/report-webhooks/1/overview

https://docs.adyen.com/payment-methods/gift-cards/stored-value-api/

https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/terminal-api-reference/

https://docs.adyen.com/development-resources/testing/create-test-cards

https://docs.adyen.com/marketplaces-and-platforms/business-accounts/transactions/transaction-webhooks/

https://docs.adyen.com/api-explorer/transfer-webhooks/3/overview

https://docs.adyen.com/marketplaces-and-platforms/payout-to-users/on-demand-payouts

https://docs.adyen.com/development-resources/webhooks

Specifications

https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/openapi/adyen-payments-api-openapi.yml

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-payments-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

openapi: 3.2.0
info:
  version: '71'
  x-publicVersion: true
  title: Adyen Checkout Payments API
  description: This is the description of your API.
  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://checkout-test.adyen.com/v71
tags:


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