FivoDocs
Docs/Início Rápido

Início Rápido

Aceite o seu primeiro pagamento em menos de 5 minutos.

Pré-requisitos

Uma conta de comerciante Fivo (crie uma aqui)
O seu Merchant ID (disponível no seu painel)
Um website ou aplicação onde pretende aceitar pagamentos
1

Obtenha o seu Merchant ID

Inicie sessão no seu e navegue até . Copie o seu Merchant ID.Painel Fivo e navegue até Integração.

O seu Merchant ID tem este formato:

fivo_live_969c4442-5741-4624-8305-427391683190
2

Adicione o widget ao seu site

Adicione a seguinte tag de script ao seu HTML. Substitua pelo seu Merchant ID real.O_SEU_MERCHANT_ID

index.html
<!-- Fivo Payment Widget -->
<script async src="https://checkout.fivo.finance/v1/fivo.js"></script>

<fivo-button
  merchant-id="YOUR_MERCHANT_ID"
  amount="29.99"
  currency="USDC">
</fivo-button>
i

Montante Fixo vs Variável

O exemplo acima utiliza um montante fixo (29,99 USDC). Para montantes variáveis (como donativos), basta remover o atributo amount. Consulte para mais detalhes.amount. Integração do Widget.
!

Testnet e mainnet sao ambientes separados

O testnet utiliza fundos simulados e IDs de merchant de teste (fivo_test_). O mainnet utiliza fundos reais e IDs de merchant em producao (fivo_live_). Recomendamos validar toda a sua integracao no testnet antes de passar para producao.
3

Teste um pagamento

Escolha o percurso de teste adequado a sua fase:

Percurso A: Testnet (recomendado primeiro)

Use o seu merchant ID fivo_test_ e USDC de teste gratuito do Circle Faucet para validar a sua integracao de ponta a ponta sem fundos reais.

1

Obtenha USDC de teste gratuito no Circle Faucet em faucet.circle.com.

2

Use o seu merchant ID de testnet (fivo_test_...) no codigo do widget.

3

Faca um pagamento de teste. Funciona exatamente como em producao, mas com tokens simulados.

Percurso B: Teste em mainnet

Depois de validar a sua integracao no testnet, teste um pagamento real com um montante minimo.

1

Va a Integracao no seu painel e clique em "Experimentar ao vivo". Abre um checkout real pre-configurado para $0,01.

2

Conecte a sua wallet e selecione uma cadeia onde tenha USDC ou EURC.

3

Confirme a transacao de $0,01. Serao transferidos fundos reais.

4

Veja no painel

Após o pagamento ser concluído, verá o mesmo na sua página de . Receberá também uma confirmação por email.Transações

Está tudo pronto!

Assim que o pagamento for confirmado on-chain, aparecerá na sua página de com o email do cliente. Tanto você como o cliente recebem um email com os detalhes da transação. Os seus clientes podem agora pagar-lhe em USDC e EURC a partir de qualquer blockchain suportada.Transações

Exemplos

Montante fixo: Produto ou serviço

O cliente paga um montante exato. Ideal para produtos, subscrições ou faturas.

fixed-amount.html
<script async src="https://checkout.fivo.finance/v1/fivo.js"></script>

<fivo-button
  merchant-id="YOUR_MERCHANT_ID"
  amount="29.99"
  currency="USDC">
</fivo-button>

Isto renderiza um botão "Pagar $29,99 com USDC" na sua página (ou EURC se definir currency="EURC"). Ao clicar, o pagamento Fivo abre onde o cliente conecta a sua wallet, vê o seu saldo em cada cadeia, seleciona uma rede e confirma o pagamento.

Montante variável: Donativo ou gorjeta

O cliente escolhe quanto pagar. Basta remover o atributo amount.

donation.html
<script async src="https://checkout.fivo.finance/v1/fivo.js"></script>

<fivo-button
  merchant-id="YOUR_MERCHANT_ID"
  currency="USDC">
</fivo-button>

Isto renderiza um botão "Pagar com USDC" (ou "Pagar com EURC" dependendo da moeda configurada). Ao clicar, o pagamento abre e o cliente introduz o montante que pretende pagar antes de selecionar uma rede e confirmar.

i

Opções de moeda

Pode usar currency="USDC" ou currency="EURC". USDC está disponível em todas as 9 cadeias. EURC está disponível em Ethereum, Avalanche e Base. Consulte para todas as opções de configuração.Integração do Widget.

Próximos Passos

Integração do Widget

Saiba mais sobre montantes fixos vs variáveis e todas as opções de configuração.

Integração API

Crie fluxos de pagamento personalizados com a nossa API REST.

Entre Cadeias (Bridge Kit)

Compreenda como os pagamentos entre cadeias funcionam automaticamente.

Guia de Testes

Verifique a sua integração com pagamentos reais de $0,01.