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

# Introduction

> Understand concepts, prerequisites, and how the DoglyTdc Pay API works.

## Overview

The DoglyTdc Pay API is a REST API for integrating your application with DoglyTdc Pay: listing products, orders, and subscriptions, checking balance, creating webhooks, and requesting payment links and refunds via code.

DoglyTdc Pay accepts payments via **PIX** and **DoglyTdc Balance**. Credit card payment is not available.

### Base URL

```bash theme={null}
https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-pay/v1/
```

All endpoints are under this prefix. Example: the product list is `https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-pay/v1/products`.

![Screenshot: DoglyTdc Pay dashboard](https://mintcdn.com/dogly-tdc/qOnot79kPtISSKbW/images/pay/pay-dashboard.png?fit=max\&auto=format\&n=qOnot79kPtISSKbW\&q=85\&s=9e36adb112641383d49df6296ddd5d10)

DoglyTdc Pay dashboard

## Prerequisites

**1. DoglyTdc Account**

An active account on [doglytdc.dev](https://doglytdc.dev) with DoglyTdc Pay enabled.

**2. API Key**

A `client_id` (`dpk_…`) and a `client_secret` created in **DoglyTdc Pay › Integrations › DoglyTdc Pay API**.

**3. Correct Scopes**

Each endpoint requires scopes. Only select the ones your integration uses.

> [card] [Complete authentication guide](https://docs.doglytdc.dev/en/pay/authentication.md)
>
> How to create the key, send credentials, and select scopes.

## Request format

Every request includes the key in the `Authorization` header:

```http theme={null}
Authorization: Basic base64(client_id:client_secret)
Content-Type: application/json
```

## Response format

Responses are JSON. Lists are returned inside `data`:

```json theme={null}
{
  "data": [
    { "id": "8f0c…", "name": "Curso de exemplo", "price_cents": 1990, "currency": "BRL" }
  ]
}
```

Monetary values are always **integers in cents** (`1990` = R\$ 19.90) and the currency is specified in `currency` (`BRL` or `USD`).

### HTTP status codes

| Code | Description |
| - | - |
| `200` | Successful request |
| `201` | Resource created |
| `202` | Request received; requires your approval in DoglyTdc Pay |
| `400` | Invalid data |
| `401` | Missing, invalid, or revoked key |
| `403` | The key does not have the required scopes |
| `404` | Resource not found in this account |
| `429` | Rate limit reached |
| `503` | Service temporarily unavailable; try again |

## Actions that move money

Refunds and payment links **are not executed directly via the API**. The API responds with `202` and an `approval_id`, and you confirm it in **DoglyTdc Pay › Integrations › MCP**. This way, a leaked key will never withdraw money from your account on its own.

## Next steps

> [card] [First call in 5 minutes](https://docs.doglytdc.dev/en/pay/get-started/first-call.md)
>
> From scratch to the first response.

> [card] [Receive your first sale](https://docs.doglytdc.dev/en/pay/get-started/first-sale.md)
>
> Product, webhook, and incoming event.

> [card] [Webhooks guide](https://docs.doglytdc.dev/en/pay/concepts/webhooks.md)
>
> Events, signature, and retries.

> [card] [API reference](https://docs.doglytdc.dev/en/pay/api-reference/products/list.md)
>
> All endpoints with "Try it".


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