Documentação

A blockwallets permite que você aceite USDT e USDC, além de BTC, LTC e moedas nativas (creditadas em dólares americanos a uma cotação travada). Todas as integrações abaixo criam o mesmo tipo de cobrança na mesma página de pagamento hospedada, com as mesmas confirmações, taxas e saldo; muda apenas a forma como o seu sistema fala com a gente. Escolha a que combina com você e siga a página dela.

Escolha uma integração

Agrupadas pelo seu ponto de partida. Cada cartão abre o guia completo.

Sem código

Receba pelo painel do lojista; não há nada para instalar.

Nova integração por API

Você vai escrever a integração do zero.

Migrando de outro gateway

Mantenha o seu código: APIs compatíveis, então você só troca a URL base e as chaves.

Deixe a IA integrar

Para quem não escreve código, mas usa uma ferramenta de programação com IA.

Ferramentas

Ajuda de depuração que roda no seu navegador.

Compatível com a Cryptomus ou nativa?

As duas criam as mesmas cobranças na mesma página de pagamento, com as mesmas taxas e o mesmo saldo. A diferença está no estilo das requisições, no formato do webhook e em como você obtém as credenciais.

Está começando do zero? Use a API REST nativa: valores em centavos, ref idempotente, assinaturas de webhook com carimbo de tempo e chaves que você mesmo gera no painel. Já usa a Cryptomus, ou quer usar um SDK ou plugin da Cryptomus existente? Use a API compatível com a Cryptomus.

Início rápido

Do zero a um pagamento de teste em cinco passos (API compatível com a Cryptomus; as outras APIs seguem os mesmos passos com as próprias credenciais).

1. Solicite acesso na página inicial. Depois de aprovado, entre no painel do lojista.
2. Abra “Desenvolvedores › Integração e chaves” no painel, gere um merchant e uma API key na coluna Test e adicione os domínios do seu site.
3. O seu servidor cria uma cobrança com POST /v1/payment e redireciona o cliente para result.url.
4. Pague com “Simular pagamento” na página de pagamento e confira se o seu tratador de webhook verifica o sign e credita por payment_amount_usd.
5. Mude para as credenciais da coluna Live e pague uma vez um valor real pequeno (“Testar um pagamento” na página inicial do painel).

POST https://blockwallets.io/v1/payment
merchant: <merchant>
sign: md5(base64(body) + API key)
Content-Type: application/json

{
  "amount": "42.00",
  "currency": "USD",
  "order_id": "order_1042",
  "url_callback": "https://shop.example/webhooks/crypto",
  "url_return": "https://shop.example/cart",
  "url_success": "https://shop.example/thanks?order=1042"
}

O código em Node.js, PHP e Python de cada passo está na documentação da API compatível com a Cryptomus; se preferir que uma IA faça isso, comece pelo gerador de prompt.

Links de pagamento (sem código)

Painel do lojista → “Recebimentos › Links de pagamento” → informe uma descrição e um valor (fixe uma rede ou deixe o cliente escolher) → criar. Cada link tem uma URL e um QR code.

• Toda vez que alguém abre o link, uma nova cobrança é criada, então um mesmo link pode ser reutilizado (p. ex. “Plano de membros $99”).
• Cada pagamento aparece em “Recebimentos › Transações”; saque-o para a sua carteira em “Fundos › Saldo e saques”.
• Se você criou credenciais e uma URL de webhook em “Desenvolvedores › Integração e chaves”, os pagamentos feitos por links também são notificados, no formato de webhook compatível com a Cryptomus.
• Para parar de receber, clique em “Desativar” e o link deixa de funcionar imediatamente.

PDV para lojas

Para balcões e barracas: painel do lojista → “Recebimentos › PDV” → abra um terminal e pegue um link de PDV. A equipe abre no celular ou tablet, digita um valor e aparece um QR code de pagamento; quando o cliente paga, a tela mostra “Paid”.

• Uma cobrança de PDV vale por 30 minutos. Os pagamentos vão para o seu saldo e aparecem em “Recebimentos › Transações”, e você é notificado na sua URL de webhook como nos links de pagamento.
• Um link de PDV só pode receber pagamentos: ele não vê o seu saldo, saques, outros pedidos, configurações nem credenciais.
• Perdeu um aparelho ou um funcionário saiu? Revogue esse terminal no painel e o link dele deixa de funcionar imediatamente.

Botão incorporado

Painel do lojista → “Recebimentos › Links de pagamento” → “Botão incorporado”: escolha o texto, a cor, o tamanho e o formato e copie o trecho. Ao clicar no botão, abre-se a página de pagamento daquele link de pagamento.

• HTML simples: um link estilizado sem script, que funciona em qualquer lugar onde você possa colar HTML (construtores de sites, fóruns, assinaturas de e-mail).
• Com o script: adicione data-blockwallets e uma tag /embed.js; no computador a página de pagamento abre numa janelinha centralizada, no celular abre normalmente.
• O script não envia requisições, não grava cookies e não adiciona iframe. Se a página o bloquear, o botão continua sendo um link comum que funciona.

Nos trechos abaixo, troque /l/pl_… pelo endereço do seu próprio link de pagamento.

HTML simples

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   style="display:inline-flex;align-items:center;height:44px;padding:0 22px;border-radius:999px;background:#1f5a3d;color:#ffffff;font:600 16px/1 sans-serif;text-decoration:none">Pay with crypto</a>

HTML + script

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   data-blockwallets data-color="green" data-size="m" data-shape="pill">Pay with crypto</a>
<script src="https://blockwallets.io/embed.js" async></script>