Perguntas decisivas na adoção de pagamentos

Como posso começar a aceitar criptografia com XPayr?

Crie uma conta de comerciante, adicione uma carteira de pagamento, escolha rede e token e publique seu link, widget ou botão de pagamento.

Como funciona o Simulador Sandbox Instantâneo para checkout em testnet e QA de webhooks?

When you create a payment session using a test API key (sk_test_...) on any testnet network, both the hosted checkout page (/test/{session_id}) and the REST API (POST /api/v1/payments/{id}/simulate) allow you to trigger instant simulated outcomes—Completed, Underpaid, Expired, or Failed—without needing testnet faucet tokens. Each simulation generates realistic ledger records and dispatches a signed webhook event to your callback URL.

Posso testar antes de ir ao ar?

Sim. Use fluxos testnet para validar o checkout, a conexão da carteira e o comportamento da fatura antes da produção.

Preciso de habilidades de codificação para começar?

Não. Você pode lançar sem ferramentas de código no painel do comerciante e usar a API somente quando precisar de integrações avançadas.

Quanto tempo normalmente leva a configuração?

A maioria dos comerciantes publica seu primeiro fluxo de checkout criptografado em minutos.

Qual é a diferença entre links de pagamento e links de doação?

Links de pagamento são fluxos de checkout fixos. Os links de doação são fluxos focados no apoio às contribuições da comunidade.

Compradores e lojistas podem baixar recibos oficiais em PDF para pagamentos cripto concluídos?

Sim. Cada sessão de pagamento concluída inclui um gerador instantâneo de recibos PDF-1.4 (/public/receipt.php?session_id={id}&download=1) e uma visualização HTML imprimível. O recibo exibe o ID da fatura, ID da sessão, nome do lojista, valor bruto, taxa de gateway XPayr, valor líquido de liquidação, token, rede, endereços das carteiras de origem/destino, carimbo de data/hora UTC e hash da transação on-chain.

Um link pode receber vários pagamentos?

Sim. Links reutilizáveis ​​podem coletar vários pagamentos ao longo do tempo com base no fluxo de sua campanha.

Quando devo usar widget, botão ou link direto?

Use widget para checkout incorporado, botão para call to action da marca e link direto para compartilhamento rápido em bate-papos ou redes sociais.

O cliente pode inserir um valor personalizado?

Sim. Você pode permitir valores personalizados ou manter valores fixos dependendo do fluxo configurado.

Os clientes podem pagar diretamente de corretoras de criptomoedas ou sem conectar uma carteira Web3?

Sim. O XPayr possui o Modo de Checkout Duplo: Pagamento Web3 em 1 Clique para transações diretas com carteiras de navegador e Transferência Direta / QR para clientes que pagam de exchanges centralizadas (Binance, Bybit, OKX, etc.) ou carteiras móveis. Os clientes podem simplesmente escanear o código QR ou copiar o endereço do destinatário, transferir os fundos e inserir o Hash da Transação (TxID) ou deixar o explorador on-chain detectar o pagamento automaticamente. Uma tolerância para taxas de saque de 1% (máx. $0,50) está integrada.

Como funcionam os links de pagamento e páginas de doação multi-cadeia?

Ao criar um link de pagamento ou página de doação, os comerciantes podem escolher "Todas as Redes (O cliente escolhe no checkout)". Em vez de limitar o pagador a uma única blockchain ou moeda, o checkout apresenta um seletor de rede simples. O cliente pode pagar usando EVM (Ethereum, BSC, Polygon, Arbitrum, Avalanche), TRON USDT ou Solana, e o sistema carrega automaticamente o roteamento correto, os parâmetros do contrato e a carteira de destino.

Quais carteiras o XPayr suporta?

XPayr suporta carteiras de navegador compatíveis com EIP e fluxos de conexão de carteira modernos.

Por que vejo a Carteira não registrada nesta rede?

A carteira selecionada não está registrada para essa rede nas configurações do comerciante. Adicione e registre-o na rede selecionada.

Posso trocar de carteira após conectar?

Sim. Desconecte a carteira atual e reconecte-se com o endereço que deseja usar antes de criar ou confirmar o pagamento.

Como adiciono carteiras de pagamento corretamente?

Abra carteiras de pagamento no painel do comerciante, selecione a rede, cole o endereço da carteira e salve após a validação.

Qual taxa o XPayr cobra?

XPayr aplica uma taxa de gateway transparente de 0,5%. As taxas de gás de rede são custos de blockchain e variam de acordo com o estado da cadeia.

Como os Planos de Assinatura SaaS e os Níveis de Volume de 30 dias da XPayr reduzem a taxa de gateway de 0.5%?

A XPayr começa com uma taxa transparente de gateway de 0.50% (50 bps) no plano gratuito Starter ($0/mês). Os lojistas podem fazer upgrade para Growth Pro ($49/mês com taxa base de 0.30% / 30 bps) ou Enterprise Scale ($199/mês com taxa base de 0.15% / 15 bps). Além disso, a XPayr calcula automaticamente seu volume móvel concluído em mainnet nos últimos 30 dias em USD e aplica um desconto por Nível de Volume: Bronze ($0+ = 0 bps), Silver ($10,000+ = -5 bps), Gold ($50,000+ = -10 bps) e Diamond ($250,000+ = -15 bps), reduzindo sua taxa efetiva de gateway até o piso de 0.05% (5 bps).

Quem paga as taxas de gás?

Os custos do gás são pagos em cadeia pelo remetente da transação de acordo com as condições da rede e o fluxo de token selecionado.

Com que rapidez os fundos são liquidados?

