Primeros pasos

Esta guía resume el flujo base para integrar ONVO.

Referencia API relacionada

• Crear una intención de pago
• Confirmar una intención de pago
• Crear una sesión de Checkout

1. Obtené tus llaves

Entrá al Dashboard de ONVO y copiá una llave secreta y una publishable key de prueba. Las llaves de prueba no interactúan con redes bancarias reales.

export ONVO_SECRET_KEY="onvo_test_secret_key_..."
export ONVO_PUBLISHABLE_KEY="onvo_test_publishable_key_..."

PCI y datos de tarjeta

Para reducir tu alcance PCI en integraciones con tarjeta, creá el método de pago del lado del cliente con la publishable key y enviale a tu backend solo el paymentMethodId. No enviés PAN, CVV ni datos completos de tarjeta por tu servidor. Si preferís delegar la recolección de tarjeta a ONVO, usá Checkout o el SDK web.

2. Creá una intención de pago

Una intención de pago representa el ciclo de cobro de una orden.

curl https://api.onvopay.com/v1/payment-intents \
  -X POST \
  -H "Authorization: Bearer $ONVO_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 250000,
    "currency": "CRC",
    "description": "Orden #1001"
  }'

3. Confirmá el pago

Confirmá la intención con el método de pago del comprador o usá Checkout si querés delegar la experiencia de cobro.

4. Escuchá webhooks

Registrá un endpoint para recibir eventos como payment-intent.succeeded y reconciliar tu orden internamente.

5. Pasá a modo en vivo

Cuando la cuenta esté activada, cambiá a una llave onvo_live_ y repetí las pruebas de extremo a extremo antes de abrir el flujo a compradores.