Um gateway de pagamento cripto é a ponte que liga a sua loja aos pagamentos digitais: o cliente paga, você recebe — sem maquininha e sem banco no meio. Com o DePix App, você aceita Pix e criptomoedas no seu site de duas formas, da mais simples à mais avançada: um botão “Pagar” que leva o cliente para uma página de pagamento pronta (sem programar) ou uma integração completa via API e webhooks — a documentação da API do DePix App tem a referência completa.

Em qualquer uma das formas, o cliente paga com um Pix comum, pelo app do banco dele, sem saber o que é cripto. Você recebe o valor em DePix — a stablecoin lastreada no real (1 DePix = 1 real) na Liquid Network — direto na sua Carteira Integrada não-custodial, com privacidade e controle. A seguir, os dois caminhos, passo a passo.

Parte 1: o botão “Pagar” com redirect (sem desenvolvedor)

Se você não é programador — ou quer a integração mais rápida possível — comece por aqui. A ideia é simples: quando o cliente clica em “Pagar” no seu site, ele vai para uma página de pagamento hospedada pelo DePix App (em pay.depixapp.com), paga com Pix ali e, ao terminar, volta para o seu site pelo campo redirect_url. Você não desenha página de pagamento, não gera QR code nem lida com o protocolo do Pix — tudo já vem pronto.

Um exemplo prático: o botão “Pagar com Pix” no seu site

Digamos que você venda uma camiseta de R$ 29,90. No seu site — seja WordPress/WooCommerce, Wix, Nuvemshop, Loja Integrada ou até um link na bio do Instagram — você coloca um botão “Pagar com Pix”. Há dois níveis, do mais fácil ao mais flexível.

1. Sem escrever código (o caminho da maioria dos lojistas). Crie um link de pagamento ou cadastre um produto no app — cada produto ganha um link permanente, no formato pay.depixapp.com/sua-loja/camiseta (veja o guia de link de pagamento e página de checkout). Depois, é só usar esse link como destino de um botão. No WordPress, por exemplo, adicione um bloco HTML personalizado com:

<a href="https://pay.depixapp.com/sua-loja/camiseta">Pagar com Pix</a>

Funciona em qualquer plataforma — WooCommerce, Wix, Nuvemshop, Loja Integrada, Linktree: é só colar o link no botão. Esse caminho resolve a grande maioria dos lojistas, sem uma linha de programação.

2. Com valor dinâmico (uma chamada de servidor). Quando o valor muda a cada pedido — um carrinho com vários itens, por exemplo — o seu site cria o checkout na hora e redireciona o cliente. É uma única chamada, que vemos a seguir.

Como criar o checkout e redirecionar o cliente

No fundo, criar uma cobrança dinâmica é uma única chamada. Quando o cliente clica em “Pagar”, o seu servidor envia um POST para /api/checkouts com o valor da compra (sempre em centavos), uma descrição e — o ponto-chave — a redirect_url para onde o cliente deve voltar depois de pagar. A resposta traz um campo payment_url: é para ele que você redireciona o cliente.

Veja a chamada mínima com curl:

curl -X POST https://depix-backend.vercel.app/api/checkouts \
  -H "Authorization: Bearer sk_live_<sua-chave>" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 2990,
    "description": "Camiseta tamanho M",
    "redirect_url": "https://minha-loja.com/obrigado"
  }'

O valor 2990 representa R$ 29,90 — lembre-se de que os valores vão sempre em centavos. A resposta chega com status 201 Created:

{
  "id": "chk_01jxxxxxxxxxxxxxxxxxxxxxx",
  "status": "pending",
  "amount": 2990,
  "payment_url": "https://pay.depixapp.com/chk_01jxxxxxxxxxxxxxxxxxxxxxx",
  "pix": {
    "qr_code": "00020126580014br.gov.bcb.pix..."
  }
}

Pegue o payment_url e redirecione o navegador do cliente para ele. Em qualquer linguagem de servidor isso é um redirect HTTP 302 simples. O cliente verá a página de pagamento do DePix App, escaneia o QR code ou copia o código Pix no app do banco, paga e é enviado de volta para a sua redirect_url — no exemplo, https://minha-loja.com/obrigado. Pronto: você aceitou Pix no seu site sem construir nada do zero.

Parte 2: integração completa via API e webhooks

A Parte 1 já resolve a maioria dos casos. Mas se você administra uma loja com pedidos, estoque e baixa automática, vai querer confirmar o pagamento programaticamente — sem depender do cliente voltar para a página de obrigado. É aqui que entram as chaves de API e os webhooks.