Após a confirmação da cadeia, os fundos são transferidos diretamente para o fluxo de carteira configurado.

Existem taxas ocultas?

Sem taxas de gateway ocultas. Você vê claramente as taxas de plataforma e os custos de rede no fluxo.

Como o XPayr melhora a segurança da conta?

Use 2FA, controles de lista de permissões e validação de assinatura de webhook para proteger operações de contas e pagamentos.

O White Label remove o Powered by XPayr?

Não. A marca de confiança principal permanece visível enquanto os elementos da sua marca são mostrados no cabeçalho da finalização da compra.

Como a lista de permissões de IP ajuda?

Ele restringe ações confidenciais a endereços IP aprovados e reduz ações administrativas não autorizadas.

Posso aplicar o modo somente lista de permissões da carteira de pagamento?

Sim. Ative a aplicação da lista de permissões para permitir pagamentos apenas para carteiras e pares de moedas aprovados.

Como verifico eventos de webhook?

Valide o cabeçalho da assinatura com o segredo do webhook antes de processar os dados da carga útil.

A XPayr suporta assinatura de requisições de entrada HMAC-SHA256, URLs de IPN dinâmicas por pagamento e filtragem de métodos de pagamento?

Yes. Merchants can generate a dedicated HMAC secret in the API Keys dashboard and send X-Signature and X-Timestamp headers (with a 300-second anti-replay window) on API requests. When creating a payment session via POST /api/v1/payments, you can also pass ipn_url (or ipn_callback_url) to route webhooks dynamically per store/order, and allow_payment_methods (["web3", "direct", "gasless"]) to control which checkout tabs are shown to the buyer.

Qual é a diferença entre chave de API e chave secreta?

A chave API identifica o contexto de integração. A chave secreta autoriza solicitações de API protegidas no servidor.

Quais status o webhook pode enviar?

Os status comuns incluem pendente, confirmado, com falha e expirado com eventos de atualização relacionados.

Como evito o processamento duplicado de eventos?

Use idempotência em seu back-end e armazene identificadores de eventos processados ​​antes de aplicar atualizações de negócios.

Os links de pagamento podem ser criados com envio automático de fatura por e-mail via API e painel?

Sim. Ao criar uma sessão via POST /payments ou no portal do comerciante, defina send_invoice_email como true e informe customer_email. O XPayr envia imediatamente uma fatura por e-mail em HTML responsiva com a identidade da marca, detalhes de pagamento e um botão de checkout em 1 clique. Os webhooks são acionados na conclusão do pagamento.

Por que a transação é revertida pelo EVM?

Isso geralmente significa incompatibilidade de rede, incompatibilidade de token, falta de registro de carteira ou rejeição de validação de contrato.

Por que os detalhes da fatura não estão sendo carregados?

Verifique se a fatura pertence à sua conta de comerciante e se existem dados da sessão no ambiente atual.

Por que aparece Sessão expirada?

A sessão atingiu o limite de tempo ou já foi finalizada por um fluxo concluído.

Por que o botão Connect wallet não funciona?

Verifique se a extensão da carteira está instalada, desbloqueada, na cadeia correta e se os pop-ups não estão bloqueados pelas configurações do navegador.

Minha equipe pode usar uma conta de comerciante?

Sim. As equipes podem compartilhar fluxos de trabalho operacionais enquanto os controles de pagamento permanecem centralizados.

Como recupero o acesso à conta?

Use o fluxo de senha esquecida e as etapas de recuperação e atualize as configurações de segurança após a restauração do acesso.

Onde posso gerenciar chaves de API?

Abra as chaves de API no painel do comerciante para criar, alternar e revogar credenciais.

Os administradores podem ver o site durante o modo de manutenção?

Sim. Os usuários administradores podem ignorar a página de manutenção enquanto os visitantes públicos ainda veem a tela de manutenção.

Como funciona o programa de parceiros e afiliados da XPayr?

A XPayr oferece uma infraestrutura híbrida de parceiros que suporta rastreamento corporativo Web2 (via Impact.com S2S) e liquidação direta por contrato inteligente Web3.

Ao indicar comerciantes ou desenvolvedores, você ganha 30% de receita recorrente sobre taxas de processamento ou $50 CPA por comerciante ativo.

Como funciona o rastreamento e atribución de links de referência do Impact.com?

Quando um visitante clica no seu link de afiliado, a XPayr armazena o identificador de clique por 30 dias.

Quando o usuário se cadastra ou aceita pagamentos, a XPayr envia um postback Server-to-Server (S2S) para a Impact.com, imune a bloqueadores de anúncios.

Quais são os modelos de remuneração: 30% RevShare vs $50 CPA?

Você pode escolher entre dois modelos:

1. 30% de RevShare Recorrente: Ganhe 30% das taxas de 0,5% da XPayr vitaliciamente.
2. $50 CPA de Ativação: Receba $50 assim que o comerciante atingir seus primeiros $100 em volume.

Como resgato recompensas on-chain diretamente para minha carteira Web3?

Conecte sua carteira no Painel do Comerciante (/merchant/affiliate).

O contrato inteligente aloca sua comissão de 30% automaticamente. Clique em 'Claim' para sacar USDT, USDC ou SOL instantaneamente.

Onde posso encontrar selos oficiais e banners de afiliados?

Acesse o Recursos da Marca Studio em /brand-assets.

Gere selos SVG dinâmicos e copie códigos de incorporação para banners padrão (728x90, 300x250, 1200x630).

Autorreferências ou transações de teste são remuneradas?

Não. Autorreferências, volume artificial e transações em redes de teste são estritamente excluídas pelos filtros antifraude.