Quick Start

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

1. Create an Account

Sign up at uveruspayments.com. 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 "https://api.uveruspayments.com/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