Skip to main content

Getting started

This guide summarizes the base ONVO integration flow.

1. Get your keys​

Open the ONVO Dashboard and copy a test secret key. Test keys do not interact with real banking networks.

export ONVO_SECRET_KEY="onvo_test_secret_key_..."

2. Create a payment intent​

A payment intent represents the charge lifecycle for an order.

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": "Order #1001"
  }'

3. Confirm the payment​

Confirm the intent with the buyer's payment method, or use Checkout if you want ONVO to host the payment experience.

4. Listen for webhooks​

Register an endpoint to receive events like payment-intent.succeeded and reconcile your order internally.

5. Move to live mode​

After the account is activated, switch to an onvo_live_ key and repeat end-to-end testing before opening the flow to buyers.