Docs/Testes

Testes

Verifique a sua integração com micro-pagamentos reais antes de entrar em produção.

Como Funcionam os Testes

O Fivo processa pagamentos reais em mainnet. Para testar a sua integração, use o botão na sua página de . Abre um pagamento real pré-configurado para $0,01 USDC ou EURC usando o seu Merchant ID.Experimentar ao vivo Integracao

Pagamentos reais, custo mínimo

Cada teste custa $0,01 mais uma pequena taxa de gas (custo de transação da rede). Esta é a forma mais segura de confirmar que tudo funciona de ponta a ponta antes de aceitar pagamentos maiores.

Usar "Experimentar ao vivo"

Abra a página de Integração

Vá a no seu painel e clique no botão .Integracao Experimentar ao vivo

Conecte a sua wallet

Conecte MetaMask, Coinbase Wallet ou qualquer wallet compatível com WalletConnect. Certifique-se de que tem USDC ou EURC.

Complete o pagamento de $0,01

Selecione uma cadeia onde tenha USDC ou EURC e confirme a transação.

Verifique o resultado

Consulte a sua página de para ver o novo pagamento e confirme que recebeu a notificação por email.Transações

O que Testar

Recomendamos verificar os seguintes cenários:

Pagamento na mesma cadeia

Pague a partir da mesma blockchain da sua wallet de comerciante. Este é o fluxo mais rápido. A transferência é instantânea.

Pagamento entre cadeias (apenas USDC)

Pague a partir de uma cadeia diferente da sua wallet de comerciante. O Bridge Kit transfere automaticamente USDC via CCTP para a sua cadeia (normalmente 1-2 minutos). Nota: EURC não suporta transferências entre cadeias: funciona apenas na mesma cadeia.

Saldo insuficiente

Tente pagar a partir de uma cadeia onde não tem fundos suficientes. O widget deve mostrar um indicador "Insuficiente" nessa cadeia e impedir a seleção.

Rejeição da transação

Clique em "Pagar" e depois rejeite a transação na sua wallet. O widget deve mostrar um erro e permitir-lhe tentar novamente.

Lista de Verificação Pré-Lançamento

Antes de anunciar a sua integração, verifique estes itens:

O widget carrega corretamente no seu siteO Merchant ID está correto (fivo_live_...)O montante é apresentado corretamente (se usar montante fixo)O pagamento na mesma cadeia é concluído e aparece no painelO pagamento entre cadeias em USDC é concluído (se aplicável)A notificação por email é recebida após o pagamentoO widget funciona em dispositivos móveis

Resolução de Problemas

Se algo não estiver a funcionar, verifique estes problemas comuns:

O widget não carrega

Verifique a consola do navegador para erros
Verifique se o URL do script está correto: checkout.fivo.finance/v1/fivo.js
Certifique-se de que é um ID válido (formato: )merchant-id (fivo_live_UUID)

Saldos não aparecem

Certifique-se de que a sua wallet tem USDC ou EURC numa cadeia suportada
Aguarde alguns segundos para que a verificação de saldos termine
Verifique se a sua wallet está conectada

A transação falha

Certifique-se de que tem tokens nativos suficientes para gas (ETH, MATIC, AVAX, etc.)
Verifique se tem USDC ou EURC suficiente para o montante do pagamento
Tente atualizar a página e reconectar a sua wallet

O pagamento entre cadeias está pendente

As transferências entre cadeias via CCTP demoram normalmente 1-2 minutos
Durante congestionamento da rede, pode demorar mais
Verifique o estado do pagamento na sua página de Transações

Registos da Consola

O widget regista informações úteis na consola do navegador (pressione F12 para abrir). Procure mensagens que comecem com :[Fivo Widget]:

Browser Console

[Fivo Widget] Configuration loaded: {merchantId: "fivo_live_...", amount: "29.99", currency: "USDC", mode: "fixed"}
[Fivo Widget] Using URL/default config: {merchantId: "fivo_live_...", amount: "0.01", currency: "USDC"}

Se vir mensagens de erro como , verifique se o seu Merchant ID segue o formato .Invalid Merchant ID format, fivo_live_UUID.

Precisa de Ajuda?

Se estiver com dificuldades ou encontrou um bug, estamos aqui para ajudar.

Contactar Suporte