Criar chave de teste
Abra o painel do lojista e use uma chave secreta de teste nas primeiras chamadas de API.
Sem risco em producao
Comprove o fluxo de checkout antes de mover fundos reais.
Use a testnet para validar sessoes de pagamento, checkout do comprador, status publico, entrega de webhook e registros de reconciliacao antes da ativacao na mainnet.
Criar sessao
Chame POST /api/v1/payments com um valor pequeno e metadados de teste.
Abrir checkout
Use o payment_url retornado e conclua o fluxo de testnet no lado da carteira.
Ler status
Chame GET /api/v1/payments/{id}/status e armazene o status junto com o hash da transacao.
Receber webhook
Verifique a assinatura e atualize seu pedido somente apos um evento confiavel.
Revisar registros
Compare o ID da sessao, ID do pedido, valor, rede, token e registros de taxa antes da revisao na mainnet.
Definicao de pronto
Sua integracao esta pronta para revisao quando um desenvolvedor consegue criar uma sessao, abrir o checkout, confirmar o status, verificar um webhook assinado e reconciliar o ID do pedido sem suporte manual.
Abrir conta de testnet Checklist do lojista Simulador Interativo de Testnet Testar Sessão via MCPFaucets de Testnet Web3 e Endpoints RPC
Obtenha tokens gratuitos de testnet para simular transações reais na blockchain sem exposição financeira:
Rede de Desenvolvimento Solana (Devnet)
Cluster: Devnet | Moeda: SOL / Dev-USDC
Obter SOL da Devnet →
SDKs Oficiais no NPM (v0.2.0) e Servidor MCP Remoto
Integre Mais Rápido com Pacotes Oficiais da XPayr e MCP sem Instalação
Instale @xpayr/node-sdk (v0.2.0), @xpayr/payment-evidence (v0.2.0), @xpayr/extension-kit (v0.2.0)ou @xpayr/mcp-server (v1.0.0) pelo NPM, ou execute chamadas de ferramentas JSON-RPC 2.0 ao vivo via POST https://xpayr.com/api/mcp.