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. 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 |
5. 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
6. 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
7. Documentação Completa
Acesse a documentação técnica completa em depixpay.com/docs
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. 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.
6. 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.
7. 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 de Devolução) que permite ao pagador contestar. Por isso limitamos a R$ 500 para clientes novos. Para pedidos maiores de clientes desconhecidos, considere aguardar alguns dias antes de enviar.
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.
8. 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.