FivoDocs
Docs/Inicio Rápido

Inicio Rápido

Acepte su primer pago en menos de 5 minutos.

Requisitos Previos

Una cuenta de comerciante en Fivo (crear una aquí)
Su Merchant ID (disponible en su panel de control)
Un sitio web o aplicación donde desee aceptar pagos
1

Obtenga su Merchant ID

Inicie sesión en su y navegue a . Copie su Merchant ID.Panel de Fivo y navegue a Integración.

Su Merchant ID tiene este formato:

fivo_live_969c4442-5741-4624-8305-427391683190
2

Añada el widget a su sitio

Añada la siguiente etiqueta de script a su HTML. Reemplace con su Merchant ID real.SU_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

Monto Fijo vs Variable

El ejemplo anterior usa un monto fijo (29,99 USDC). Para montos variables (como donaciones), simplemente elimine el atributo amount. Consulte para más detalles.amount. Integración del Widget.
!

Testnet y mainnet son entornos separados

Testnet usa fondos simulados e IDs de merchant de prueba (fivo_test_). Mainnet usa fondos reales e IDs de merchant en produccion (fivo_live_). Recomendamos validar toda la integracion en testnet antes de pasar a produccion.
3

Pruebe un pago

Elija la ruta de prueba que se ajuste a su fase:

Ruta A: Testnet (recomendado primero)

Use su merchant ID fivo_test_ y USDC de prueba gratuito del Circle Faucet para validar su integracion de principio a fin sin fondos reales.

1

Obtenga USDC de prueba gratuito en el Circle Faucet en faucet.circle.com.

2

Use su merchant ID de testnet (fivo_test_...) en el codigo del widget.

3

Realice un pago de prueba. Funciona exactamente como produccion pero con tokens simulados.

Ruta B: Prueba en mainnet

Una vez validada su integracion en testnet, pruebe un pago real con un monto minimo.

1

Vaya a Integracion en su panel de control y pulse "Pruebelo en vivo". Abre un checkout real preconfigurado a $0,01.

2

Conecte su wallet y seleccione una cadena donde tenga USDC o EURC.

3

Confirme la transaccion de $0,01. Se transferiran fondos reales.

4

Véalo en el panel

Tras completar el pago, lo verá en su página de . También recibirá una confirmación por correo electrónico.Transacciones

¡Todo listo!

Una vez que el pago se confirma on-chain, aparecerá en su página de con el correo electrónico del cliente. Tanto usted como el cliente reciben un correo electrónico con los detalles de la transacción. Sus clientes ya pueden pagarle en USDC y EURC desde cualquier blockchain compatible.Transacciones

Ejemplos

Monto fijo: Producto o servicio

El cliente paga un monto exacto. Ideal para productos, suscripciones o facturas.

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>

Esto renderiza un botón "Pagar $29,99 con USDC" en su página (o EURC si configura currency="EURC"). Al pulsarlo, se abre el pago de Fivo donde el cliente conecta su wallet, ve su saldo en cada cadena, selecciona una red y confirma el pago.

Monto variable: Donación o propina

El cliente elige cuánto pagar. Simplemente elimine el 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>

Esto renderiza un botón "Pagar con USDC" (o "Pagar con EURC" dependiendo de su moneda configurada). Al pulsarlo, se abre el pago y el cliente introduce el monto que desea pagar antes de seleccionar una red y confirmar.

i

Opciones de moneda

Puede usar currency="USDC" o currency="EURC". USDC está disponible en las 9 cadenas. EURC está disponible en Ethereum, Avalanche y Base. Consulte para todas las opciones de configuración.Integración del Widget.

Siguientes Pasos

Integración del Widget

Conozca las opciones de monto fijo vs variable y todas las configuraciones disponibles.

Integración API

Construya flujos de pago personalizados con nuestra API REST.

Entre Cadenas (Bridge Kit)

Comprenda cómo funcionan automáticamente los pagos entre cadenas.

Guía de Pruebas

Verifique su integración con pagos reales de $0,01.