Dokumentasi Integrasi

API TODAGAMES

Hubungkan sistem Anda dengan layanan TODAGAMES melalui REST API JSON, jalur IP/Otomax, dan webhook report otomatis untuk status transaksi.

Mulai Integrasi Lihat Endpoint

Base URL

https://api.todagames.id/api/v1

Format

application/json

Auth

API Key + Member Code

Server IP

203.194.114.233

Ringkasan

API ini menyediakan pengecekan saldo, deposit, daftar produk, pembuatan transaksi, pengecekan status, serta callback transaksi otomatis. Semua transaksi REST dikirim memakai method POST dengan header Content-Type: application/json.

Pengenalan

Pilih jalur integrasi sesuai kebutuhan sistem Anda.

API JSON (REST API)

REST API berkomunikasi melalui HTTP/HTTPS dan seluruh request serta response memakai JSON. Jalur ini cocok untuk website, backend server, aplikasi mobile, dan integrasi dashboard internal.

IP / Otomax

Jalur IP/Otomax memakai HTTP GET dan cocok untuk sistem H2H yang membutuhkan request sederhana, whitelist IP, dan callback report berbasis URL.

Persiapan

Lengkapi konfigurasi berikut sebelum masuk production.

Koneksi API JSON (REST)

Dapatkan API Key dan Member Code melalui dashboard.
Tambahkan whitelist IP untuk development dan production.
Gunakan header Content-Type: application/json.
Tambahkan URL report/webhook untuk menerima status transaksi otomatis.
Whitelist IP server TODAGAMES: 203.194.114.233.

Header wajib

Content-Type: application/json

Koneksi IP / Otomax

Dapatkan API Key dan Member Code.
Tambahkan whitelist IP server Anda di dashboard.
Tambahkan URL report untuk menerima callback transaksi.
Request dan response memakai protokol HTTP GET.

Cek Saldo

Mengambil saldo akun mitra secara real-time.

POSThttps://api.todagames.id/api/v1/saldo

Parameter

Parameter	Keterangan	Tipe	Wajib
`api_key`	API Key dari dashboard.	String	Ya
`member_code`	Member Code dari dashboard.	String	Ya
`sign`	`md5(member_code + api_key + "saldo")`	String	Ya

Contoh Request

{
  "api_key": "apikeyxxxxxxxxxxxx",
  "member_code": "membercodexxxxxxxxx",
  "sign": "signxxxxxxxxxxxxxxxxxxxxxxx"
}

Response Berhasil

{
  "status": true,
  "msg": "Berhasil cek Saldo",
  "data": {
    "balance": "6600"
  }
}

Deposit

Membuat invoice deposit saldo untuk mitra.

POSThttps://api.todagames.id/api/v1/deposit

Parameter

Parameter	Keterangan	Tipe	Wajib
`api_key`	API Key dari dashboard.	String	Ya
`member_code`	Member Code dari dashboard.	String	Ya
`amount`	Jumlah deposit.	String	Ya
`method`	Metode pembayaran, contoh `BANK BCA` atau `BANK BRI`.	String	Ya
`sign`	`md5(member_code + api_key + "deposit")`	String	Ya

Contoh Request

{
  "api_key": "apikeyxxxxxxxxxxxx",
  "member_code": "membercodexxxxxxxxx",
  "amount": "100000",
  "method": "BANK BCA",
  "sign": "signxxxxxxxxxxxxxxxxxxxxxxx"
}

Response Berhasil

{
  "status": true,
  "msg": "Berhasil Topup Saldo",
  "data": {
    "invoice": "DEP20260309142551205",
    "bank": "BANK BCA",
    "amount": 10000,
    "norek": "12345678",
    "an": "testing",
    "date_create": "2026-03-09 14:25:51"
  }
}

Daftar Produk

Mengambil daftar produk, kode produk, harga, dan status produk.

POSThttps://api.todagames.id/api/v1/service

Parameter

Parameter	Keterangan	Tipe	Wajib
`api_key`	API Key dari dashboard.	String	Ya
`member_code`	Member Code dari dashboard.	String	Ya
`sign`	`md5(member_code + api_key + "service")`	String	Ya

Contoh Request

{
  "api_key": "apikeyxxxxxxxxxxxx",
  "member_code": "membercodexxxxxxxxx",
  "sign": "signxxxxxxxxxxxxxxxxxxxxxxx"
}

