Este guia é para você que vai integrar o DEPIX PAY via API REST no seu sistema, app ou plataforma customizada.
1. O que é o DEPIX PAY?
O DEPIX PAY é um gateway de pagamentos que conecta o sistema PIX brasileiro com a rede Liquid Network. Sua API permite:
- Criar cobranças PIX com QR Code dinâmico
- Receber confirmações via webhook
- Consultar status de pagamentos
- Receber automaticamente em DePix (stablecoin 1:1 com BRL)
2. Como Funciona
-
Crie uma conta
Cadastre-se em depixpay.com/register e receba sua API Key -
Integre a API
Use nossa REST API para criar pagamentos. Exemplo:POST /api/v1/payment/create { "amount": 100.00, "customer_cpf": "12345678901", "customer_name": "João Silva" } -
Exiba o QR Code
A API retornaqr_code(texto) eqr_image_url(imagem PNG) -
Receba o webhook
Quando o cliente pagar, enviamos POST para sua URL com statuscompleted -
Receba em DePix
O valor é enviado automaticamente para sua carteira Liquid cadastrada
3. Limites de Transação
Seguimos as diretrizes de compliance da Eulen e Banco Central:
| Limite | Valor | Motivo |
|---|---|---|
| Máximo por transação | R$ 5.000 | Limite do QR Code dinâmico (imposição bancária) |
| Primeira compra por CPF | R$ 500 | Proteção contra fraudes MED |
| Limite diário por CPF | R$ 6.000 | Compliance Banco Central |
| Valor mínimo | R$ 10 | Viabilidade operacional |
MED (Mecanismo Especial de Devolução) permite que pagadores solicitem estorno alegando fraude. Golpistas podem pagar, receber seu produto, e depois pedir devolução. O limite de R$ 500 na primeira compra protege contra isso.
4. QR Delay — Janela Antifraude (D+5)
Em conformidade com orientação oficial da Eulen (provedora do DePix) e como medida antifraude/proteção MED, todo merchant recém-cadastrado opera com delay padrão de D+5 (120 horas) entre a confirmação do pagamento Pix e a conversão para DePix.
O que isso significa na prática:
- O Pix é pago e confirmado instantaneamente — seu cliente vê a aprovação em segundos.
- O DePix correspondente só é liberado na sua wallet Liquid após o período de delay.
- Durante a janela, o pagamento aparece com status
delayed. - Após o delay expirar (e nenhum estorno MED ocorrer), o DePix é liberado e o status muda para
completed.
Tabela de delays por reputação do merchant:
| Estágio | Delay | Equivalente |
|---|---|---|
| Novo (sem histórico) | 120 horas | D+5 (padrão) |
| Reputação inicial | 72 horas | D+3 |
| Reputação consolidada | 48 horas | D+2 |
| Histórico positivo extenso | 24 horas | D+1 |
| Parceiros verificados | 0 hora | Liquidação imediata |
- O delay não pode ser alterado depois que o QR Code é gerado.
- A redução do delay é avaliada caso a caso pelo time DepixPay e não é automática.
- O DepixPay e a Eulen reservam-se o direito de aumentar o delay a qualquer momento em caso de atividade suspeita.
- O delay não afeta a taxa cobrada nem a confirmação do Pix para o pagador.
5. Códigos de Erro
| Código | HTTP | Quando ocorre |
|---|---|---|
SINGLE_TX_LIMIT | 400 | Valor > R$ 5.000 |
FIRST_PURCHASE_LIMIT | 400 | CPF novo + valor > R$ 500 |
CPF_DAILY_LIMIT | 400 | CPF atingiu R$ 6.000 no dia |
MIN_AMOUNT | 400 | Valor < R$ 10 |
INVALID_CPF | 400 | CPF/CNPJ inválido |
UNAUTHORIZED | 401 | API Key inválida |
6. Taxas
| Taxa DEPIX PAY | 1% do valor |
| Taxa fixa Eulen | R$ 0,99 por transação |
Exemplo: Pagamento de R$ 100 → Você recebe 98,01 DePix
7. Suas Responsabilidades
- Segurança da API Key: Nunca exponha em frontend ou repositórios públicos
- Validação: Valide os dados antes de enviar para nossa API
- Webhook: Implemente idempotência — podemos reenviar em caso de falha
- Custódia: Você é responsável pela sua carteira Liquid
- Uso lícito: Não processe pagamentos para atividades ilegais
8. Documentação Completa
Acesse a documentação técnica completa em depixpay.com/docs — incluindo a seção dedicada ao QR Delay.
Este guia é para você que tem uma loja WordPress/WooCommerce e quer aceitar PIX de forma simples, sem programação.
1. O que é o DEPIX PAY?
O DEPIX PAY é uma forma de aceitar pagamentos PIX na sua loja WooCommerce e receber em DePix — uma moeda digital pareada 1:1 com o Real, que você pode converter de volta para PIX quando quiser.
- Receba PIX sem precisar de conta PJ ou maquininha
- Confirmação automática do pagamento
- Pedido atualizado automaticamente no WooCommerce
- Sem mensalidade — pague apenas por transação
2. Como Instalar
-
Crie sua conta DEPIX PAY
Acesse depixpay.com/register, informe seu email e endereço Liquid. Guarde a API Key que será gerada. -
Baixe o plugin
Faça download do plugin em depixpay.com/wordpress (arquivo .zip) -
Instale no WordPress
Vá em Plugins → Adicionar Novo → Enviar Plugin e selecione o arquivo .zip -
Configure
Em WooCommerce → Configurações → Pagamentos → DEPIX PAY, cole sua API Key -
Pronto!
Seus clientes já podem pagar com PIX no checkout
3. Como Funciona na Prática
Para seu cliente:
- Ele escolhe "Pagar com PIX" no checkout
- Aparece um QR Code na tela
- Ele escaneia com o app do banco e paga
- A página atualiza automaticamente: "Pagamento confirmado!"
- Ele recebe o email de confirmação do pedido
Para você:
- O pedido muda para "Processando" automaticamente
- Você recebe DePix na sua carteira Liquid
- Quando quiser, converte DePix de volta para PIX
4. Limites Importantes
Por questões de segurança bancária, existem alguns limites:
| Situação | Limite | O que significa |
|---|---|---|
| Pedido máximo | R$ 5.000 | Valor máximo por pedido único |
| Cliente novo | R$ 500 | Na primeira compra, limite é menor (proteção contra golpes) |
| Mesmo cliente por dia | R$ 6.000 | Um CPF pode gastar até R$ 6.000/dia na sua loja |
| Pedido mínimo | R$ 10 | Abaixo disso, taxas não compensam |
Se um cliente que nunca comprou tentar fazer um pedido de R$ 2.000, o pagamento será recusado. Isso é uma proteção contra golpes — após a primeira compra confirmada, o limite aumenta.
5. Recebimento em DePix — Janela D+5 para Lojas Novas
Por orientação oficial da Eulen (parceira que opera o DePix), lojas recém-cadastradas recebem o DePix em D+5 (5 dias após o pagamento Pix). Isso é uma proteção contra fraudes:
- O cliente paga o Pix e recebe a confirmação na hora — o pedido entra normalmente no WooCommerce.
- O DePix correspondente chega na sua carteira Liquid após 5 dias.
- Esse prazo serve como janela do MED (Mecanismo Especial de Devolução do Banco Central), durante a qual o pagador pode contestar o Pix em caso de golpe.
- Conforme sua loja acumula vendas confirmadas, esse prazo é reduzido progressivamente (D+3 → D+2 → D+1 → imediato).
Recomendação: não envie produtos físicos caros para clientes desconhecidos antes do DePix cair efetivamente na sua carteira. Para clientes recorrentes ou produtos digitais de baixo valor, o risco é mínimo.
6. Taxas
Cobramos apenas quando você recebe um pagamento:
- 1% do valor do pedido
- + R$ 0,99 fixo por transação
Exemplo: Pedido de R$ 100 → Você recebe R$ 98,01 em DePix
Sem mensalidade. Sem taxa de adesão. Sem surpresas.
7. O que é DePix? Preciso entender de cripto?
Não! Você não precisa entender de criptomoedas.
DePix é apenas a forma como você recebe o dinheiro. Pense assim:
- Seu cliente paga R$ 100 em PIX
- Você recebe 100 DePix (vale R$ 100)
- Quando quiser, você converte de volta para R$ 100 em PIX
A única coisa que você precisa é de uma carteira Liquid (como a Green Wallet) para receber os pagamentos.
8. Perguntas Frequentes
E se o cliente não pagar o PIX?
O QR Code expira em 20 minutos. O pedido fica como "Aguardando pagamento" e você pode cancelar manualmente depois.
E se eu vender algo e o cliente pedir estorno?
O Banco Central tem o MED (Mecanismo Especial de Devolução) que permite ao pagador contestar Pix em casos de fraude. Por isso aplicamos duas camadas de proteção: (1) limite de R$ 500 para clientes novos, e (2) janela de D+5 antes da liquidação do DePix para lojas novas — assim, se houver MED, o DePix ainda não saiu do nosso sistema. Para pedidos físicos caros de clientes desconhecidos, recomendamos esperar o DePix cair efetivamente na sua wallet antes de despachar.
Como converto DePix de volta para PIX?
Use o bot da Eulen no Telegram (@EulenBot) ou faça swap em exchanges que listam DePix.
Funciona com quais temas?
Qualquer tema compatível com WooCommerce. Testamos com Storefront, Flatsome, Astra e outros populares.
9. Suporte
Problemas com a integração? Fale conosco:
- Email: [email protected]
- Telegram: @depixpay
📋 Termos Gerais (Ambas Modalidades)
Uso Permitido
O DEPIX PAY deve ser usado apenas para atividades lícitas. É proibido processar pagamentos relacionados a:
- Drogas, armas, produtos ilegais
- Lavagem de dinheiro ou financiamento de terrorismo
- Golpes, fraudes ou esquemas de pirâmide
- Qualquer atividade proibida por lei brasileira
Privacidade
Coletamos: email, endereço Liquid, dados dos pagamentos (valor, CPF do pagador). Usamos para: processar pagamentos, cumprir compliance, prevenir fraudes. Compartilhamos apenas com a Eulen (processador) e autoridades quando exigido por lei.
Isenção de Responsabilidade
- Não nos responsabilizamos por estornos via MED
- Não garantimos disponibilidade 100% do serviço
- Você é responsável pela custódia da sua carteira Liquid
- O serviço é fornecido "como está" (as-is)
Alterações
Podemos atualizar estes termos a qualquer momento. Alterações significativas serão comunicadas por email.
Aceitação
Ao criar uma conta ou instalar o plugin, você declara ter lido, entendido e concordado com todos os termos acima.