API documentation

Everything you need to integrate Radok: authentication, endpoints, and webhooks.

Contents

Start here

Radok collects payments into unique virtual bank accounts, sends payouts, and tells you about both over signed webhooks. Everything is under one versioned base URL, and the environment comes from your API key rather than from the URL.

Base URL

https://api.radokpay.com/v1

New here?

Read Introduction, then Authentication. You will have a virtual account minted within a couple of minutes.

Do something now

Create an API key

Keys are created in the dashboard and shown once.

Configure webhooks

Set your endpoint, generate a signing secret, send a test event.

Simulate a payment

Settle a test collection without waiting for a transfer.

Add a payout account

Verify a bank account so payouts have somewhere to go.

Get started

Introduction
What the Radok API does, and a request you can run in the next two minutes.
Authentication
Create an API key, send it, and understand scopes, environments, and rotation.
Requests and responses
The response envelope, error codes, money, pagination, and idempotency.

Money in

Virtual accounts
Give a customer a unique bank account to pay into.
Collections
Track what a customer owes and whether it has been paid.
Payment links
A hosted page that collects a payment without any code.
Checkout widget
Take payments on your own site — the checkout in a modal, one script tag.

Money out

Payout accounts
Save and verify the bank accounts you withdraw to.
Payouts
Send money out, with idempotency and optional Finance approval.
Wallet and balance
Read your balance, read the ledger behind it, and fund it.

Events

Webhooks
Receive events, verify the signature, and handle retries safely.
Event reference
Every event Radok sends, with its exact payload.