Response Berhasil

{
  "status": true,
  "msg": "Berhasil mendapatkan data layanan",
  "data": [
    {
      "product": "Free Fire 7290 Diamond",
      "category": "Games",
      "brand": "Free Fire",
      "type": "Umum",
      "price": "838415",
      "code": "FF7290",
      "status": "On"
    }
  ]
}

Transaksi

Membuat transaksi top up atau pembelian produk.

POSThttps://api.todagames.id/api/v1/order

Parameter

Parameter	Keterangan	Tipe	Wajib
`api_key`	API Key dari dashboard.	String	Ya
`member_code`	Member Code dari dashboard.	String	Ya
`ref_id`	Ref ID unik dari sistem Anda.	String	Ya
`code`	Kode produk TODAGAMES.	String	Ya
`user_id`	User ID tujuan.	String	Ya
`zone_id`	ID Zone tujuan. Isi `1` jika tidak diperlukan.	String	Tidak
`sign`	`md5(member_code + api_key + "order")`	String	Ya

Contoh Request

{
  "api_key": "apikeyxxxxxxxxxxxx",
  "member_code": "membercodexxxxxxxxx",
  "ref_id": "ORDER-XXXXXXXXXXX",
  "code": "FF70",
  "user_id": "662XXXXXX",
  "zone_id": "1",
  "sign": "signxxxxxxxxxxxxxxxxxxxxxxx"
}

Response Berhasil

{
  "status": true,
  "msg": "Pesanan berhasil! Pesanan sedang diproses",
  "data": {
    "ref_id": "ORDER-5737XXXXXX",
    "product": "Free Fire 70 Diamond",
    "user_id": "662444522",
    "zone_id": "1",
    "status": "Processing",
    "note": ""
  }
}

Status Transaksi

Melihat status terbaru berdasarkan Ref ID.

POSThttps://api.todagames.id/api/v1/status

Parameter

Parameter	Keterangan	Tipe	Wajib
`api_key`	API Key dari dashboard.	String	Ya
`member_code`	Member Code dari dashboard.	String	Ya
`ref_id`	Ref ID unik dari sistem Anda.	String	Ya
`sign`	`md5(member_code + api_key + "ref_id")`	String	Ya

Contoh Request

{
  "api_key": "apikeyxxxxxxxxxxxx",
  "member_code": "membercodexxxxxxxxx",
  "ref_id": "ORDER-XXXXXXXXXXX",
  "sign": "signxxxxxxxxxxxxxxxxxxxxxxx"
}

Response Berhasil

{
  "status": true,
  "msg": "Detail transaksi berhasil didapatkan",
  "data": {
    "ref_id": "ORDER-5637XXXXXX",
    "product": "Free Fire 70 Diamond",
    "status": "Success",
    "note": "Vemz444Goat' Reff ID : 639XXXXX"
  }
}

Respon Gagal

Beberapa response error umum dari REST API.

Error

{
    "status": false,
    "msg": "Payload tidak boleh kosong"
}

Error

{
    "status": false,
    "msg": "Api Key dan Member Code tidak boleh kosong"
}

Error

{
    "status": false,
    "msg": "Api dan Member Code tidak valid"
}

Error

{
    "status": false,
    "msg": "Signature Tidak Valid."
}

Error

{
    "status": false,
    "msg": "ref_id sudah tersedia pada sistem kami",
    "data": {
        "status": "error"
    }
}

Error

{
    "status": false,
    "msg": "code tidak ditemukan"
}

Error

{
    "status": false,
    "msg": "Saldo anda tidak mencukupi"
}

Error

{
    "status": false,
    "msg": "ref_id tidak ditemukan",
    "data": {
        "ref_id": "",
        "status": "error"
    }
}

Error

{
    "status": false,
    "msg": "IP Anda tidak kami kenali: 125.1.xxxxxx"
}

Transaksi via IP (Otomax, IRS, Dll)

Endpoint GET untuk transaksi berbasis IP/Otomax.

GEThttps://api.todagames.id/api/v1/otomax/transaction

Parameter

Parameter	Keterangan	Tipe	Wajib
`ref_id`	Ref ID unik dari software yang Anda gunakan.	String	Ya
`produk`	Kode produk di TODAGAMES.	String	Ya
`tujuan`	Nomor tujuan, Player ID, User ID, atau Nomor HP.	String	Ya
`server_id`	Server ID game. Kosongkan jika tidak diperlukan.	String	Tidak
`api_key`	API Key dari dashboard.	String	Ya
`member_code`	Member Code dari dashboard.	String	Ya

