> ## 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.

# Criar Link de Pagamento

> Pede um link de pagamento para um produto seu.

#### Escopo

```bash theme={null}
write payments
```

## O que faz

Pede um link de pagamento para um produto seu. Responde `202`; o link fica pronto depois da sua aprovação.

## Casos de uso

* Gerar links por campanha
* Vender pelo chat ou por uma IA

**product\_id** `string\<uuid\>` *required*

ID de um produto ativo da sua conta.

## Resposta

**status** `string`

Sempre `approval_required`.

**approval\_id** `string\<uuid\>`

ID da aprovação pendente.

**expires\_at** `string\<date-time\>`

Prazo para aprovar.

## Erros

| Status | Descrição |
| - | - |
| `400` | `invalid_product`. |
| `404` | Produto não existe nesta conta. |
| `401` | Chave inválida ou revogada. |
| `403` | Faltam escopos (`insufficient_scope`). |
| `429` | Limite de requisições (`rate_limited`). |

```bash cURL theme={null}
curl --request POST \
  --url https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-pay/v1/payment-links \
  -u "$DPAY_CLIENT_ID:$DPAY_CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"8f0c2a8e-1b7d-4a55-9a3e-1c2d3e4f5a6b"}'
```

```json 202 theme={null}
{
  "status": "approval_required",
  "approval_id": "0e9d8c7b-6a5f-4e3d-9c2b-1a0f9e8d7c6b",
  "expires_at": "2026-11-06T18:40:00Z",
  "message": "Autorize no DoglyTdc Pay › Integrações › MCP."
}
```

```json 401 theme={null}
{ "error": "unauthorized", "message": "Chave de API inválida." }
```

```json 403 theme={null}
{ "error": "insufficient_scope", "message": "Esta chave precisa dos escopos: write, payments." }
```


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