API H2H Integration

Kumpletong dokumentasyon para sa automated system integration.

Para ito sa partners, resellers, at developers na gustong direktang ikonekta ang kanilang system sa TokoGue.

Base URL

https://api.tokogue.com/api

Format

JSON Request / Response

Pangkalahatang-ideya

Pangkalahatang daloy ng H2H integration para sa TokoGue.

Kasalukuyang access scheme

Gamitin ang X-API-KEY para sa public API at JWT token para sa partner/member transactions.

Inirerekomendang integration model

Mag-login, i-sync ang catalog, gumawa ng order, at subaybayan ang status hanggang matapos.

Authentication

Mga minimum header upang tanggapin ang request.

Public / catalog endpoint headers

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

Partner transaction endpoint headers

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

Integration Flow

Inirerekomendang technical flow para maging mas stable ang partner system.

1. Login

Mag-login sa partner account upang kumuha ng aktibong JWT token.

2. Config

I-set ang IP whitelist at callback URL sa partner account.

3. Sync

Kunin ang games, products, price list, at promos.

4. Validation

Tingnan ang game region o nickname kapag kailangan.

5. Order

Ipadala ang automated transaction sa order endpoint.

6. Polling

Subaybayan ang transaction hanggang final status.

I-sync ang Produkto

Mga endpoint para sa catalog at product validation.

GET/api/games

Kunin ang listahan ng games.

GET/api/games/{slug}

Kunin ang game details at order products.

GET/api/price-list

I-sync ang product prices.

GET/api/promo

Kunin ang active promos o flash sales.

POST/api/mlbb/check-region

I-validate ang game input bago umorder.

Mga Transaksyon

Pangunahing endpoint para gumawa ng automated partner transaction.

POST/api/orders

Gumawa ng automated order mula sa partner system.

Tingnan ang Status

Endpoint para subaybayan ang transaction pagkatapos gawin ang order.

GET/api/orders/{orderId}

Tingnan ang order details gamit ang reference.

GET/api/transactions

Kunin ang transaction history ng partner account.

GET/api/transaction-summary

Kunin ang transaction summary ng partner account.

Partner Configuration

Mga endpoint para sa partner account at H2H settings.

POST/api/auth/login

Mag-login sa partner account at kunin ang JWT.

GET/api/auth/user

I-validate ang active login token.

GET/api/member/profile

Tingnan ang API key, IP whitelist, at callback URL.

PUT/api/member/api-config

I-save ang IP whitelist at callback URL.

POST/api/member/api-key/reset

I-reset ang member API key.

Mga Halimbawa ng Request

Mga minimum example para sa H2H integration.

Partner Login

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

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

Tingnan ang Order Status

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

Mahahalagang Tala

Mga tala upang maiwasan ang maling assumption sa implementation.

Available ang api_key, api_whitelist_ips, at callback_url fields sa member account at mase-save sa backend.

Sa kasalukuyang backend, hindi pa ginagamit ang IP whitelist para sa request validation at ang callback URL para mag-push ng status sa partner endpoint.

Ang inirerekomendang pattern ay JWT-based H2H: partner login, save token, send order, at polling hanggang final status.

Kapag idinagdag ang IP whitelist validation o outbound callback, mapapalawak ang docs nang hindi binabago ang core order flow.