PaySpot Docs
RADIUS voucher setupBack to PaySpot

Voucher + RADIUS

External RADIUS Voucher Setup

Use this mode when you want voucher sales in PaySpot but data usage, device limits, and accounting enforced by an external RADIUS stack.

Download PaySpot Setup APK

1) Prerequisites

  • - A PaySpot tenant configured with Access mode = voucher_access and Voucher source = radius_voucher.
  • - An external RADIUS service or adapter that can call PaySpot over HTTPS.
  • - A NAS/controller such as MikroTik, Omada, or another hotspot gateway pointed at that RADIUS service.

2) Configure PaySpot

  1. 1. Open /t/<slug>/admin and go to Configure architecture.
  2. 2. Set Access mode to Voucher access.
  3. 3. Set Voucher source to External RADIUS voucher mode.
  4. 4. Create plans with price plus at least one limit: duration or data cap.
  5. 5. Save the generated adapter secret fingerprint and connect your RADIUS adapter with the full secret.

3) Voucher Behavior

  • - PaySpot issues the voucher immediately after successful payment.
  • - Voucher username = transaction reference.
  • - Voucher password = same as the voucher code.
  • - RADIUS policy comes from the paid PaySpot plan: session timeout, data cap, max devices, and bandwidth profile.

4) Adapter Contract

  • - Authorize endpoint: POST /api/t/<slug>/radius/authorize
  • - Accounting endpoint: POST /api/t/<slug>/radius/accounting
  • - Required header: x-radius-adapter-secret
  • - Authorize body: { username, password, callingStationId? }
  • - Accounting body: { event, sessionId, transactionReference?, username?, octets, callingStationId?, calledStationId?, nasIpAddress? }
  • - PaySpot can recover transactionReference from the active session or username when the adapter does not send it on every accounting event.

Key response fields

accept decides whether the voucher is allowed.

transactionReference identifies the paid voucher session.

reply.sessionTimeout, reply.dataLimitMb, reply.maxDevices, and reply.bandwidthProfile come from the plan.

5) Validation Checklist

  • - Run one payment from /t/<slug> and confirm a voucher code is shown immediately after payment.
  • - Use that voucher code as both username and password on the hotspot login page.
  • - Check that authorize returns accept=true and reply fields for the selected plan.
  • - Send interim updates so PaySpot can track used data and active sessions.
  • - Open /t/<slug>/voucher?code=<voucher> to confirm customer-visible usage lookup works.