Skip to content
RADOK

Developers

Payments infrastructure built for developers.

Build collections, virtual accounts, payouts, and payment workflows with Radok's APIs, keys, and webhooks.

Read the docsCreate an account

REST API · JSON · HTTPS

POST/v1/collections
{
  "virtualAccount": "1234567890",
  "amount": 250000,
  "currency": "NGN"
}
201 Created
{
  "id": "col_8f21...",
  "status": "awaiting_payment",
  "amount": 250000,
  "currency": "NGN"
}

Get started

Start building in minutes.

  1. 01

    Create an account

    Create your Radok merchant account and get access to your developer environment.

  2. 02

    Get your API key

    Create a test API key and authenticate your requests securely.

  3. 03

    Make your first request

    Create a virtual account, collect a payment, and listen for the result through webhooks.

Capabilities

Everything you need to move money.

  • 01

    Collections

    Accept payments through virtual accounts.

    POST /v1/collections

  • 02

    Virtual Accounts

    Create dedicated accounts for customers or payment flows.

    Virtual accounts

  • 03

    Payment Links

    Create a hosted payment page and share it with customers.

    POST /v1/payment-links

  • 04

    Payouts

    Send money to bank accounts through your integration.

    Bank transfer

  • 05

    Webhooks

    Receive signed events when payment states change.

    collection.succeeded

  • 06

    API Keys

    Authenticate your application with test and live keys.

    rk_test_ · rk_live_

  • 07

    Sandbox

    Test payment flows without moving real money.

    Test environment

Collections

Accept payments through virtual accounts.

Create a virtual account, share the details with your customer, and receive a webhook when the collection succeeds.

  1. 01

    Your application

  2. 02

    Create virtual account

  3. 03

    Customer receives account details

  4. 04

    Customer makes payment

  5. 05

    Collection

  6. 06

    Webhook

  7. 07

    Your application

API Reference

Create a collection.

Authenticate with a test key, then create a collection against a virtual account.

JavaScript
const collection = await radok.collections.create({
  virtualAccount: "1234567890",
  amount: 250000,
  currency: "NGN",
});
Response
{
  "id": "col_123456",
  "status": "awaiting_payment",
  "amount": 250000,
  "currency": "NGN"
}

Webhooks

Know when something happens.

Radok can notify your application when a collection succeeds. Verify each payload with your webhook signing secret.

Webhook delivery

collection.succeeded

POST https://api.example.com/webhooks/radok

200 OKDelivered 324ms
Payload
{
  "event": "collection.succeeded",
  "data": {
    "id": "col_123456",
    "status": "succeeded"
  }
}
  • ✓ 200collection.succeeded
    324ms
  • ✓ 200collection.succeeded
    291ms
  • × 500collection.succeeded
    1.2s

Authentication

Your keys. Your control.

Create, rotate, and revoke keys for test and live traffic. Test keys never move real money.

  • Use test keys in sandbox. Switch to live after KYB.
  • Treat secret keys as credentials. Rotate or revoke them from the dashboard.

Sandbox

Build without touching real money.

The test environment lets you create virtual accounts and walk a collection through to a webhook without settling live funds.

Resources

Where to go next.

Ready to build with Radok?

Start integrating payments into your product today.

Read the docsCreate an account