# Paymee Developers

> Integrate the Paymee payment gateway: hosted checkout, signed webhooks, refunds, and idempotent REST writes.

Full text of every page concatenated for LLMs: https://docs.paymee.online/llms-full.txt

## Docs

- [Quickstart](https://docs.paymee.online/guides/quickstart.md): Create your first payment session and redirect a buyer to checkout in under 10 minutes.
- [Authentication](https://docs.paymee.online/guides/authentication.md): Authenticate API requests with your secret key, and understand the two credentials Paymee issues.
- [Hosted checkout flow](https://docs.paymee.online/guides/hosted-checkout.md): The full create-session, redirect, and result lifecycle for accepting a payment.
- [Webhooks](https://docs.paymee.online/guides/webhooks.md): Receive payment and refund events, verify their signature, and handle retries.
- [Fulfil an order](https://docs.paymee.online/guides/fulfil-an-order.md): Create a session for an order, redirect the buyer, and mark the order paid from a verified webhook.
- [Idempotency](https://docs.paymee.online/guides/idempotency.md): Safely retry session creation and refunds without creating duplicate payments or refunds.
- [Refunds](https://docs.paymee.online/guides/refunds.md): Issue full or partial refunds, retry them safely, and follow them to completion.
- [Testing](https://docs.paymee.online/guides/testing.md): Build against test mode with test cards before going live.
- [Amounts & currency](https://docs.paymee.online/guides/amounts-and-currency.md): Requested vs charged amounts, TND precision, and how foreign-currency requests are converted at your configured exchange rate.
- [Errors](https://docs.paymee.online/guides/errors.md): Paymee returns structured RFC 9457 problem documents with a stable error type catalog.
- [Versioning & deprecation](https://docs.paymee.online/guides/versioning.md): How the gateway API is versioned and how breaking changes are communicated.
- [Going live](https://docs.paymee.online/guides/going-live.md): The checklist to move from test mode to production safely.
- [Changelog](https://docs.paymee.online/guides/changelog.md): Changes to the Paymee merchant API and these docs.

## API reference

- [Merchant API reference](https://docs.paymee.online/reference/): full REST endpoint reference, generated from the OpenAPI spec.
- [OpenAPI specification (YAML)](https://docs.paymee.online/openapi/merchant-api.yaml): the machine-readable spec — every endpoint, webhook event and error.