# Adyen Documentation — Markdown Mirror

A complete mirror of the public [Adyen documentation](https://docs.adyen.com) in raw Markdown format, designed for use with AI coding assistants, local search, and offline development workflows.

## What is this?

Adyen publishes Markdown versions of every documentation page at `docs.adyen.com`. This repository contains those pages as plain `.md` files, organized to match the site's information architecture.

## Why use this?

- **AI coding assistants** (Windsurf, Cursor, Claude, Copilot): Access these files as context for more accurate, less hallucination prone output about Adyen integrations
- **Offline development**: full docs access without internet connectivity
- **Token efficiency**: Markdown is smaller than equivalent HTML pages, reducing cost and improving context window utilization
- **Searchable**: use `grep`, `ripgrep`, or your IDE's search across the entire docs corpus

## Structure

The file tree mirrors `docs.adyen.com` URL paths served on `docs.adyen.com/llms.txt`.

```
online-payments.md                    # docs.adyen.com/online-payments
online-payments/
├── build-your-integration/
│   ├── sessions-flow.md              # docs.adyen.com/online-payments/build-your-integration/sessions-flow
│   └── advanced-flow.md
├── 3d-secure.md
├── tokenization/
│   ├── managing-tokens.md
│   └── ...
└── ...
```

### Sections

| Section | Pages | Description |
|---------|------:|-------------|
| `payment-methods/` | 966 | Integration guides for every payment method (cards, wallets, bank transfers, etc.) |
| `point-of-sale/` | 325 | Terminal API, POS device management, in-person payments |
| `platforms/` | 166 | Adyen for Platforms — onboarding, verification, split payments |
| `marketplaces/` | 134 | Marketplace-specific platform guides |
| `online-payments/` | 121 | Core online payment integration (Drop-in, Components, API-only) |
| `issuing/` | 90 | Adyen Issuing — card creation, funding, transaction management |
| `plugins/` | 73 | Adobe Commerce, Salesforce, Shopify integrations |
| `development-resources/` | 105 | API credentials, testing, webhooks, error handling |
| `risk-management/` | 58 | Disputes, chargebacks, fraud prevention |
| `reporting/` | 35 | Settlement, balance, and 3D Secure reports |
| Other sections | ~250 | Capital, Business accounts, Classic platforms, Unified commerce, etc. |

## Using with AI tools

### Windsurf / Cursor
Add this repository as a workspace folder or reference individual files as context.

### Claude / ChatGPT
Upload relevant `.md` files or paste their contents directly into conversation context.

### Programmatic use
```bash
# Search for all mentions of /payments endpoint
grep -r "POST /payments" --include="*.md" .

# Find all pages about 3D Secure
find . -path "*3d-secure*" -name "*.md"
```

## For AI agents

See [AGENTS.md](AGENTS.md) for structured guidance on navigating this repo, handling large filtered files, and known content limitations.

## Freshness

This snapshot was taken in **June 2026**. For the latest content, visit [docs.adyen.com](https://docs.adyen.com).

## Related resources

- [Adyen docs](https://docs.adyen.com): the live documentation site
- [llms.txt](https://docs.adyen.com/llms.txt): the index of all Markdown page URLs
- [adyen-openapi](https://github.com/Adyen/adyen-openapi): Adyen's OpenAPI specifications
- [adyen-api-explorer](https://docs.adyen.com/api-explorer/): interactive API reference
