📄 Documentação API

Base URL

https://api.depixpay.com/api/v1

Todas as requisições devem usar HTTPS. HTTP não é suportado.

🔐 Autenticação

Todas as requisições devem incluir sua API Key no header:

Authorization: Bearer dpx_sua_api_key_aqui

Sua API Key é gerada no momento do cadastro. Guarde-a em segurança — ela não pode ser recuperada.

📊 Limites (Compliance Eulen)

O DEPIX PAY segue as diretrizes de compliance da Eulen/Banco Central:

Erros de Limite

⏱️ QR Delay — Proteção Antifraude

Por orientação oficial da Eulen (provedora do DePix) e como medida de proteção contra fraudes, todo merchant recém-cadastrado começa com um delay de D+5 (120 horas) entre a confirmação do pagamento Pix e a conversão para DePix. Conforme o merchant constrói reputação com pagamentos confirmados, o delay pode ser reduzido pela nossa equipe.

Como funciona

1. Você cria a cobrança via POST /payment/create normalmente — sem precisar passar nenhum parâmetro extra.
2. O cliente paga o QR Code Pix instantaneamente.
3. O pagamento entra em status delayed aguardando a janela de proteção (D+5 por padrão).
4. Você recebe um webhook payment.delayed assim que o Pix é confirmado pela Eulen.
5. Após o delay expirar, o DePix é liberado na sua wallet e o status muda para completed com webhook payment.completed.

Tabela de delays por reputação

Consultando seu delay atual

O delay configurado para sua conta aparece em GET /merchant/me:

{
  "success": true,
  "data": {
    "id": "...",
    "name": "Sua Loja",
    "level_name": "Nível 1",
    "qr_delay_hours": 120,
    "qr_delay_label": "D+5",
    ...
  }
}

Resposta do /payment/create com delay ativo

Quando o delay está ativo, a resposta da criação do pagamento inclui qr_delay_hours e settlement_info:

{
  "success": true,
  "data": {
    "payment_id": "dep_abc123xyz",
    "amount": 100.00,
    "status": "pending",
    "qr_code": "00020126...",
    "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"
  }
}

Webhook payment.delayed

Quando o Pix é confirmado e o pagamento entra em janela de delay:

{
  "event": "payment.delayed",
  "payment_id": "dep_abc123xyz",
  "amount": 100.00,
  "status": "delayed",
  "qr_delay_hours": 120,
  "delay_ends_at": "2026-02-20T19:45:00Z"
}

Por que o D+5? MED — Mecanismo Especial de Devolução

O MED é um mecanismo do Banco Central que permite ao pagador solicitar devolução de um Pix em casos de fraude (golpe). Como o DePix é convertido após esta janela, o delay protege:

• O DepixPay e a Eulen contra estornos de Pix fraudulentos já convertidos em DePix.
• Você (merchant) contra ter sua conta encerrada por receber dinheiro de origem fraudulenta.
• A rede DePix como um todo, evitando lavagem via stablecoin.

💳 Pagamentos

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

{
  "success": true,
  "data": {
    "payment_id": "dep_abc123xyz",
    "amount": 100.00,
    "status": "pending",
    "qr_code": "00020126...",
    "qr_image_url": "https://response.eulen.app/...",
    "expires_at": "2026-02-15T20:00:00Z",
    "created_at": "2026-02-15T19:40:00Z"
  }
}

🏧 Saque (DEPIX → PIX)

Converta seu saldo em DEPIX de volta para reais via PIX. Modelo não-custodial: a API cria o saque e devolve um endereço Liquid; você envia o DEPIX da sua própria carteira para esse endereço e, após a confirmação on-chain, o PIX cai na sua chave. A plataforma nunca custodia seus fundos. Requer conta ativada (euid + CPF/CNPJ verificados).

{
  "success": true,
  "data": {
    "withdrawal_id": "wd_abc123def456ghij",
    "status": "unsent",
    "deposit_address": "lq1qq0z...seu-endereco-de-envio",
    "deposit_amount_cents": 5050,
    "payout_amount_cents": 5000
  },
  "notice": "Envie 50.50 DEPIX da sua carteira para deposit_address..."
}

Status do Saque

🔗 Links de Pagamento

Crie um link que você envia ao cliente. O QR só é gerado quando o cliente abre o link — a expiração conta a partir da abertura (não da criação), e o QR se renova automaticamente se expirar. Ideal para checkout de produtos.

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

A página pública coleta o CPF (se necessário), gera o QR ao abrir e acompanha o pagamento automaticamente. Você recebe o webhook payment.completed normalmente quando for pago.

🔔 Webhooks

Quando um pagamento muda de status, enviamos um POST para a URL configurada:

Payload do Webhook

{
  "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"
}

Eventos

❌ Códigos de Erro

Exemplo de Erro

{
  "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
}