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 é uma plataforma de tecnologia (software) que conecta cobranças PIX à liquidação em DePix executada pelo parceiro de liquidação (Eulen, emissora do DePix) na Liquid Network. A DepixPay não recebe o PIX nem custodia DePix: fornece a API, o painel, o plugin e o PDV. Sua API permite:
- Criar cobranças PIX com QR Code dinâmico
- Receber confirmações via webhook
- Consultar status de pagamentos
- Acompanhar a entrega do DePix (stablecoin 1:1 com BRL), feita pelo parceiro de liquidação, na sua carteira
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 DePix correspondente é enviado pelo parceiro de liquidação (Eulen) diretamente para a carteira Liquid cadastrada, após a janela antifraude
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)
Por determinação da Eulen (provedora do DePix) e como medida antifraude/proteção MED, todo merchant começa com delay de D+5 (120 horas) entre a confirmação do pagamento Pix e a conversão para DePix. A partir daí o delay é reduzido automaticamente, por nível, conforme a tabela abaixo.
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.
Níveis de prazo (redução automática):
| Nível | Prazo | Volume de clientes | Vendas | Clientes diferentes | Dias desde a 1ª venda | Dias sem MED |
|---|---|---|---|---|---|---|
| Inicial | D+5 (120h) | Entrada — todo merchant começa aqui (determinação da Eulen) | ||||
| Regular | D+3 (72h) | R$ 2.000 | 30 | 20 | 45 | 45 |
| Consolidado | D+2 (48h) | R$ 10.000 | 100 | 60 | 90 | 90 |
| Histórico | D+1 (24h) | R$ 30.000 | 300 | 150 | 150 | 150 |
| Verificado | 1h | Sob análise da equipe DepixPay | ||||
- O delay não pode ser alterado depois que o QR Code é gerado.
- A redução é automática: o nível é recalculado várias vezes ao dia e o delay novo vale para as cobranças geradas depois da mudança. Para subir, é preciso cumprir todos os critérios do nível; não se pula nível.
- Contam apenas vendas liquidadas a clientes. Pagamentos feitos com o CPF/CNPJ ou o EUID do próprio merchant e a ativação não entram em nenhum critério.
- Um MED volta a conta para o nível Inicial; para subir de novo é preciso o período sem MED exigido por cada nível.
- A primeira compra de um pagador novo na plataforma mantém piso de 48h, qualquer que seja o nível (exceto Verificado).
- A equipe DepixPay pode definir manualmente o delay de um merchant, inclusive o nível Verificado (1h).
- 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 de tecnologia DEPIX PAY | 1% do valor — remunera o uso do software; apurada pelo parceiro na própria liquidação (split) |
| Taxa fixa do parceiro de liquidação (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 é o software que permite aceitar pagamentos PIX na sua loja WooCommerce e receber em DePix — um ativo digital pareado 1:1 com o Real, emitido pela Eulen. O PIX é recebido pelos liquidantes da Eulen e o DePix é entregue na sua carteira pela Eulen (parceiro de liquidação); quando quiser, você pode solicitar o saque de DePix para PIX, também executado pelo parceiro.
- 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.
- O prazo é reduzido automaticamente, por nível (D+3 → D+2 → D+1), conforme o volume de vendas, o número de clientes, o tempo de conta e a ausência de MED. Os critérios estão na tabela de níveis dos Termos para desenvolvedores e no seu painel.
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
Há uma ativação cobrada uma única vez e, depois dela, você só paga quando recebe um pagamento.
- Ativação da conta (uma só vez, no cadastro): R$ 25 pagos por PIX de uma conta no seu próprio CPF/CNPJ. Desse valor, R$ 5,00 é a taxa de ativação e R$ 0,99 é a taxa da rede; os D$ 19,01 restantes são entregues na sua carteira.
- 1% do valor do pedido, a cada pedido recebido
- + R$ 0,99 fixo por transação
Exemplo: Pedido de R$ 100 → Você recebe R$ 98,01 em DePix
Sem mensalidade e sem fidelidade. A ativação é cobrada uma única vez, no cadastro. 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ê solicita o saque e o parceiro de liquidação (Eulen) envia o valor de volta 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 foi liberado pelo parceiro de liquidação. 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?
Solicite o Saque DePix → PIX no painel DepixPay: a conversão e o envio do PIX são executados pelo parceiro de liquidação (Eulen), e você envia o DePix da sua própria carteira. Alternativas: o bot da Eulen no Telegram (@EulenBot) ou plataformas do ecossistema Liquid que listam DePix. A DepixPay não compra nem vende DePix. Se o saque falhar por chave PIX inválida ou que não pertença ao seu CPF/CNPJ, o parceiro devolve o DePix ao seu endereço de devolução retendo 1 DePix; nos demais casos a devolução é integral.
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 (parceiro de liquidação que, com seus liquidantes, processa o PIX e entrega o DePix) e autoridades quando exigido por lei.
Natureza do Serviço (Aviso Legal)
A DEPIX PAY é uma empresa de tecnologia. Fornece o software — API, painel, plugin WooCommerce e aplicativo PDV — que gera cobranças PIX, transmite instruções ao parceiro de liquidação, acompanha o status do pagamento e exibe a confirmação. Ao usar o serviço, o lojista reconhece que:
- O PIX do pagador é recebido pelos liquidantes do parceiro de liquidação — a Eulen, emissora do DePix, que opera com instituições participantes do arranjo Pix — e nunca pela DepixPay. A DepixPay não recebe, não intermedeia nem guarda valores em reais e não mantém conta de passagem.
- O DePix é entregue pelo parceiro diretamente na carteira Liquid informada pelo lojista. A DepixPay não detém as chaves privadas dessa carteira e não custodia DePix de clientes.
- A DepixPay não compra, não vende, não troca e não converte ativos virtuais, não define cotação e não é contraparte de nenhuma operação. A conversão PIX ↔ DePix, inclusive no Saque DePix → PIX, é executada pelo parceiro de liquidação.
- A DepixPay não é instituição financeira, instituição de pagamento nem prestadora de serviços de ativos virtuais (Lei nº 14.478/2022 e regulamentação do Banco Central do Brasil). Atua como fornecedora de tecnologia para o parceiro de liquidação e para o lojista.
- A taxa de 1% remunera exclusivamente o uso da tecnologia DepixPay e é apurada pelo parceiro de liquidação na própria liquidação (split); a taxa fixa de R$ 0,99 pertence ao parceiro. Prazos, limites e regras de liquidação (QR Delay, MED, limites por CPF) são definidos pelo parceiro e podem ser alterados por ele.
- O DePix é um ativo virtual referenciado ao Real, emitido pela Eulen na Liquid Network. Não é moeda de curso legal, não é o Pix do Banco Central nem o Drex, e não conta com garantia do governo, do Banco Central ou do Fundo Garantidor de Créditos (FGC). Está sujeito a riscos de paridade, liquidez, custódia e de rede, e a eventual indisponibilidade do emissor ou do parceiro.
- A relação relativa à liquidação, à emissão e ao resgate do DePix se dá entre o lojista e o parceiro de liquidação, conforme os termos e políticas deste. A DepixPay não responde por atos, atrasos, bloqueios ou indisponibilidade do parceiro, do emissor ou da rede Liquid.
- O lojista é o único responsável pelas suas obrigações fiscais e regulatórias, inclusive pela declaração de criptoativos à Receita Federal e pelo cumprimento das regras aplicáveis à sua atividade. A DepixPay não presta assessoria jurídica, contábil, fiscal ou de investimento, e nenhum conteúdo do site ou do painel deve ser interpretado como tal.
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
- Não respondemos pela paridade, lastro, liquidez ou resgate do DePix, que são de responsabilidade do emissor
- O serviço é fornecido "como está" (as-is)
Tokenização de Real e Informação ao Cliente
Cada cobrança é liquidada pelo parceiro de liquidação (Eulen) em DEPIX — um token que representa o Real brasileiro na proporção 1:1 (stablecoin) na Liquid Network. Ao aceitar um pagamento:
- O pagador transfere via PIX em Reais; o valor correspondente é tokenizado pelo emissor e o lojista recebe em DEPIX na sua carteira Liquid — não em conta bancária.
- Responsabilidade do lojista: informar o cliente, antes do pagamento, de que o valor será tokenizado e liquidado em DEPIX. As telas oficiais de cobrança do DEPIX PAY (página de pagamento, plugin WooCommerce, links e PDV) já exibem esse aviso automaticamente; ao usar a API para montar um checkout próprio, o lojista é responsável por reproduzir o aviso de tokenização ao pagador antes do pagamento.
- Pagamentos PIX confirmados são irreversíveis na liquidação em DEPIX, ressalvados o MED do Banco Central e a janela antifraude (D+5) descrita acima.
- O CPF/CNPJ do pagador é coletado e enviado por exigência de compliance (Eulen/Banco Central).
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.