# DepixPay — referência completa da API (llms-full.txt)

> Referência em markdown para LLMs e agentes de código. Resumo do produto e links: https://depixpay.com/llms.txt · Documentação humana: https://depixpay.com/docs.html · Versão em HTML da API: https://api.depixpay.com/api/v1/docs
> Idioma da documentação: português (pt-BR). Nomes de campos, endpoints e códigos de erro são literais — use-os exatamente como escritos.
> In English: DepixPay is a REST API to charge customers via PIX (Brazil's instant-payment system). The settlement partner (Eulen) delivers DEPIX — a BRL-pegged 1:1 stablecoin on the Liquid Network — to the merchant's own Liquid wallet. The merchant never needs a bank account to receive. Non-custodial. Base URL `https://api.depixpay.com/api/v1`. Auth: `X-API-Key` header, server-side only.

## 1. Conceitos essenciais

- **PIX** é o meio de pagamento do cliente final (brasileiro). **DEPIX** é a stablecoin atrelada 1:1 ao Real, emitida pela Eulen na Liquid Network (sidechain do Bitcoin). O cliente paga PIX; o parceiro de liquidação (Eulen) entrega DEPIX na carteira Liquid do lojista.
- A DepixPay é uma empresa de tecnologia: fornece API, painel, plugin WooCommerce, app PDV. **Não recebe reais, não custodia DEPIX, não define cotação, não compra/vende/troca ativos virtuais** e não é instituição financeira. O DEPIX é um ativo virtual — não é moeda de curso legal, não é o Pix do Banco Central nem o Drex e não tem garantia do governo, do Banco Central ou do FGC.
- **Tokenização:** o cliente deve ser informado de que o valor é liquidado em DEPIX *antes de pagar*. As telas oficiais (link de pagamento, plugin, PDV) já exibem o aviso; quem monta checkout próprio pela API precisa exibi-lo.
- **Ambiente:** só existe produção. Não há sandbox: toda chamada de cobrança é real.
- **Merchant** = lojista (a sua conta). **EUID** = identificador do titular na Eulen, capturado na ativação da conta.

## 2. Base URL, formato e autenticação

- Base URL: `https://api.depixpay.com/api/v1` (somente HTTPS).
- Corpo e respostas em JSON (`Content-Type: application/json`).
- Autenticação: header **`X-API-Key: dpx_...`** em toda rota marcada como AUTH. É o header usado pelo painel e pelo plugin, e o único liberado no CORS da API.
  - A página https://depixpay.com/docs.html exibe também `Authorization: Bearer dpx_...`. Se `X-API-Key` for recusado em algum cliente, teste o `Bearer`; em caso de dúvida, trate `X-API-Key` como canônico.
- A API Key é mostrada **uma única vez**, no cadastro. Nunca a coloque em código de frontend nem em repositório público: chame a API sempre pelo servidor. Se vazar, peça uma nova ao suporte.
- Envelope de resposta: `{ "success": true, "data": { ... } }` ou `{ "success": false, "error": "CODIGO", "message": "texto legível", ... }`.

```bash
curl https://api.depixpay.com/api/v1/merchant/me -H "X-API-Key: dpx_sua_api_key"
```

## 3. Preço e limites (valores em vigor na documentação)

- **Ativação única: R$ 25,00**, paga por PIX de conta da própria titularidade (mesmo CPF/CNPJ do cadastro). Composição: R$ 5,00 de taxa de ativação DepixPay + R$ 0,99 da rede; os **D$ 19,01** restantes voltam para a carteira Liquid do lojista. Serve para confirmar a titularidade e capturar o EUID.
- **Por PIX recebido: R$ 0,99 fixo (taxa do parceiro de liquidação) + 1% (taxa de tecnologia DepixPay)**, apurados na liquidação. Exemplo: cliente paga R$ 100,00 → taxas R$ 1,99 → lojista recebe **D$ 98,01** em DEPIX.
- Sem mensalidade nem fidelidade.
- Valor mínimo por cobrança: **R$ 10,00**. Máximo por transação: **R$ 5.000,00** (limite do QR dinâmico).
- QR Code expira em **20 minutos** (nos links de pagamento a contagem começa quando o cliente abre o link).
- Limites por CPF do pagador (proteção contra MED): 1ª compra de um CPF novo **R$ 500** (R$ 100 se o e-mail do lojista não estiver verificado — ver `FIRST_PURCHASE_LIMIT`), teto de **R$ 6.000/dia por CPF**; os limites do CPF sobem por faixas conforme o histórico confirmado.
- Limite diário do lojista: **R$ 500/dia** sem e-mail verificado; **R$ 3.000/dia** após verificar o e-mail. Sem verificar o e-mail não é possível criar cobranças e a conta é arquivada após 24 h.
- Há ainda limite de cobranças por hora (`RATE_LIMIT_EXCEEDED`, HTTP 429).
- O painel/vitrine descreve 7 níveis de volume diário do lojista; a tabela da vitrine (https://depixpay.com/sobre.html#niveis) é a referência vigente desses níveis e eles podem ser ajustados caso a caso.

## 4. QR Delay — janela antifraude da liquidação

Por determinação da Eulen, a liquidação em DEPIX passa por uma janela antifraude (proteção contra o MED — Mecanismo Especial de Devolução do Banco Central). **O PIX do cliente é confirmado na hora**; o atraso vale só para a entrega do DEPIX na carteira.

| Nível | Prazo | Critérios (todos) |
|---|---|---|
| Inicial | D+5 (120 h) | todo lojista começa aqui |
| Regular | D+3 (72 h) | R$ 2.000 em vendas, 30 vendas, 20 clientes diferentes, 45 dias desde a 1ª venda, 45 dias sem MED |
| Consolidado | D+2 (48 h) | R$ 10.000, 100 vendas, 60 clientes, 90 dias, 90 dias sem MED |
| Histórico | D+1 (24 h) | R$ 30.000, 300 vendas, 150 clientes, 150 dias, 150 dias sem MED |
| Verificado | 1 h | whitelist definida pela equipe DepixPay |

- Contam só vendas liquidadas (`completed`) a clientes; pagamentos com o CPF/CNPJ/EUID do próprio lojista e a ativação não entram. Um MED devolve a conta ao nível Inicial. O nível é recalculado várias vezes ao dia; o novo prazo vale para cobranças criadas depois da mudança.
- O delay é fixado **no momento da criação** do QR e não muda depois.
- Piso de 1 h (a Eulen aboliu a liquidação imediata em 30/06/2026). A 1ª compra de um pagador sem histórico na plataforma tem piso de **48 h**, independente do nível (não vale para whitelist).
- Fluxo de status: `pending` → (PIX pago) `delayed` → (janela cumprida) `completed`.
- O nível atual e o progresso aparecem em `GET /merchant/me` (campo `delay_tier`, além de `qr_delay_hours` e `qr_delay_label`, ex.: `"D+5"`).
- A resposta de `POST /payment/create` pode trazer `qr_delay_hours` e `settlement_info` (texto explicando a liquidação).

## 5. Endpoints

Convenção: `AUTH` = exige `X-API-Key`; `PÚBLICO` = sem chave. Rotas marcadas com † aparecem no painel ou na documentação em HTML da API, mas não na página docs.html — confirme o formato com uma chamada real antes de depender delas.

### 5.1 Cadastro e conta

**`POST /merchant/register`** — PÚBLICO. Cria a conta e devolve a API key (única vez).

Corpo (o formulário https://depixpay.com/register.html envia exatamente estes campos):

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `name` | string | sim | Nome do lojista (2–100 caracteres) |
| `email` | string | sim | E-mail (verificação por link) |
| `tax_number` | string | sim | CPF (11 dígitos) ou CNPJ (14), só números |
| `liquid_address` | string | sim | Endereço Liquid de recebimento (`lq1qq…`, `VJL…` ou `ex1q…`). **Endereço errado faz os fundos serem perdidos.** |
| `webhook_url` | string | não | URL padrão de webhooks (HTTP/HTTPS) |
| `turnstile_token` | string | condicional | Token anti-bot Cloudflare Turnstile; a chave pública vem em `GET /public/fee` (`data.turnstile_site_key`). Para cadastro automatizado sem navegador, peça orientação ao suporte |

Resposta `201`: `{ "success": true, "data": { "id", "name", "liquid_address", "webhook_url", "level", "level_name", "current_limit", "total_confirmed", "is_active", "created_at", "api_key": "dpx_..." } }`. Erros vistos no formulário: `EMAIL_TAKEN`, `INVALID_EMAIL`, `INVALID_WEBHOOK`, `NAME_TAKEN` (409), `DB_ERROR`.

**`GET /merchant/verify?token=<token>`** — PÚBLICO. Verifica o e-mail (link enviado por e-mail; página https://depixpay.com/verify.html).

**`GET /merchant/me`** — AUTH. Dados da conta: `id`, `name`, `liquid_address`, `webhook_url`, nível, `qr_delay_hours`, `qr_delay_label`, `delay_tier`, `is_active`, `created_at`. Também é a rota que o login usa para validar uma API key.

**`PUT /merchant/update`** — AUTH. Atualiza `name`, `liquid_address`, `webhook_url` (todos opcionais).

**`POST /merchant/activate`** † — AUTH. Gera o PIX de ativação de R$ 25 (QR em `data`); quando o pagamento já foi feito e aguarda liquidação, devolve `awaiting_settlement`. Conta só fica ativa após a liquidação (em torno de 1 h) e a captura do EUID. Pelo painel: botão "Ativar conta".

**`GET /public/fee`** † — PÚBLICO. Valores de taxa vigentes e a chave pública do Turnstile.

### 5.2 Cobranças PIX

**`POST /payment/create`** — AUTH. Cria a cobrança e devolve o QR Code.

| Campo | Tipo | Status | Descrição |
|---|---|---|---|
| `amount` | number | obrigatório | Valor em reais (ex.: `100.00`). Mínimo R$ 10, máximo R$ 5.000 |
| `customer_cpf` | string | obrigatório* | CPF (11) ou CNPJ (14) do pagador — exigência da Eulen (antifraude). *Pode ser trocado por `euid` |
| `euid` | string | alternativa | Identidade Eulen do pagador. Envie `euid` **ou** `customer_cpf` |
| `customer_name` | string | recomendado | Nome do pagador (máx. 100) |
| `customer_email` | string | opcional | E-mail do pagador (máx. 255) |
| `customer_phone` | string | opcional | Telefone com DDD (máx. 20) |
| `customer_address` | string | opcional | Endereço (máx. 500) |
| `description` | string | opcional | Descrição (máx. 200) |
| `external_id` | string | opcional | Seu ID de referência (máx. 50); volta no webhook |
| `webhook_url` | string | opcional | Sobrescreve a URL de webhook só desta cobrança |

Pagamentos feitos de conta de outra titularidade que a informada são **devolvidos** automaticamente.

```bash
curl -X POST https://api.depixpay.com/api/v1/payment/create \
  -H "X-API-Key: dpx_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00,
    "customer_name": "João Silva",
    "customer_cpf": "12345678901",
    "description": "Pedido #123",
    "external_id": "pedido_123"
  }'
```

Resposta `201`:

```json
{
  "success": true,
  "data": {
    "payment_id": "dep_abc123xyz",
    "amount": 100.00,
    "status": "pending",
    "qr_code": "00020126...",
    "qr_image_url": "https://response.eulen.app/...",
    "qr_delay_hours": 120,
    "settlement_info": "Após o pagamento Pix, a liquidação em DePix ocorrerá em 120h (D+5) — proteção antifraude/MED.",
    "expires_at": "2026-02-15T20:00:00Z",
    "created_at": "2026-02-15T19:40:00Z"
  }
}
```

`qr_code` é o "PIX copia e cola"; `qr_image_url` é a imagem do QR. Mostre um dos dois ao cliente.

**`GET /payment/{payment_id}/status`** — AUTH. Status atual (`payment_id`, `amount`, `status`, `created_at`, `updated_at`, …).

**`GET /payment/{payment_id}`** — AUTH. Registro completo, incluindo QR e dados do cliente.

**`GET /payments`** — AUTH. Últimos 50 pagamentos do lojista. (O painel usa `GET /payment/list`†.)

Status de pagamento:

| Status | Significado |
|---|---|
| `pending` | aguardando o PIX do cliente |
| `delayed` | PIX pago; aguardando a janela antifraude (QR Delay) |
| `completed` | janela cumprida e DEPIX liberado na carteira |
| `expired` | o QR expirou (20 min) |
| `cancelled` | cancelado |
| `refunded` | estornado (MED) |

Recomendação: depois de criar, consulte `GET /payment/{id}/status` a cada ~30 s enquanto o cliente paga, e/ou aguarde o webhook.

### 5.3 Links de pagamento

Um link é enviado ao cliente; o QR só é gerado quando ele abre a página (a expiração conta da abertura, e o QR se renova sozinho). A página pública coleta o CPF se necessário e acompanha o pagamento.

**`POST /payment/link`** — AUTH.

| Campo | Tipo | Status | Descrição |
|---|---|---|---|
| `amount` | number | obrigatório | Valor em reais |
| `type` | string | opcional | `single` (paga 1×, default) ou `product` (reutilizável). O painel também usa `subscription` (cobrança recorrente) † |
| `description` | string | opcional | Texto exibido ao cliente |
| `customer_cpf` | string | opcional | Se informado, o cliente não precisa digitar; se vazio, a página pede |
| `external_id` | string | opcional | ID do pedido na sua loja; volta no webhook. Use com `type: "single"` |
| `webhook_url` | string | opcional | URL a notificar quando o link for pago |
| `interval_days` | number | só em `subscription` † | Intervalo entre cobranças (default 30) |

Resposta: `{ "success": true, "data": { "token": "Ab3xY9...", "type": "single", "amount": 100.00, "url": "https://depixpay.com/p/Ab3xY9..." } }`.

**`GET /payment/links`** — AUTH. Lista os links (tipo, valor, status, quantidade de pagamentos).
**`GET /subscriptions`** † — AUTH. Lista assinaturas recorrentes. **`POST /subscription/{id}/cancel`** † — AUTH. Cancela uma assinatura.

Quando um link é pago você recebe o webhook `payment.completed` normalmente.

### 5.4 Saque (DEPIX → PIX), não-custodial

A DepixPay apenas orquestra o pedido; a conversão e o envio do PIX são do parceiro de liquidação (Eulen). Você cria o saque, recebe um endereço Liquid do parceiro e **envia o DEPIX da sua própria carteira** para esse endereço; após a confirmação on-chain o parceiro envia o PIX à sua chave. Requer conta ativada (EUID + CPF/CNPJ verificados).

**`POST /withdraw`** — AUTH. Informe exatamente um dos dois valores; o outro é calculado (taxa da Eulen já embutida).

| Campo | Tipo | Status | Descrição |
|---|---|---|---|
| `pixKey` | string | obrigatório | Chave PIX de destino (e-mail, telefone, aleatória, CPF/CNPJ), **registrada no mesmo CPF/CNPJ da conta**; chave de outra titularidade é recusada |
| `payoutAmountInCents` | number | obrigatório* | Valor a receber, em centavos de real. *Este **ou** `depositAmountInCents` |
| `depositAmountInCents` | number | alternativa | Valor de DEPIX a enviar, em centavos (exclusivo com o anterior) |
| `refundAddress` | string | opcional | Endereço Liquid para devolução do DEPIX se o saque não concluir. Padrão: o endereço Liquid cadastrado. Deve ir junto com a solicitação |

Resposta:

```json
{
  "success": true,
  "data": {
    "withdrawal_id": "wd_abc123def456ghij",
    "status": "unsent",
    "deposit_address": "lq1qq0z...",
    "deposit_amount_cents": 5050,
    "payout_amount_cents": 5000
  },
  "notice": "Envie 50.50 DEPIX da sua carteira para deposit_address..."
}
```

> **Nunca envie DEPIX depois que o endereço expirar — os fundos são perdidos.** Se o saque falhar por erro na solicitação (chave PIX inválida ou de outra titularidade), o parceiro devolve o DEPIX ao `refundAddress` retendo 1 DEPIX; nos demais casos a devolução é integral.

**`GET /withdraw/{id}`** — AUTH. Status (reconciliado com a Eulen em tempo real): `status`, `deposit_address`, `payout_amount_cents`, `blockchain_txid`, `receipt_url`, `refund_address`, `refund_txid`, `created_at`, `completed_at`.
**`GET /withdraw/list`** — AUTH. Seus saques, mais recentes primeiro.

Status do saque: `unsent` (aguardando você enviar o DEPIX) · `sending` (DEPIX recebido, processando o PIX) · `sent` (PIX enviado) · `canceled` · `refunded` (DEPIX devolvido) · `error`.

**`GET /user/{euid}/limits`** † — AUTH. Limites e volume diário de um usuário na Eulen (`dailyVolumeInCents`, `maxDailyInCents`, `isBlocked`, `dailyLimitResetTime`).

### 5.5 PDV / maquininha †

Rotas usadas pelo painel para parear terminais (Sunmi ou celular Android): `GET /merchant/pdv-activation-qr`, `POST /merchant/activate-pdv`, `GET /merchant/pdv-status`, `POST /merchant/pdv-devices/revoke` (corpo com `device_id`). O app é distribuído pelo painel (`/pdv/DepixPayPDV.apk`). As regras da loja (delay, limites, taxas) valem automaticamente em todos os terminais.

## 6. Webhooks

Quando o status de um pagamento muda, a DepixPay envia um `POST` com JSON à `webhook_url` (a do cadastro ou a da cobrança/link).

Eventos: `payment.delayed` (PIX confirmado, entrou na janela antifraude) · `payment.completed` (DEPIX liberado na carteira) · `payment.expired` (QR expirou sem pagamento) · `payment.refunded` (estornado).

Exemplo de payload:

```json
{
  "event": "payment.completed",
  "payment_id": "dep_abc123xyz",
  "external_id": "pedido_123",
  "amount": 100.00,
  "status": "completed",
  "customer_name": "João Silva",
  "customer_cpf": "12345678901",
  "completed_at": "2026-02-15T19:45:00Z"
}
```

`payment.delayed` inclui `qr_delay_hours` e `delay_ends_at`. A documentação em HTML da API mostra também um formato aninhado (`{ "event": "...", "data": { "payment_id", "external_id", ... } }`) e os cabeçalhos `X-Webhook-Event`, `X-Webhook-Timestamp` e `User-Agent: DepixPro-Webhook/1.0`. **Os dois formatos aparecem na documentação:** leia `event` e `payment_id` tanto na raiz quanto em `data` (`const p = body.data || body;`).

Requisitos do seu endpoint: aceitar `POST` JSON, responder HTTP `200–299` para confirmar (timeout de 10 s por tentativa; até 3 tentativas em caso de falha) e, de preferência, usar HTTPS.

**Validação:** a documentação **não descreve assinatura HMAC nem segredo compartilhado** — não invente uma verificação de assinatura. A defesa recomendada é: (1) tratar o webhook como *aviso*; (2) antes de liberar o pedido, consultar `GET /payment/{payment_id}/status` com a sua API key e conferir `status == "completed"` e o `amount`; (3) casar o pedido por `external_id`; (4) ser idempotente (o mesmo evento pode chegar mais de uma vez); (5) opcionalmente restringir o endpoint por URL não adivinhável.

## 7. Erros

Formato: `{ "success": false, "error": "CODIGO", "message": "..." }`. Erros de limite trazem campos extras (ex.: `daily_limit`, `daily_used`, `remaining`).

| Código | HTTP | Significado |
|---|---|---|
| `UNAUTHORIZED` | 401 | API key inválida ou ausente |
| `EMAIL_NOT_VERIFIED` | 403 | Verifique o e-mail antes de criar cobranças |
| `ACTIVATION_REQUIRED` | 403 | Conta não ativada: faça a ativação única de R$ 25 por PIX da própria titularidade (painel: "Ativar conta") |
| `PAYER_IDENTIFICATION_REQUIRED` | 400 | Falta `customer_cpf` ou `euid` |
| `INVALID_LIQUID_ADDRESS` | 400 | Endereço Liquid do lojista inválido — corrija antes de receber |
| `INVALID_AMOUNT` | 400 | Valor inválido ou ausente |
| `MIN_AMOUNT` | 400 | Abaixo do mínimo (R$ 10) |
| `SINGLE_TX_LIMIT` | 400 | Acima de R$ 5.000 por transação |
| `FIRST_PURCHASE_LIMIT` | 400 | CPF novo: máx. R$ 500 (verificado) / R$ 100 (não verificado) na 1ª compra |
| `CPF_DAILY_LIMIT` | 400 | CPF atingiu o limite diário (R$ 6.000) |
| `MERCHANT_DAILY_LIMIT` | 400 | Limite diário do lojista (R$ 500 / R$ 3.000) |
| `LIMIT_EXCEEDED` | 400 | Valor acima do limite do nível atual |
| `RATE_LIMIT_EXCEEDED` | 429 | Muitas cobranças por hora — aguarde |
| `INVALID_CPF` | 400 | CPF/CNPJ inválido |
| `VALIDATION` | 400 | Campo excede o tamanho máximo |
| `NAME_TAKEN` | 409 | Nome de lojista já existe |
| `NOT_FOUND` | 404 | Pagamento/recurso não encontrado |
| `PROVIDER_ERROR` | 502 | Erro no provedor PIX — tente de novo em alguns minutos |

```json
{ "success": false, "error": "CPF_DAILY_LIMIT",
  "message": "Limite diário de R$ 6.000,00 por CPF atingido",
  "daily_limit": 6000, "daily_used": 5500, "remaining": 500 }
```

## 8. Exemplos de código

### cURL — consultar status

```bash
curl https://api.depixpay.com/api/v1/payment/dep_abc123/status -H "X-API-Key: $DEPIX_KEY"
```

### Node.js — criar cobrança (servidor)

```js
const res = await fetch('https://api.depixpay.com/api/v1/payment/create', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-API-Key': process.env.DEPIX_KEY },
  body: JSON.stringify({
    amount: 25.5,
    description: 'Produto XYZ',
    customer_name: 'João Silva',
    customer_cpf: '12345678901',
    external_id: 'pedido_123',
  }),
});
const body = await res.json();
if (!body.success) throw new Error(`${body.error}: ${body.message}`);
const { payment_id, qr_code, qr_image_url, expires_at } = body.data;
```

### Node.js / Express — webhook (confirma no status antes de liberar)

```js
app.post('/webhook/depix', express.json(), async (req, res) => {
  const p = req.body.data || req.body;            // aceita os dois formatos
  const event = req.body.event;
  res.json({ received: true });                    // responda 2xx rápido (timeout 10 s)

  if (event !== 'payment.completed') return;
  const r = await fetch(`https://api.depixpay.com/api/v1/payment/${p.payment_id}/status`,
    { headers: { 'X-API-Key': process.env.DEPIX_KEY } });
  const s = (await r.json()).data;
  if (s && s.status === 'completed') {
    // marque o pedido p.external_id como pago (de forma idempotente)
  }
});
```

### Python — criar cobrança

```python
import os, requests
r = requests.post(
    "https://api.depixpay.com/api/v1/payment/create",
    headers={"X-API-Key": os.environ["DEPIX_KEY"], "Content-Type": "application/json"},
    json={"amount": 25.5, "description": "Produto XYZ", "customer_name": "João Silva",
          "customer_cpf": "12345678901", "external_id": "pedido_123"},
    timeout=15,
)
data = r.json()
if data["success"]:
    print(data["data"]["payment_id"], data["data"]["qr_code"])
else:
    print(data["error"], data["message"])
```

### PHP — criar cobrança

```php
<?php
$ch = curl_init('https://api.depixpay.com/api/v1/payment/create');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-API-Key: ' . getenv('DEPIX_KEY')],
  CURLOPT_POSTFIELDS => json_encode(['amount' => 25.5, 'description' => 'Produto XYZ',
    'customer_name' => 'João Silva', 'customer_cpf' => '12345678901', 'external_id' => 'pedido_123']),
]);
$body = json_decode(curl_exec($ch), true);
```

### cURL — saque

```bash
curl -X POST https://api.depixpay.com/api/v1/withdraw \
  -H "X-API-Key: $DEPIX_KEY" -H "Content-Type: application/json" \
  -d '{"pixKey":"sua-chave-pix","payoutAmountInCents":5000}'
