Migrando para a blockwallets
A blockwallets tem APIs compatíveis para três gateways. Encontre o seu abaixo: a tabela mostra as únicas coisas que você troca.
O que você troca
| Vindo de | Antes | Depois | Novas credenciais | Assinatura do webhook | |
|---|---|---|---|---|---|
| Cryptomus | https://api.cryptomus.com | https://blockwallets.io | merchant + API key | campo sign no corpo, md5(base64(…) + API key) | Guia completo → |
| NOWPayments | https://api.nowpayments.io/v1 | https://blockwallets.io/nowpayments/v1 | API key + IPN secret | x-nowpayments-sig (HMAC-SHA512) | Guia completo → |
| Coinbase Commerce | https://api.commerce.coinbase.com | https://blockwallets.io/coinbase/ | API key + webhook shared secret | X-CC-Webhook-Signature (HMAC-SHA256) | Guia completo → |
Além da API compatível com a Cryptomus, a blockwallets oferece APIs compatíveis com a NOWPayments e a Coinbase Commerce: caminhos, cabeçalhos de autenticação, campos de requisição / resposta, status e assinaturas de webhook seguem a documentação oficial delas, então o código existente normalmente precisa apenas de uma nova URL base e de novas chaves. A Coinbase Commerce deixou de atender lojistas fora dos EUA e de Singapura em 2026-03-31 — você pode migrar direto.
Por baixo é uma cobrança comum da blockwallets: os endereços de recebimento são seus, a página de pagamento é o nosso checkout hospedado, e um pagamento só vale depois de confirmado na blockchain e conferido com um segundo nó. A seguir: três passos, depois o que cada API suporta e como ela difere da original — parâmetros que não implementamos retornam erro em vez de serem ignorados em silêncio.
Modo de teste
Cobranças e pagamentos criados com credenciais de test rodam na testnet de cada rede e os webhooks deles são assinados com o IPN secret / shared secret de test — totalmente separados do live: uma chave de test não enxerga pagamentos live.
Todo o resto (checkout, confirmações, redes e mínimos, reembolsos) funciona como na documentação principal.