Dokumentasi API

Selamat datang di Dokumentasi API Todagames. Kami menyediakan jalur integrasi melalui API JSON (REST) dan koneksi IP/OTOMAX untuk memudahkan Anda menghubungkan sistem aplikasi Anda dengan layanan Todagames secara otomatis, cepat, dan aman.

Dengan API ini, Anda dapat mengakses fitur seperti pengecekan saldo, daftar produk, pembuatan transaksi, serta pengecekan status transaksi secara real-time tanpa perlu proses manual.

Pengenalan

API JSON (REST API)

API JSON menggunakan arsitektur REST dan berkomunikasi melalui protokol HTTP/HTTPS. Seluruh request dan response menggunakan format application/json.

Semua transaksi dikirim menggunakan method POST dengan header wajib: Content-Type: application/json. Metode ini cocok untuk integrasi website, backend server, maupun aplikasi mobile.

IP / OTOMAX

Selain REST API, tersedia juga koneksi IP/OTOMAX untuk integrasi berbasis whitelist IP atau sistem H2H (Host to Host). Metode ini dirancang untuk kebutuhan server langsung dengan performa tinggi dan koneksi yang lebih stabil.

Jalur ini direkomendasikan bagi mitra yang membutuhkan transaksi volume besar, proses otomatis penuh, serta latensi yang lebih rendah.

Persiapan

Sebelum mulai melakukan integrasi, pastikan Anda telah menyelesaikan beberapa konfigurasi berikut agar koneksi ke sistem Todagames berjalan dengan aman dan stabil.

Koneksi API JSON (REST)

Dapatkan API Key dan Member Code melalui Dashboard.
Tambahkan Whitelist IP (development & production) pada Dashboard.
Set header request: Content-Type: application/json.
Seluruh transaksi dikirim menggunakan method POST.
Tambahkan URL Report/Webhook untuk menerima notifikasi status transaksi otomatis.
Whitelist IP server Todagames berikut pada sistem Anda:
```
203.194.114.233
```

Header wajib setiap request:

Content-Type: application/json

Koneksi IP / OTOMAX (H2H)

Dapatkan API Key dan Member Code.
Tambahkan Whitelist IP (development & production).
Tambahkan URL Report/Webhook untuk menerima callback transaksi.
Komunikasi request & response menggunakan protokol HTTP GET.
Whitelist IP server Todagames berikut:
```
203.194.114.233
```

Cek Saldo

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

Parameter

Parameter	Keterangan	Tipe	Wajib
`api_key`	ApiKey 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

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

Parameter

Parameter	Keterangan	Tipe	Wajib
`api_key`	ApiKey dari dashboard	String	Ya
`member_code`	Member Code dari dashboard	String	Ya
`amount`	Jumlah deposit	String	Ya
`method`	Metode pembayaran (BANK BCA, 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

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

Parameter

Parameter	Keterangan	Tipe	Wajib
`api_key`	ApiKey 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"
    },
    {
      "product": "Free Fire 720 Diamond",
      "category": "Games",
      "brand": "Free Fire",
      "type": "Umum",
      "price": "83738",
      "code": "FF720",
      "status": "On"
    }
  ]
}

Transaksi

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

Parameter

Parameter	Keterangan	Tipe	Wajib
`api_key`	ApiKey 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 (jika tidak ada isi 1)	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

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

Parameter

Parameter	Keterangan	Tipe	Wajib
`api_key`	ApiKey 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

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

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

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

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

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

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

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

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

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

Transaksi via IP (Otomax, IRS, Dll)

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`	ApiKey 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

GAGAL. Member tidak valid

GAGAL. Produk tidak ditemukan

GAGAL. REFID sudah ada

GAGAL. Saldo tidak cukup

#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

Halaman ini menjelaskan format webhook (callback) yang kami kirimkan ke server Anda setiap kali ada perubahan status transaksi.

Notifikasi status transaksi otomatis dikirim ke URL yang Anda daftarkan pada dashboard melalui metode POST dengan format application/json.

Penting: Pastikan IP kami sudah di-whitelist di server Anda: 203.194.114.233

Format Webhook

Transaksi Sukses:

{
    "status": "Success",
    "message": "Transaksi Berhasil",
    "sn": "kipli\u3164tzy\/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

Parameter

Field	Deskripsi
`status`	Status akhir transaksi (`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)

Halaman ini menjelaskan format report yang kami kirimkan ke URL Anda jika menggunakan transaksi via IP (untuk Otomax, IRS, dll).

Penting: Pastikan IP kami sudah di-whitelist di server Anda: 203.194.114.233

Format Report

Report dikirimkan via GET request ke URL Anda dengan parameter berikut:

Parameter

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 / 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