# AGENTS.md — Adyen Documentation Mirror

This file provides guidance for AI agents and LLMs consuming this repository.

## Identity

This repository is a complete Markdown mirror of [docs.adyen.com](https://docs.adyen.com). It contains **2,419 pages** covering all Adyen products: online payments, in-person payments (POS), platforms/marketplaces, issuing, plugins, risk management, reporting, and more.

**Snapshot date:** June 2026
**Source:** https://docs.adyen.com/llms.txt

For the latest version of any page, append `.md` to the docs URL:
`https://docs.adyen.com/online-payments/build-your-integration/sessions-flow.md`

## How to navigate

Files mirror the `docs.adyen.com` URL structure. A section landing page sits alongside its child directory:

```
online-payments.md              ← Section overview
online-payments/
├── build-your-integration/
│   ├── sessions-flow.md        ← Integration guide
│   └── advanced-flow.md
├── 3d-secure.md
└── tokenization/
    └── managing-tokens.md
```

## Content guidance

### Navigation hub pages (~210 pages, mostly under `payment-methods/`)

Short pages (~1–2 KB) like `payment-methods/klarna/web.md` are **navigation hubs** — they link to platform-specific sub-pages (Drop-in, Component, API-only) but contain little prose. When you encounter one, follow the links to the actual integration guide:

```
payment-methods/klarna/web.md           ← Hub (thin), skip this
payment-methods/klarna/web-drop-in.md   ← Full guide, use this
payment-methods/klarna/web-component.md ← Full guide, use this
```

### Large filtered files

Some guides render all platform/version/integration-type combinations into a single file:

| File | Size | What's inside |
|------|------|--------------|
| `online-payments/build-your-integration/sessions-flow.md` | ~598 KB | Web + Android + iOS × Drop-in + Components × multiple versions |
| `online-payments/build-your-integration/advanced-flow.md` | ~1,068 KB | Same dimensions |
| `online-payments/release-notes.md` | ~750 KB | Full release notes timeline |

When using these files, extract only the section relevant to the user's platform, integration type, and version. Look for heading patterns like `## Web`, `## Android`, `### Drop-in`, `### Components` to locate the right block.

### Deprecated terminal manuals (~70 pages)

Pages under `point-of-sale/user-manuals/terminal-deprecation/` cover hardware instructions for older POS terminals (VX680, VX690, E315, E355, MX925). These are brief by nature. For current terminal documentation, prefer `point-of-sale/android-terminals/` and `point-of-sale/basic-tapi-integration/`.

### Interactive pages (~5 pages)

A few pages use a dynamic components that do not fully render to Markdown:
- `platforms/onboard-users/onboarding-steps.md`
- `industries/feature-packs.md`
- `marketplaces/onboard-users/onboarding-steps.md`

For these, the live site at `docs.adyen.com` has the complete interactive content.

## Related resources

- [adyen-openapi](https://github.com/Adyen/adyen-openapi) — OpenAPI specs for all Adyen APIs (JSON/YAML)
- [API Explorer](https://docs.adyen.com/api-explorer/) — interactive API reference with request/response examples
- [llms.txt](https://docs.adyen.com/llms.txt) — index of all Markdown page URLs
