# Paydro developer documentation

> Paydro helps organizers sell tickets, collect registrations and manage events and attendees.

The developer host serves documentation. API calls use your organizer/company origin; keep organizer credentials on your server.

## Start here

- [Organizer help](https://paydro.com/eng/support): Help with running events and managing bookings.
- [Developer portal](https://developer.paydro.com/en-us/): Integration documentation and API reference.
- [Paydro summary](https://developer.paydro.com/llm/summary.md): Choose an approach, understand access and find a goal guide.

## User goals

- [Sell tickets on my website](https://developer.paydro.com/llm/sell-tickets.md)
- [Use an existing shop link](https://developer.paydro.com/llm/use-shop-link.md)
- [Find my shop link in Paydro](https://developer.paydro.com/llm/find-shop-link.md)
- [Create a ticket shop for my website](https://developer.paydro.com/llm/create-ticket-shop.md)
- [Create a Paydro account](https://developer.paydro.com/llm/create-paydro-account.md)
- [Show our events](https://developer.paydro.com/llm/show-events.md)
- [Set up an event](https://developer.paydro.com/llm/set-up-event.md)
- [Manage ticket options](https://developer.paydro.com/llm/manage-tickets.md)
- [Collect attendee information](https://developer.paydro.com/llm/collect-attendee-information.md)
- [Match our branding and language](https://developer.paydro.com/llm/branding-and-language.md)
- [Manage guest registrations](https://developer.paydro.com/llm/guest-registrations.md)
- [Help customers with bookings](https://developer.paydro.com/llm/help-with-bookings.md)
- [Handle cancellations and refunds](https://developer.paydro.com/llm/cancellations-and-refunds.md)
- [Communicate with attendees](https://developer.paydro.com/llm/communicate-with-attendees.md)
- [Connect our other tools](https://developer.paydro.com/llm/connect-other-tools.md)
- [Understand event performance](https://developer.paydro.com/llm/event-performance.md)
- [Accept invoice payments](https://developer.paydro.com/llm/accept-invoice-payments.md)
- [Configure payment providers](https://developer.paydro.com/llm/configure-payment-providers.md)
- [Understand payouts and settlement](https://developer.paydro.com/llm/understand-payouts.md)
- [Prepare financial records](https://developer.paydro.com/llm/financial-records.md)
- [Manage entry at the event](https://developer.paydro.com/llm/manage-entry.md)
- [Fix and verify an integration](https://developer.paydro.com/llm/fix-integration.md)

## Discovery and downloads

- [API catalog](https://developer.paydro.com/.well-known/api-catalog): Machine-readable links to the API and its documentation.
- [Complete documentation](https://developer.paydro.com/llms-full.txt): Summary, all 22 goal guides and all developer Markdown guides in one file.

## API contract

- [OpenAPI](https://developer.paydro.com/openapi/v2.json): Existing API operations, schemas and examples.

## Guides

- [Getting started](https://developer.paydro.com/en-us/docs/getting-started.md): Build your first integration with a ticket shop or a read request to the Paydro API.
- [Authentication](https://developer.paydro.com/en-us/docs/authentication.md): Authenticate server requests with Paydro organizer credentials over HTTPS.
- [API basics](https://developer.paydro.com/en-us/docs/api-basics.md): Understand service origins, v2 routes, JSON resources, and response conventions.
- [Permissions](https://developer.paydro.com/en-us/docs/permissions.md): Understand organizer, company, and event access for integrations.
- [Testing your integration](https://developer.paydro.com/en-us/docs/testing.md): Verify requests, parsing, and recovery using an authorized test event.
- [Data types](https://developer.paydro.com/en-us/docs/data-types.md): Interpret identifiers, dates, money, flags, and optional legacy fields.
- [Writing data](https://developer.paydro.com/en-us/docs/writing-data.md): Send authenticated organizer writes, validate legacy results, and handle retries and side effects.
- [Pagination and filtering](https://developer.paydro.com/en-us/docs/pagination-and-filtering.md): Use CakePHP page parameters and the supported resource filters.
- [Handling errors](https://developer.paydro.com/en-us/docs/errors.md): Check HTTP status and legacy response bodies before processing data.
- [Rate limits and retries](https://developer.paydro.com/en-us/docs/rate-limits-and-retries.md): Handle authentication throttling and transient failures without duplicate imports.
- [Working with events](https://developer.paydro.com/en-us/docs/events.md): Find accessible event IDs and retrieve the v2 event resource.
- [Ticket products](https://developer.paydro.com/en-us/docs/ticket-products.md): Retrieve an event’s ticket products and understand purchased ticket records.
- [Product management](https://developer.paydro.com/en-us/docs/product-management.md): Create, edit, remove and reorder ticket products, including packages, pricing tiers and shared pools.
- [Product availability](https://developer.paydro.com/en-us/docs/product-availability.md): Interpret configured capacity, computed stock, pending holds, shared pools, packages and sales windows.
- [Categories](https://developer.paydro.com/en-us/docs/categories.md): Read, create, update, hide and delete event ticket categories, with their registration question definitions.
- [Category questions](https://developer.paydro.com/en-us/docs/ticket-questions.md): Read and manage category question definitions, order registration questions, and refresh existing ticket snapshots.
- [Question types and answers](https://developer.paydro.com/en-us/docs/question-types.md): Supported category question types, option formats, attendee answer payloads and historical registration data.
- [Working with orders](https://developer.paydro.com/en-us/docs/orders.md): Read paginated orders, individual order details, and compact snapshots.
- [Order management](https://developer.paydro.com/en-us/docs/order-management.md): Edit billing data, confirm or drop reservations, resend messages, mark invoices paid, and cancel eligible orders.
- [Working with attendees](https://developer.paydro.com/en-us/docs/attendees.md): Read order lines, attendee registration data, and check-in status.
- [Attendee management](https://developer.paydro.com/en-us/docs/attendee-management.md): Edit attendee contact fields and answers, change products, manage archived questions, and resend tickets.
- [Waiting lists](https://developer.paydro.com/en-us/docs/waiting-lists.md): List waiting-list entries, read invitation details, invite or remove entries, and configure phone requirements.
- [Promo codes and invitations](https://developer.paydro.com/en-us/docs/promo-codes.md): Create and manage event promo codes, read used-code labels, and queue invitations with per-recipient results.
- [Ticket check-in](https://developer.paydro.com/en-us/docs/check-in.md): Record authorized ticket check-in, interpret repeat scans, remove scans and export attendance.
- [Event traffic analytics](https://developer.paydro.com/en-us/docs/analytics.md): Read traffic totals, recent visits, UTM sources and cities from the organizer analytics projection.
- [Notes and organizer data](https://developer.paydro.com/en-us/docs/supporting-data.md): Read companies and organizer profiles, manage event favorites, and add or edit authorized event, order and attendee notes.
- [Stage state and live updates](https://developer.paydro.com/en-us/docs/stages.md): Read public stage state, replace it as an event editor, and receive server-sent updates.
- [Files](https://developer.paydro.com/en-us/docs/files-and-exports.md): Upload and remove event files, protect bearer download links, and download invoice and ticket PDFs.
- [Exports](https://developer.paydro.com/en-us/docs/exports.md): Download event orders, attendees, waiting lists, check-ins and no-shows as authorized CSV or Excel exports.
- [Integration recipes](https://developer.paydro.com/en-us/docs/integration-recipes.md): Build a complete event catalog, update attendee answers, and issue and track waiting-list invitations.
- [Synchronizing data](https://developer.paydro.com/en-us/docs/synchronizing-data.md): Combine full snapshots, weekly changes, and deletion identifiers safely.
- [API coverage and workflow limits](https://developer.paydro.com/en-us/docs/api-coverage.md): Choose documented JSON resources, identify organizer-only workflows, and understand API coverage and compatibility.
- [Embed a ticket shop](https://developer.paydro.com/en-us/docs/embed-ticket-shop.md): Add Paydro registration and checkout to your existing website.
- [Connect HubSpot](https://developer.paydro.com/en-us/docs/hubspot.md): Connect your Paydro organization to HubSpot and understand event synchronization.
- [Connect Mailchimp](https://developer.paydro.com/en-us/docs/mailchimp.md): Choose an audience and configure event subscriber synchronization.
- [Privacy and data handling](https://developer.paydro.com/en-us/docs/privacy-and-data.md): Keep personal data and integration credentials under your organization’s control.
- [Going live](https://developer.paydro.com/en-us/docs/going-live.md): Check service configuration, access, recovery, and support before launch.