API H2H Integration

Dokumentasi lengkap untuk integrasi sistem automatik.

Dokumentasi ini untuk rakan kongsi, penjual semula dan pembangun yang mahu menghubungkan sistem terus ke TokoGue.

Base URL

https://api.tokogue.com/api

Format

JSON Request / Response

Gambaran Keseluruhan

Gambaran keseluruhan integrasi H2H yang sesuai dengan sistem TokoGue.

Skim akses semasa

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

Model integrasi yang disyorkan

Log masuk partner, selaraskan katalog, buat pesanan, kemudian pantau status hingga selesai.

Pengesahan

Header minimum yang diperlukan agar permintaan diterima.

Header endpoint awam / 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

Aliran Integrasi

Aliran teknikal yang disyorkan agar sistem partner lebih stabil.

1. Login

Log masuk akaun partner untuk mendapatkan token JWT aktif.

2. Config

Tetapkan senarai putih IP dan callback URL pada akaun partner.

3. Sync

Ambil permainan, produk, senarai harga dan promosi.

4. Validation

Semak region atau nama samaran permainan jika diperlukan.

5. Order

Hantar transaksi automatik ke endpoint pesanan.

6. Polling

Pantau butiran transaksi hingga status akhir.

Selaras Produk

Endpoint untuk mengambil katalog dan mengesahkan produk.

GET/api/games

Ambil senarai permainan.

GET/api/games/{slug}

Ambil butiran permainan dan produk pesanan.

GET/api/price-list

Selaraskan harga produk.

GET/api/promo

Ambil promosi atau jualan kilat aktif.

POST/api/mlbb/check-region

Sahkan input permainan sebelum membuat pesanan.

Transaksi

Endpoint utama untuk membuat transaksi automatik dari sistem partner.

POST/api/orders

Buat pesanan automatik dari sistem partner.

Semak Status

Endpoint untuk memantau transaksi selepas pesanan dibuat.

GET/api/orders/{orderId}

Semak butiran pesanan berdasarkan rujukan.

GET/api/transactions

Ambil sejarah transaksi akaun partner.

GET/api/transaction-summary

Ambil ringkasan transaksi akaun partner.

Konfigurasi Partner

Endpoint akaun partner dan tetapan H2H.

POST/api/auth/login

Log masuk akaun partner dan ambil JWT.

GET/api/auth/user

Sahkan token log masuk aktif.

GET/api/member/profile

Lihat API key, senarai putih IP dan callback URL ahli.

PUT/api/member/api-config

Simpan senarai putih IP dan callback URL.

POST/api/member/api-key/reset

Tetapkan semula API key akaun ahli.

Contoh Permintaan

Contoh minimum yang biasa digunakan untuk integrasi H2H.

Log Masuk Partner

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

Semak 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 membuat andaian yang salah semasa pelaksanaan.

Field api_key, api_whitelist_ips dan callback_url tersedia pada akaun ahli dan boleh disimpan melalui backend.

Dalam pelaksanaan backend semasa, senarai putih IP belum digunakan untuk pengesahan permintaan dan callback URL belum digunakan untuk menghantar status ke endpoint partner.

Pola yang disyorkan ialah H2H berasaskan JWT: log masuk partner, simpan token, hantar pesanan, kemudian polling status hingga selesai.

Jika pengesahan senarai putih IP atau outbound callback ditambah, dokumentasi ini boleh diperluas tanpa mengubah aliran utama pesanan.