API H2H Integration

Dokumentasi lengkap untuk integrasi otomatis sistem

Dokumentasi ini khusus untuk partner, reseller, dan pengembang yang ingin menghubungkan sistem mereka langsung ke Tokogue. Format halaman dibuat dengan gaya dokumentasi teknis: navigasi section, endpoint penting, contoh request, dan catatan implementasi yang langsung bisa dipakai.

Base URL

https://api.tokogue.com/api

Format

JSON Request / Response

Overview

Gambaran umum pola integrasi H2H yang saat ini paling sesuai dengan sistem Tokogue.

Skema akses saat ini

Integrasi partner yang paling aman saat ini memakai kombinasi X-API-KEY untuk akses API umum dan JWT token untuk transaksi partner/member.

Model integrasi yang disarankan

Authentication

Header minimum yang perlu dipakai agar request bisa diterima.

Header endpoint publik / katalog

Content-Type: application/json
Accept: application/json
X-API-KEY: YOUR_GLOBAL_API_KEY

Header endpoint transaksi partner

Content-Type: application/json
Accept: application/json
X-API-KEY: YOUR_GLOBAL_API_KEY
Authorization: Bearer YOUR_JWT_TOKEN

Flow Integrasi

Alur teknis yang direkomendasikan agar sistem partner lebih stabil.

1. Login

2. Simpan Config

Atur whitelist IP dan callback URL pada akun partner.

3. Sync Katalog

Ambil game, produk, price list, dan promo.

4. Validasi Input

Cek region / nickname game bila diperlukan.

5. Create Order

Kirim transaksi otomatis ke endpoint order.

6. Polling Status

Pantau detail transaksi sampai status final.

Sinkron Produk

Endpoint yang umum dipakai partner untuk menarik katalog dan validasi produk.

GET/api/games

Ambil daftar game.

GET/api/games/{slug}

Ambil detail game dan produk order.

GET/api/price-list

Sinkron harga produk.

GET/api/promo

Ambil promo / flash sale aktif.

POST/api/mlbb/check-region

Validasi user input game sebelum order.

Transaksi

Endpoint inti untuk membuat transaksi otomatis dari sistem partner.

POST/api/orders

Buat order otomatis dari sistem partner.

Cek Status

Endpoint untuk memantau transaksi setelah order berhasil dibuat.

GET/api/orders/{orderId}

Cek detail order berdasarkan reference.

GET/api/transactions

Ambil riwayat transaksi akun partner.

GET/api/transaction-summary

Ambil ringkasan transaksi akun partner.

Konfigurasi Partner

Endpoint yang berhubungan dengan akun partner dan pengaturan H2H.

POST/api/auth/login

GET/api/auth/user

Validasi token login aktif.

GET/api/member/profile

Lihat API key member, whitelist IP, callback URL.

PUT/api/member/api-config

Simpan whitelist IP dan callback URL.

POST/api/member/api-key/reset

Reset API key milik akun member.

Callback & Webhook

Endpoint server-to-server dari payment gateway dan provider.

POST/api/tripay/callback

Callback payment gateway Tripay.

POST/api/paydisini/callback

Callback payment gateway Paydisini.

POST/api/duitku/callback

Callback payment gateway Duitku.

POST/api/digiflazz/webhook

Webhook update status provider Digiflazz.

Contoh Request

Contoh minimum yang paling sering dipakai saat membangun integrasi H2H.

curl -X POST "https://api.tokogue.com/api/auth/login" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_GLOBAL_API_KEY" \
  -d '{
    "email": "partner@tokogue.com",
    "password": "your-password"
  }'

Create Order

curl -X POST "https://api.tokogue.com/api/orders" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_GLOBAL_API_KEY" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "games": "mobile-legends",
    "id_games": "12345678",
    "server_games": "1234",
    "product": "86 Diamonds",
    "nominal": "86 Diamonds",
    "price": 22000,
    "payment_name": "Saldo",
    "payment_code": "SALDO"
  }'

Check Status Order

curl -X GET "https://api.tokogue.com/api/orders/INV-EXAMPLE-12345" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_GLOBAL_API_KEY"

Catatan Penting

Bagian ini sengaja dibuat jelas agar partner tidak salah asumsi saat implementasi.

Field api_key, api_whitelist_ips, dan callback_url pada akun member sudah tersedia dan bisa disimpan melalui backend.

Namun dari implementasi backend saat ini, api_whitelist_ips belum terlihat dipakai sebagai validasi request, dan callback_url belum terlihat dipakai untuk push status keluar ke endpoint partner.

Karena itu, pola integrasi yang direkomendasikan saat ini adalah JWT-based H2H: login partner, simpan token, kirim order, lalu polling status sampai final.

Jika nanti backend Tokogue menambahkan validasi whitelist IP atau outbound callback partner, dokumentasi ini bisa langsung diperluas tanpa mengubah alur inti create order.