API H2H Integration

Dokumentasi lengkap untuk integrasi sistem otomatis.

Dokumentasi ini ditujukan bagi partner, reseller, dan pengembang yang ingin menghubungkan sistem langsung ke TokoGue.

Base URL

https://api.tokogue.com/api

Format

JSON Request / Response

Ringkasan

Gambaran umum pola integrasi H2H yang sesuai dengan sistem TokoGue.

Skema akses saat ini

Gunakan X-API-KEY untuk akses API umum dan JWT token untuk transaksi partner/member.

Model integrasi yang disarankan

Autentikasi

Header minimum yang diperlukan agar request dapat 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

Alur Integrasi

Alur teknis yang direkomendasikan agar sistem partner lebih stabil.

1. Login

2. Config

Atur whitelist IP dan callback URL pada akun partner.

3. Sync

Ambil game, produk, daftar harga, dan promo.

4. Validation

Cek region atau nickname game bila diperlukan.

5. Order

Kirim transaksi otomatis ke endpoint pesanan.

6. Polling

Pantau detail transaksi sampai status akhir.

Sinkron Produk

Endpoint untuk mengambil katalog dan memvalidasi produk.

GET/api/games

Ambil daftar game.

GET/api/games/{slug}

Ambil detail game dan produk pesanan.

GET/api/price-list

Sinkronkan harga produk.

GET/api/promo

Ambil promo atau flash sale aktif.

POST/api/mlbb/check-region

Validasi input game sebelum membuat pesanan.

Transaksi

Endpoint inti untuk membuat transaksi otomatis dari sistem partner.

POST/api/orders

Buat pesanan otomatis dari sistem partner.

Cek Status

Endpoint untuk memantau transaksi setelah pesanan dibuat.

GET/api/orders/{orderId}

Cek detail pesanan berdasarkan referensi.

GET/api/transactions

Ambil riwayat transaksi akun partner.

GET/api/transaction-summary

Ambil ringkasan transaksi akun partner.

Konfigurasi Partner

Endpoint akun partner dan pengaturan H2H.

POST/api/auth/login

GET/api/auth/user

Validasi token login aktif.

GET/api/member/profile

Lihat API key, whitelist IP, dan callback URL member.

PUT/api/member/api-config

Simpan whitelist IP dan callback URL.

POST/api/member/api-key/reset

Reset API key akun member.

Contoh Request

Contoh minimum yang umum digunakan untuk 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"
  }'

Buat Pesanan

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"
  }'

Cek Status Pesanan

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

Catatan agar partner tidak salah membuat asumsi saat implementasi.

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

Pada implementasi backend saat ini, whitelist IP belum digunakan untuk validasi request dan callback URL belum digunakan untuk mengirim status ke endpoint partner.

Pola yang direkomendasikan saat ini adalah H2H berbasis JWT: login partner, simpan token, kirim pesanan, lalu polling status sampai selesai.

Jika validasi whitelist IP atau outbound callback ditambahkan, dokumentasi ini dapat diperluas tanpa mengubah alur inti pembuatan pesanan.