Introduction

Welcome to Algan Topup API documentation.

Algan Topup API provides a high-performance, secure, and reliable interface to integrate digital top-up products into your own platform. Currently we only support Games & Games Vouchers.

Whether you’re building a reseller app, an e-commerce platform, or a corporate rewards system, our API allows you to programmatically fetch products, place orders, and track balances.

Features

  • Blazing Fast: Sub-50ms order ingestion latency.
  • Atomic Operations: We’re ensuring 100% idempotency and zero race conditions for order so you can protect your balance from being deducted twice.
  • Webhook Callbacks: Asynchronous fulfillment with automatic retries on failures.

Prerequisites

Before making any API calls, you must complete the following steps:

IP Whitelist Required

All API endpoints require your server’s IP address to be whitelisted. You must configure at least one IP address in your Reseller Dashboard under Settings > API Keys before making any request. Requests from non-whitelisted IPs will be rejected with a 403 IP_NOT_WHITELISTED error.

  1. Register: Sign up at the Reseller Dashboard.
  2. Approval: Wait for an admin to approve your designated account and tier (Gold, Platinum, or Diamond).
  3. Generate API Keys: In your dashboard, navigate to Settings > API Keys to generate your API Key and API Secret.
  4. Whitelist Your IP: Add your server’s static IP address in Settings > API Keys > IP Whitelist.

Important

Your API Secret is shown only once. Store it securely.

API Endpoints Overview

Method Endpoint Description
GET /api/v1/categories List all game categories with input form schemas
GET /api/v1/products Get available products with tier-specific pricing
POST /api/v1/order Place a new top-up order
GET /api/v1/order-status Check the status of a single order
GET /api/v1/orders Paginated order history with filters
GET /api/v1/balance Check your current balance
GET /api/v1/wallet-history Paginated wallet transaction ledger

Environments

The API supports both Sandbox and Production modes.

  • Production API URL: https://algan.id/api/v1
  • Development API URL: https://dev.algan.id/api/v1

Quick Start (cURL)

Here’s a minimal example to check your balance. Replace the placeholder values with your real credentials.

# 1. Set your credentials
API_KEY="your_api_key_here"
API_SECRET="your_api_secret_here"

# 2. Generate timestamp (Unix ms)
TIMESTAMP=$(python3 -c "import time; print(int(time.time() * 1000))")

# 3. Generate HMAC-SHA256 signature
#    For GET requests, payload is empty → sign the timestamp only
SIGNATURE=$(echo -n "${TIMESTAMP}" | \
  openssl dgst -sha256 -hmac "${API_SECRET}" | awk '{print $2}')

# 4. Make the request
curl -s https://algan.id/api/v1/balance \
  -H "X-Api-Key: ${API_KEY}" \
  -H "X-Timestamp: ${TIMESTAMP}" \
  -H "X-Signature: ${SIGNATURE}"

Postman Collection

For quick testing, download our ready-to-use Postman Collection. It includes an automated pre-request script that automatically handles HMAC-SHA256 signature generation!

Download Postman Collection (algan-postman.json)

NextAuthentication