> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tagada.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Payments API reference

> Every public endpoint of the Payments API (V3), generated from its OpenAPI document.

> [!NOTE]
>
> **Preview.** The Payments API (V3) is live at `https://api.tagada.io/v1`, but it is not open to self-serve integrations yet: merchant secret keys cannot be created from the dashboard. Every merchant processes on [V2](https://docs.tagada.io/payments-api/v2-or-v3.md) today. Contact [api-support@tagadapay.com](mailto:api-support@tagadapay.com) if you plan a new integration.

This reference is generated from the Payments API's OpenAPI document, version `2026-11-01`. It lists the endpoints available to secret and publishable keys.

| | |
| - | - |
| Base URL | `https://api.tagada.io` (every path starts with `/v1`) |
| Authentication | `Authorization: Bearer <key>`. See [Authentication](https://docs.tagada.io/payments-api/authentication.md). |
| Version header | `Payments-Version: 2026-11-01`. See [Versioning](https://docs.tagada.io/payments-api/versioning.md). |
| Writes | `Idempotency-Key` required. See [Idempotency](https://docs.tagada.io/payments-api/idempotency.md). |
| Errors | See [Errors](https://docs.tagada.io/payments-api/errors.md). |

Each endpoint lists the scopes it needs (`x-scopes`) and whether a publishable key may call it (`x-publishable`). A publishable key can only call endpoints marked publishable, and only for the payment whose `client_secret` it sends.

The `Payments-Account` header is for platform keys only. Do not send it with a secret or publishable key.

Endpoints reserved to TagadaPay operators are not listed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.