Contoh Request

https://api.todagames.id/api/v1/otomax/transaction?ref_id=87291725371672631&produk=FF5&tujuan=662444&api_key=xxxxxxxxxxxxx&member_code=xxxxxxxxxxx

Response Proses

#Request TRX #TODA-IP1777230637703635546. REFID#87291725371672631. Sedang Di Proses. Harga:863. Sisa Saldo:109578. KP:FF5.662444 Tanggal:2026-02-14 0:52:08

Response Sukses

#Request TRX #TODA-IP6306895306374681318. REFID#87291725371672631. SUKSES, SN:kipli tzy/662444522/Free Fire 5 Diamond. Harga:863. Saldo:109579. KP:FF5.662444522 Tanggal:13/2/2026 09.22.36

Respon Gagal IP/Otomax

Contoh response gagal pada jalur GET.

Error

GAGAL. Member tidak valid

Error

GAGAL. Produk tidak ditemukan

Error

GAGAL. REFID sudah ada

Error

GAGAL. Saldo tidak cukup

Error

#Request TRX #TODA-IP7536011291065731020. REFID#87291725371672631. GAGAL, SN:Invalid ID. Harga:863. Saldo:109579. KP:FF5.662444 Tanggal:13/2/2026 10.24.56

Webhook POST

Webhook dikirim ke URL report Anda saat status transaksi berubah.

Pastikan IP server TODAGAMES sudah di-whitelist di server Anda: 203.194.114.233.

Transaksi Sukses

{
  "status": "Success",
  "message": "Transaksi Berhasil",
  "sn": "kipli tzy/662444522/Free Fire 5 Diamond",
  "ref_id": "TODA7536011291065731020",
  "order_id": "API4092128335991436281",
  "produk": "FF5",
  "sisa_saldo": 109759,
  "price": 835
}

Transaksi Gagal

{
  "status": "Cancelled",
  "message": "Transaksi Gagal",
  "sn": "Invalid ID",
  "ref_id": "TODA7536011291065731020",
  "order_id": "API4092128335991436281",
  "produk": "FF5",
  "sisa_saldo": 109759,
  "price": 835
}

Penjelasan Field

Field	Deskripsi
`status`	Status akhir transaksi, yaitu `Success` atau `Cancelled`.
`message`	Pesan detail transaksi.
`sn`	Serial Number.
`ref_id`	Ref ID unik dari sistem Anda.
`order_id`	ID transaksi dari TODAGAMES.
`produk`	Kode produk yang dibeli.
`sisa_saldo`	Sisa saldo Anda setelah transaksi.
`price`	Harga produk yang dibeli.

Report Transaksi IP/Otomax

Report dikirim via GET request ke URL Anda.

Pastikan IP server TODAGAMES sudah di-whitelist di server Anda: 203.194.114.233.

Parameter	Keterangan
`serverid`	ID transaksi / order ID TODAGAMES.
`clientid`	ID transaksi / ref ID client.
`statuscode`	Status transaksi: `1` sukses, `0` gagal.
`kp`	Kode produk.
`msisdn`	Nomor tujuan transaksi.
`sn`	Serial Number.
`msg`	Keterangan atau pesan transaksi.

Transaksi Sukses

https://url-mitra.com/report?serverid=TODA-IP6306895306374681318&clientid=87291725371672631&statuscode=1&kp=FF5&msisdn=662444522&sn=kipli tzy/662444522/Free Fire 5 Diamond&msg=#Request TRX #TODA-IP6306895306374681318. REFID#87291725371672631. SUKSES, SN:kipli tzy/662444522/Free Fire 5 Diamond. Harga:863. Saldo:109579. KP:FF5.662444522 Tanggal:13/2/2026 09.22.36

Transaksi Gagal

https://url-mitra.com/report?serverid=TODA-IP7536011291065731020&clientid=87291725371672631&statuscode=0&kp=FF5&msisdn=662444&sn=Invalid ID&msg=#Request TRX #TODA-IP7536011291065731020. REFID#87291725371672631. GAGAL, SN:Invalid ID. Harga:863. Saldo:109579. KP:FF5.662444 Tanggal:13/2/2026 10.24.56