Build with FinVeil.

One REST API for collections, disbursements, and transaction proofs. Sandbox credentials in 2 minutes.

Quick start

Your first collection, in one call.

collect.shbash
curl -X POST https://api.finveil.money/api/payments/collect \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 500.00,
    "currency": "ZAR",
    "email": "player@example.com",
    "provider": "auto"
  }'

Replace sk_test_... with your sandbox key from the dashboard. Set provider to auto and FinVeil routes across Paystack, Ozow, and PayFast.

SDKs

Pick your runtime.

Java

Available

Spring Boot compatible

Python

Available

pip install finveil

Node.js

Available

npm install @finveil/sdk

More languages

Coming soon

Go, Rust, PHP, .NET, Kotlin, Flutter

Sandbox

Test against the real thing.

Try the public sandbox console

No signup. Hit /v1/* endpoints in your browser.

Test card

4084 0840 8408 4081

Visa test card. Any future expiry, any CVV, any postal code.

Test mode

All providers available

Paystack, Ozow, PayFast, and Visa Direct all run in sandbox — no live funds, no merchant onboarding required.

Webhook testing

Trigger from dashboard

Replay and trigger test events from the dashboard so you can wire up handlers before going live.

Channels

Try our USSD interface

Dial *123# from this in-browser handset to step through the FinVeil USSD menu — the same payload that hits POST /api/channels/ussd/callback from Africa's Talking and Clickatell.

Enter a phone number and press “Dial *123#” to start the session.
Idlelive

Session log

Every POST /api/channels/ussd/callback request and response.

// No requests yet. Dial *123# to begin.

Ready to ship?

Grab sandbox keys, make your first call, and move to live in the same afternoon.