Saltar al contenido principal

Primeros pasos

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

Referencia API relacionada​

1. Obtené tus llaves​

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

export ONVO_SECRET_KEY="onvo_test_secret_key_..."

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.