Como integrar pagamento em cripto no meu site via API?

Para integrar pagamentos em cripto via API REST: você faz um POST para criar a cobrança, redireciona o cliente para o checkout hospedado, recebe um webhook assinado (HMAC-SHA256) quando o pagamento confirma e, se quiser, consulta o status por polling. A documentação fica em api.stackfy.io/docs — e há uma versão em Markdown pronta para colar numa IA/agente de código.

O fluxo da integração

Criar cobrança: POST /v1/invoices com o valor e a sua chave de API.
Checkout: redirecione o cliente para o checkout_url retornado (QR + endereço, hospedado pela Stackfy).
Webhook: quando o pagamento confirma, a Stackfy faz um POST assinado para a sua URL.
Status (opcional): GET /v1/invoices/{id} para consultar quando quiser.

Exemplo — criar uma cobrança

curl -X POST https://api.stackfy.io/v1/invoices \
  -H "Authorization: Bearer SEU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"price":"49.90","currency":"BRL","store_id":"SEU_STORE_ID"}'

A resposta traz o id da cobrança e o checkout_url para onde você manda o cliente.

Webhook assinado (não confie no redirect)

A confirmação vem por webhook assinado com HMAC-SHA256 (mesmo esquema do Stripe): o header X-Stackfy-Signature: t=…,v1=… permite validar que o evento veio mesmo da Stackfy. Sempre libere o pedido pelo webhook validado (ou pela consulta de status), nunca pelo que o cliente devolve no navegador.

Por que é fácil de integrar

Além de non-custodial e sem taxa por transação, a integração é enxuta: um endpoint para criar, um checkout pronto e um webhook assinado. E o mercado que você atende é enorme — no Brasil, as stablecoins dominam o volume:

Mais da metadedas compras em exchanges feitas em real (BRL) no Brasil, entre jul/2024 e jun/2025, foram de stablecoins como o USDT — exatamente o tipo de pagamento que a API da Stackfy processa nativamente. — Fonte: Chainalysis

A doc completa está em api.stackfy.io/docs, com uma versão em Markdown (docs.md) que um agente de IA consegue ler e gerar a integração.

Perguntas frequentes

Quais linguagens são suportadas?

Qualquer uma — é uma API REST com HTTP. A documentação traz exemplos em cURL, Node.js e PHP.

Como confirmo o pagamento com segurança?

Pelo webhook assinado (HMAC-SHA256, header X-Stackfy-Signature) ou pela consulta GET de status. Nunca confie no status vindo do navegador do cliente.

Preciso construir a tela de pagamento?

Não. O checkout (QR, endereço, timer e acompanhamento ao vivo) é hospedado pela Stackfy; você só redireciona para o checkout_url.

Onde vejo a documentação?

Em api.stackfy.io/docs (HTML) e api.stackfy.io/docs.md (Markdown pronto para colar numa IA).

Pronto para receber em cripto?

Sem custódia, sem % por transação. Comece em minutos.

Começar agora