# depois: envie o DEPIX informado ao deposit_address e acompanhe com GET /withdraw/{id}
```

## 9. Checklist de integração

1. Crie a conta em https://depixpay.com/register.html (e-mail, CPF/CNPJ, endereço Liquid) e guarde a API key.
2. Verifique o e-mail (libera cobranças) e ative a conta com o PIX único de R$ 25 da própria titularidade.
3. Crie cobranças pelo servidor (`POST /payment/create`) enviando `customer_cpf` ou `euid`; mostre `qr_code`/`qr_image_url` e o aviso de tokenização.
4. Receba `payment.completed` (e `payment.delayed`/`payment.expired`), confirme em `GET /payment/{id}/status` e dê baixa no pedido por `external_id`.
5. Saque quando quiser: `POST /withdraw`, envie o DEPIX ao endereço informado, acompanhe com `GET /withdraw/{id}`.
6. WooCommerce sem código: plugin em https://depixpay.com/depixpay-gateway.zip (veja https://depixpay.com/sobre.html#wordpress).

## 10. Avisos legais (resumo — texto integral em https://depixpay.com/sobre.html#aviso-legal e https://depixpay.com/terms.html)

A DepixPay é uma empresa de tecnologia; a liquidação em DEPIX é executada pelo parceiro de liquidação (Eulen). A DepixPay não recebe reais, não custodia DEPIX de clientes, não define cotação e não compra, vende, troca ou converte ativos virtuais; não é instituição financeira, instituição de pagamento nem prestadora de serviços de ativos virtuais. O DEPIX é um ativo virtual referenciado ao Real: não é moeda de curso legal, não é o Pix do Banco Central nem o Drex e não tem garantia do governo, do Banco Central ou do FGC. O lojista responde pela guarda da própria carteira e chaves, por informar o pagador sobre a tokenização antes do pagamento e pelo cumprimento das suas obrigações fiscais e legais.

## Fontes desta referência

https://depixpay.com/docs.html (docs do site, atualizada em 17/06/2026) · https://api.depixpay.com/api/v1/docs (HTML da API, 04/07/2026) · fluxos do painel e do cadastro em https://depixpay.com. Em divergência entre fontes, esta referência aponta a divergência no texto; confirme com uma chamada real antes de produção.