A API do DePix App usa uma chave no header Authorization em todos os requests autenticados, no formato Bearer sk_live_<sua-chave>. Existem dois tipos de chave¹:

  • sk_test_ — chaves de teste, liberadas automaticamente quando você cria sua conta de lojista. Nenhum dinheiro real é movimentado. Use para integrar contra o sandbox.
  • sk_live_ — chaves de produção, que movimentam dinheiro de verdade. Exigem aprovação manual: na área de API Keys, clique em “Solicitar acesso”, responda algumas perguntas curtas sobre sua integração e a equipe avalia.

Guarde a chave com segurança — ela só é exibida uma vez no momento da criação. A URL base de todos os endpoints é https://depix-backend.vercel.app, e todos os valores monetários são inteiros em centavos.

Confirmando pagamentos com webhooks

Quando o status de um checkout muda, a API envia um POST para o callback_url que você informou na criação. Esse é o jeito robusto de saber que o pagamento caiu: em vez de ficar consultando a API, você recebe o aviso automaticamente. Basta incluir o campo callback_url ao criar o checkout:

{
  "amount": 2990,
  "description": "Camiseta tamanho M",
  "callback_url": "https://minha-loja.com/webhook/depix",
  "redirect_url": "https://minha-loja.com/obrigado",
  "metadata": { "order_id": "ORD-123" }
}

O campo metadata carrega dados do seu sistema (como order_id) e volta intacto em cada webhook — ideal para amarrar o pagamento ao pedido certo. Os eventos principais são checkout.processing (Pix recebido, em conversão) e checkout.completed (pagamento confirmado, DePix na carteira do lojista). Também existem checkout.cancelled e checkout.expired².

Dois cuidados essenciais de segurança e confiabilidade:

  • Valide a assinatura. Cada webhook traz o header X-DePix-Signature (HMAC-SHA256). Sempre confirme a assinatura antes de processar — assim você garante que o request veio mesmo do DePix App.
  • Seja idempotente. A entrega é “at-least-once”: o mesmo evento pode chegar mais de uma vez. Use o header X-DePix-Event-Id (estável entre tentativas) para deduplicar e nunca dar baixa em um pedido duas vezes.

Testando tudo no sandbox antes de ir ao ar

Nunca leve uma integração de pagamentos para produção sem testar. Com uma chave sk_test_, você cria checkouts de teste que ficam isolados dos reais: o campo is_live retorna false e o QR code gerado não é um Pix válido. Para simular o dinheiro caindo, chame o endpoint de simulação:

curl -X POST \
  https://depix-backend.vercel.app/api/checkouts/chk_01jxxxxxxxxxxxxxxxxxxxxxx/simulate-payment \
  -H "Authorization: Bearer sk_test_<sua-chave>"

Isso marca o checkout de teste como pago e dispara o webhook checkout.completed exatamente como num pagamento real — perfeito para validar sua integração de ponta a ponta. Só depois de tudo funcionar no sandbox, troque a chave sk_test_ pela sk_live_ e você está no ar.

Por que usar o DePix App como gateway de pagamento cripto

Usar o DePix App como gateway de pagamento cripto vai além da praticidade técnica. Cada pagamento que entra vira DePix na sua Carteira Integrada — uma carteira não custodial, em que as chaves ficam no seu dispositivo e o app nunca segura seus fundos. Você mantém controle e privacidade sobre o que recebe, sem maquininha, sem CNPJ obrigatório e sem prazos de recebimento de 30 dias.

A taxa de processamento é de 2% + R$ 0,99 por pagamento recebido³, competitiva com as taxas de cartão de débito — e sem o custo do hardware. O valor mínimo por checkout é de R$ 5,00. É importante lembrar do contexto de segurança: depósitos passam por uma janela antifraude de até 24 horas (D+1) antes de o DePix chegar na carteira, uma proteção contra golpes do Pix. Para vendas do dia a dia, esse modelo une o melhor dos dois mundos: a familiaridade do Pix para o cliente e a soberania da cripto para você.

E lembre-se do papel de cada ativo: DePix é dinheiro para gastar e receber com privacidade, não reserva de valor. Se a ideia é poupar a longo prazo, o Bitcoin (ou L-BTC, sua versão na Liquid) é a ferramenta certa — e você pode converter DePix nesses ativos direto pela Carteira Integrada quando quiser.

Referências

  1. DePix App — Documentação da API: Autenticação e checkouts
  2. DePix App — Webhooks e eventos de checkout
  3. Banco Central — Pix: o que é e como funciona

Sua loja, suas regras, sua privacidade

Pix tem praticidade — DePix tem privacidade e controle. Aceite pagamentos no seu site sem expor cada venda ao sistema bancário e receba em dinheiro digital que só você controla. Comece agora em depixapp.com.