Conecte Carteiras na Testnet
Cadastre-se em `/merchant/register`, configure seus endereços EVM, TRON e Solana e gere uma chave `sk_test_...`.
Migre para liquidação não custodial de 0.5% em 15 minutos.
Deixar para trás saldos retidos por processadores, taxas de 1%–1.5% ou APIs de comércio hospedado descontinuadas não exige reescrever seu banco de dados de pedidos. Mapeie 4 campos JSON, valide webhooks HMAC-SHA256 em corpo bruto na Testnet e direcione 99.5% direto para suas próprias carteiras.
10 Playbooks Dedicados de Migração por Provedor
Selecione seu gateway atual para ver diferenças exatas de campos JSON, adaptadores de webhook HMAC-SHA256 e guias de transição canary paralela em 15 minutos.
Migração em 12 Minutos
Abrir Playbook e Código →
Da NOWPayments
Legado: 0.5%–1.0% + taxas de conversão e de rede no saque
Migração em 10 Minutos
Abrir Playbook e Código →
Do Coinbase Commerce
Legado: taxa de protocolo de 1.0% (conjunto restrito de ativos/redes)
Migração em 15 Minutos
Abrir Playbook e Código →
Da BitPay
Legado: 1.0%–2.0% + custo de rede e liquidação D+1/D+2
Migração em 15 Minutos
Abrir Playbook e Código →
Do BTCPay Server
Legado: $0 de licença + $80–$350/mês de manutenção VPS/RPC/DevOps
Migração em 12 Minutos
Abrir Playbook e Código →
Da Cryptomus
Legado: 0.4%–2.0% + taxas de conversão e saque custodial
Migração em 12 Minutos
Abrir Playbook e Código →
Da CoinGate
Legado: ~1.0% de taxa de checkout + spreads de câmbio/repasse
Migração em 10 Minutos
Abrir Playbook e Código →
Do Stripe Pay with Crypto
Legado: 1.5% por transação (3x maior que a XPayr)
Migração em 15 Minutos
Abrir Playbook e Código →
Da CoinPayments
Legado: 0.5%–1.0% + taxas de varredura (sweeping) e rede de saque
Migração em 10 Minutos
Abrir Playbook e Código →
Da Helio (MoonPay Commerce)
Legado: 2.0% no plano gratuito ou assinatura Pro de $299+/mês + taxa
Migração em 15 Minutos
Abrir Playbook e Código →
Da Triple-A
Legado: ~1.0% + spread institucional de conversão cambial + liquidação bancária
NOWPayments IPN → Adaptador XPayr API v1 e HMAC-SHA256
Substitua callbacks `x-nowpayments-sig` de chaves ordenadas e filas de repasse custodial pela verificação de corpo bruto `X-XPayr-Signature` e liquidação instantânea na carteira do lojista.
| Conceito | AGORAPagamentos | Equivalente na XPayr |
|---|---|---|
| Criar Sessão | POST /v1/invoice (x-api-key) | POST /api/v1/payments (Authorization: Bearer sk_live_...) |
| Valor e Ref. do Pedido | price_amount, price_currency, order_id | amount, currency, order_id, metadata |
| Assinatura do Webhook | x-nowpayments-sig (HMAC-SHA512 em JSON ordenado) | X-XPayr-Signature (HMAC-SHA256 sobre corpo bruto — zero bugs de ordenação de chaves JSON) |
| Status de Liberação | finished / partially_paid | payment.completed / payment.underpaid_accepted (tolerância de 1%) |
// Drop-in Node.js Express webhook adapter (XPayr raw-body HMAC-SHA256)
import crypto from 'node:crypto';
export function verifyXpayrWebhook(rawBodyBuffer, signatureHeader, webhookSecret) {
const expected = crypto.createHmac('sha256', webhookSecret).update(rawBodyBuffer).digest('hex');
const provided = String(signatureHeader || '').replace(/^sha256=/i, '');
if (expected.length !== provided.length) return false;
return crypto.timingSafeEqual(Buffer.from(expected, 'utf8'), Buffer.from(provided, 'utf8'));
}
Cobranças Coinbase Commerce → Sessões de Checkout Duplo XPayr
Recupere USDT TRC-20 na TRON, transferências via QR de corretoras e disponibilidade global para lojistas mantendo a semântica familiar de `metadata` e `hosted_url`.
| Conceito | Coinbase Commerce | Equivalente na XPayr |
|---|---|---|
| Criar Checkout | POST /charges (X-CC-Api-Key) | POST /api/v1/payments (Authorization: Bearer sk_live_...) |
| Tipo de Preço | local_price.amount + pricing_type: fixed_price | amount + currency: "USD" |
| Redirecionamento Hospedado | data.hosted_url | data.checkout_url (suporta Modal SDK ou redirecionamento completo) |
| Evento Webhook | charge:confirmed / charge:resolved | payment.completed / payment.underpaid_accepted |
// Replace Coinbase Charge creation with @xpayr/node-sdk (v0.2.0)
import { XPayrClient } from '@xpayr/node-sdk';
const xpayr = new XPayrClient({ apiKey: process.env.XPAYR_SECRET_KEY });
const session = await xpayr.payments.create({
amount: '49.00',
currency: 'USD',
order_id: 'ord_90812',
success_url: 'https://app.example.com/billing/success',
metadata: { workspace_id: 'ws_441', plan: 'pro_annual' }
});
BitPay / CoinGate (1%–2% Custodial) → XPayr (0.5% Direto na Carteira)
Reduza as taxas de gateway em 50%–75% e elimine lotes de liquidação bancária custodial D+2 recebendo USDT/USDC nativos direto na sua própria carteira multisig ou hardware wallet.
| Conceito | BitPay e CoinGate | Equivalente na XPayr |
|---|---|---|
| Taxa de Checkout | 1.0%–2.0% + regras de liquidação/câmbio | Fixa 0.5% (50 bps), $0 mensal, $0 reserva rotativa |
| Plugins de E-Commerce | Módulos legados de carrinho custodial | 6 plugins v1.0.0 de código aberto em /integrations |
| Verificação de Callback | Token sem autenticação ou consulta reversa obrigatória | Criptográfica X-XPayr-Signature + @xpayr/payment-evidence |
| Destino de Tesouraria | Retido no saldo do processador até o repasse | Transferência on-chain imediata de 99.5% para sua carteira |
# Verify live XPayr session creation in 5 seconds via cURL:
curl -sS -X POST https://xpayr.com/api/v1/payments \
-H "Authorization: Bearer sk_test_your_key" \
-H "Content-Type: application/json" \
-d '{"amount":"100.00","currency":"USD","order_id":"mig_test_01","network":"tron","token":"USDT"}'
Adicione a XPayr ao Lado da Stripe (0.5% Cripto Global vs 1.5% Stripe Crypto)
Mantenha a Stripe para cartões locais se preferir e adicione a XPayr como seu botão global Pagar com Cripto (0.5%) para liberar USDT TRC-20 na TRON, Solana e retenção nativa de stablecoins em mais de 180 mercados.
| Critério | Pagamento com Cripto da Stripe | Trilho Cripto Paralelo da XPayr |
|---|---|---|
| Taxa de Stablecoins | 1.5% por transação | Fixa 0.5% (economize 66% em cada pedido cripto) |
| TRON TRC-20 e QR de Corretoras | Não suportado | Suporte completo a TRON TRC-20 USDT + QR de Corretoras |
| Ativo de Tesouraria | Convertido automaticamente em saldo bancário fiduciário | Mantenha USDC/USDT nativos na sua própria carteira de tesouraria |
| Automação com IA e MCP | Ferramentas de agentes focadas em moeda fiduciária | Servidor MCP com 21 ferramentas (/api/mcp) + paywalls HTTP 402 (/x402) |
<!-- Embed alongside Stripe Checkout on any pricing or cart page -->
<script src="https://xpayr.com/public/sdk/xpayr-pay-button.js" defer></script>
<div data-xpayr-pay-button
data-amount="99.00"
data-currency="USD"
data-label="Pay with USDT / USDC (Save FX Fees)"></div>
Valide a Paridade dos Webhooks
Simule as assinaturas `payment.completed` e `payment.underpaid_accepted` em `/tools/webhook-tester` antes de publicar.
Teste Canary com 10% do Tráfego de Checkout
Exiba a XPayr ao lado do seu botão ou plugin atual para que clientes reais liquidem 99.5% direto na sua carteira.
Concilie e Migre 100%
Exporte livros-razão CSV para QuickBooks/Xero/NetSuite (`/accounting`) e aposente definitivamente os saldos custodiais de altas taxas.
Perguntas Frequentes — Migrando para a XPayr
Podemos executar a XPayr em paralelo com nosso gateway atual antes da migração completa?
Sim. Como a XPayr cobra $0 de mensalidade e não exige contrato de exclusividade, a maioria das equipes de engenharia implanta a XPayr primeiro na Testnet e depois direciona de 10% a 25% do tráfego real de checkout cripto para a XPayr enquanto valida a paridade dos webhooks e a liquidação direta de 99.5% na carteira.
Como os callbacks IPN da NOWPayments são mapeados para os webhooks da XPayr?
A NOWPayments envia x-nowpayments-sig (HMAC-SHA512 com JSON ordenado) com status como finished e partially_paid. A XPayr envia X-XPayr-Signature (HMAC-SHA256 sobre o corpo bruto com proteção contra replay por timestamp) com eventos determinísticos: payment.completed, payment.underpaid_accepted, payment.failed e license.issued.
O que acontece com as lojas existentes em WooCommerce, Magento 2, PrestaShop ou Shopware?
Instale o plugin oficial de código aberto da XPayr ao lado do plugin do seu gateway atual (/integrations), cole sua chave de API de Testnet para validar as transições de status dos pedidos e alterne o método de checkout ativo com um clique.
Precisamos migrar primeiro os saldos custodiais do nosso processador antigo?
Não. Basta sacar qualquer saldo remanescente do seu processador custodial antigo no seu próprio ritmo; cada novo pagamento via XPayr liquida 99.5% diretamente na sua própria carteira imediatamente após a confirmação.