# Dollr Developer Documentation (full index)

> Machine-readable index of https://docs.heydollr.app — Mintlify site, API v1, base URL https://api.heydollr.app

## Site

- Production: https://docs.heydollr.app
- OpenAPI: https://api.heydollr.app/openapi.json
- Merchant portal: https://merchant.heydollr.app
- Compact context: llms.txt

## Build with AI (Agentic development)

- /agentic-development — Overview (AI assistants, MCP, prompts, guardrails)
- /agentic-development/start-here — Env, rules snippet, llms.txt
- /agentic-development/prompt-library — Copy-ready AI prompts

## Changelog

- /changelog — Product and documentation updates (`<Update>` entries; edit `changelog.mdx` on main)

## Getting started

- / — Introduction hub (Card-based navigation)
- /quickstart — First collection (invoice flow, cURL/Python/Node)
- /guides/choose-integration — Pick invoice vs checkout vs payout vs realtime
- /authentication — OAuth 2.0 client credentials
- /api-conventions — JSON, phones, currencies, HTTP codes

## Integrate by stack

- /guides/collect-with-nodejs — JavaScript (fetch)
- /guides/collect-with-python — Python (requests)
- /guides/collect-with-django — Django (requests service)
- /guides/collect-with-ruby — Ruby (Net::HTTP)
- /guides/collect-with-php — PHP (cURL)
- /guides/collect-with-java — Java (HttpClient)
- /guides/collect-with-go — Go (net/http)
- /guides/collect-with-rust — Rust (reqwest)
- /guides/collect-with-dotnet — C# / .NET (HttpClient)
- /guides/collect-with-nextjs — Next.js Route Handlers / Server Actions
- /guides/collect-with-laravel — Laravel HTTP client

## Guides

- /guides/payout-with-nodejs — Payout flow (Node.js)
- /guides/collect-via-checkout — POST /v1/checkouts/create shortcut
- /guides/integration — Collection, payout, transfer, refund walkthroughs
- /guides/realtime-status — Realtime keys vs polling
- /guides/error-handling — Retries, idempotency, status codes

## Concepts

- /concepts/parties-and-counterparties — Party, counterparty, invoice vs order
- /concepts/sessions-and-executions — Sessions, executions, idempotency, dual status models

## API concept pages (link to /api-reference/* for schemas)

- /api/parties
- /api/counterparties
- /api/invoices
- /api/orders
- /api/checkouts
- /api/sessions
- /api/executions
- /api/status
- /api/payment-accounts
- /api/links
- /api/predictions
- /api/fees
- /api/merchants
- /api/realtime-keys

## Knowledge base

- /knowledge-base — Troubleshooting hub
- /knowledge-base/invalid-credentials-401
- /knowledge-base/forbidden-403-unverified
- /knowledge-base/validation-422
- /knowledge-base/duplicate-reference-id
- /knowledge-base/session-expired-or-invalid
- /knowledge-base/payment-processing-status
- /knowledge-base/rate-limit-429
- /knowledge-base/server-error-5xx

## Resources

- /reference/payments-by-market — Methods and providers by country
- /reference/error-catalog — Common errors and fixes (table + KB links)
- /reference/status-and-incidents — Polling, PROCESSING, incidents
- /reference/examples — OpenAPI, Postman, learning path
- /reference/ai-context — llms.txt, MCP manual setup, agent guardrails
- /reference/sdks
- /reference/glossary
- /reference/support

## API Reference (OpenAPI-generated)

Interactive paths under /api-reference/ — use OpenAPI JSON for complete operation list.

Key entry points:
- /api-reference/jwt/client-obtain-token
- /api-reference/parties/create-party
- /api-reference/invoices/create-invoice
- /api-reference/checkouts/create-checkout-source
- /api-reference/sessions/create-checkout-session
- /api-reference/executions/collect
- /api-reference/status/get-collection-status
- /api-reference/realtime-keys/get-collection-realtime-key

## Legacy redirects

/docs/* → equivalent root paths (see docs.json redirects)