Quick Start

Welcome to the Uverus Quick Start guide. Follow these steps to start accepting card payments.

1. Create an Account

Sign up at uverus.com/register. You'll immediately get access to your Test Environment.

2. Get your API Keys

Go to Settings > API Keys to find your test keys.

• pk_test_... (Public Key)
• sk_test_... (Secret Key)

3. Initialize a Checkout Session

Use your secret key to create a payment session from your backend.

curl -X POST "http://localhost:3001/v1/checkout/initialize" \
     -H "Authorization: Bearer sk_test_..." \
     -H "Content-Type: application/json" \
     -d '{
       "amount": 100000,
       "currency": "NGN",
       "customerEmail": "user@example.com"
     }'

4. Redirect to Checkout

The API will return a checkoutUrl. Redirect your customer to this URL to complete the payment.

{
  "reference": "uvr_...",
  "checkoutUrl": "http://localhost:5173/checkout/uvr_..."
}

5. Handle the Webhook

Set up a webhook listener to receive a checkout.completed event once the payment is successful.

Next Steps

• Explore Authentication
• Learn about Payment Links
• Configure Webhooks