Nesta página
Primeiros passos
Novo na Eppay? Estes três passos cobrem tudo o que cada comerciante precisa antes de aceitar seu primeiro pagamento em cripto.
1. Crie sua conta e verifique seu e-mail
Cadastre-se em eppay.io com e-mail ou login social (Google, Facebook). Verifique o endereço que chega à sua caixa de entrada para que possamos enviar notificações de pagamento e alertas de segurança.
2. Adicione um endereço de carteira de destino
Abra Configurações e cole um endereço de carteira que você controle em cada blockchain onde planeja aceitar pagamentos. A Eppay nunca custodia fundos — cada pagamento é liquidado diretamente para o endereço definido por você.
3. Gere uma chave de API ou crie um link de pagamento
Para faturas avulsas, crie um Produto e compartilhe o link de pagamento hospedado. Para integrações de checkout, gere uma chave de API na aba API e chame POST /api/v2/create-payment para criar links programaticamente.
Pagamentos e confirmações
A Eppay processa pagamentos em stablecoins USDT e USDC nas redes abaixo. Cada chain possui velocidades de confirmação e perfis de taxa diferentes.
Redes suportadas
Ethereum, Binance Smart Chain (BSC), Polygon, Arbitrum, Avalanche, Fantom, Cronos, Celo e Cosmos. Continuamos a adicionar chains conforme a demanda dos comerciantes — diga-nos qual rede você precisa.
Tokens suportados
USDT (Tether) e USDC (USD Coin) em cada chain suportada. Ambas são stablecoins atreladas ao dólar americano, portanto o valor que seu cliente envia corresponde ao preço exibido no checkout.
Quanto tempo demoram as confirmações?
O tempo de confirmação depende da chain. Em BSC, Polygon e Arbitrum, os pagamentos costumam ser finalizados em bem menos de um minuto. Na Ethereum mainnet, espere cerca de 1–3 minutos em condições normais de rede, mais tempo quando as taxas disparam. A Eppay marca o pagamento como "concluído" assim que a transação on-chain atinge a profundidade de confirmação exigida.
Quem paga a taxa de rede?
O cliente paga a taxa de gas na chain escolhida. A Eppay não cobra taxa sobre o pagamento em si, além da taxa de plataforma divulgada no painel da sua conta.
O que acontece se um cliente pagar a menos?
Se um cliente enviar menos do que o valor solicitado, o pagamento é registrado como parcial e o link permanece aberto até que o saldo restante chegue ou o link expire. Reembolsos por pagamentos parciais são tratados diretamente entre você e o cliente; a Eppay não custodia os fundos.
API e integrações
A Eppay oferece uma API REST, um app Shopify e um SDK JavaScript para incorporar o checkout em qualquer stack web.
Onde obtenho minha chave de API?
Faça login, abra a aba API no painel e clique em Criar Chave de API. Cada chave é restrita à sua conta e você pode revogar e rotacionar chaves a qualquer momento. Trate as chaves de API como senhas e armazene-as apenas no servidor.
Devo usar a API v1 ou v2?
Use v2 para todas as novas integrações. Os endpoints v2 (POST /api/v2/create-payment, GET /api/v2/payments/{id}/status) são o padrão suportado. Os endpoints v1 ainda respondem para chamadores legados, mas não devem ser usados em novos trabalhos.
Vocês suportam webhooks?
Sim. Configure uma URL de webhook na sua conta e a Eppay enviará por POST um payload JSON assinado quando um status de pagamento mudar. Verifique o cabeçalho de assinatura no seu lado antes de confiar no evento.
Como funciona a integração com Shopify?
Instale o app Eppay na Shopify App Store, conecte-o à sua conta Eppay e cripto vira uma opção de pagamento no checkout. Os pagamentos são liquidados na carteira configurada na Eppay; pedidos são marcados como pagos automaticamente no Shopify quando a transação on-chain é confirmada.
Conta e segurança
Algumas perguntas comuns sobre a conta:
Esqueci minha senha
Use o link "Esqueci minha senha" na página de login. Enviaremos por e-mail um link de redefinição válido por 60 minutos. Se o e-mail não chegar, verifique o spam e confirme o endereço usado no cadastro.
Como ativo a autenticação de dois fatores?
Abra as configurações do perfil e siga o assistente de configuração 2FA. Recomendamos ativar o 2FA antes de adicionar endereços de carteira ou gerar chaves de API.
Posso alterar meu endereço de carteira?
Sim. Atualize o endereço em Configurações a qualquer momento. Pagamentos futuros serão direcionados ao novo endereço. Pagamentos já em andamento são liquidados no endereço ativo no momento da criação do link.
Solução de problemas
Os cinco problemas mais comuns e como resolvê-los:
Meu pagamento está travado em "pendente"
"Pendente" significa que a transação foi transmitida, mas ainda não atingiu a profundidade de confirmação exigida na chain. Procure o hash da transação em um block explorer (etherscan.io para Ethereum, bscscan.com para BSC, polygonscan.com para Polygon etc.) para confirmar que foi minerada. Se aparecer confirmada on-chain mas continuar pendente na Eppay após 10 minutos, contate-nos com o hash.
Um cliente pagou na chain errada
Se você receber um pagamento em uma chain que controla com o mesmo endereço de carteira (a maioria das chains EVM compartilha o formato de endereço), os fundos são recuperáveis nessa chain. Se o cliente enviou para uma chain da qual você não tem as chaves, infelizmente os fundos não são recuperáveis pela Eppay.
Minha chave de API retorna 401 Unauthorized
Verifique se você está enviando a chave no cabeçalho Authorization como Bearer token, se ela não foi revogada no painel e se está chamando o ambiente correto. Como último recurso, regenere a chave.
O valor exibido não corresponde ao enviado
A Eppay cota valores em stablecoins (USDT ou USDC), portanto 1 USDT entrando = 1 USDT saindo — não há conversão de moeda. Se o cliente enviou um token diferente (por ex. ETH em vez de USDT), o pagamento não casará. A precisão decimal varia por chain; por padrão exibimos seis casas decimais.
Meu webhook nunca dispara
Confirme que a URL é acessível publicamente (sem localhost ou hosts somente VPN), responde em HTTP 2xx em até 5 segundos e que nenhum firewall está bloqueando nossos IPs. Nós retentamos entregas falhas com backoff exponencial por até 24 horas.
Tempos de resposta
Procuramos responder cada e-mail em até um dia útil (segunda a sexta). Problemas urgentes que bloqueiam pagamentos têm prioridade. Operamos em horário da Europa Central, mas a equipe é distribuída e frequentemente responde fora desses horários.
Para uma resposta mais rápida, inclua no primeiro e-mail: o e-mail da conta, o ID do pagamento ou hash da transação se aplicável, a rede e uma captura de tela ou mensagem de erro.
Contatar suporte
Para problemas técnicos, de conta ou de pagamento, escreva-nos:
info@eppay.io
Negócios e parcerias
Para parcerias, integrações em escala, condições de pagamento personalizadas ou imprensa, escreva para info@eppay.io com "Partnership" no assunto e uma breve descrição do que você está construindo. Respondemos a cada solicitação legítima em até dois dias úteis.
Procurando documentação técnica?
Nossa documentação para desenvolvedores cobre a referência completa da API, payloads de webhook, uso do SDK e exemplos de código em várias linguagens.
Abrir a documentação →