Hacksaw Integration Guide

Panduan Integrasi Hacksaw

Connect an operator, create players, launch Ze Zeus, and integrate either a transfer or seamless wallet using the production API contract.

Hubungkan operator, buat pemain, launch Ze Zeus, dan integrasikan transfer atau seamless wallet menggunakan kontrak API production.

Overview

Gambaran Umum

The authenticated operator determines wallet mode, currency, player ownership, and access. Game launch and wallet endpoints never accept a client-selected wallet strategy.

Operator yang terautentikasi menentukan mode wallet, currency, kepemilikan pemain, dan akses. Endpoint game launch dan wallet tidak menerima strategi wallet pilihan client.

Transfer wallet: this backend owns the playable balance and updates it atomically in PostgreSQL.

Transfer wallet: backend ini menjadi pemilik saldo bermain dan memperbaruinya secara atomik di PostgreSQL.

Seamless wallet: the operator owns the balance. This backend sends signed callbacks to the operator's configured callback URL.

Seamless wallet: operator menjadi pemilik saldo. Backend ini mengirim callback bertanda tangan ke callback URL operator.

Authentication

Autentikasi

All operator endpoints under /api/v1/users, /api/v1/game, and /api/v1/wallet require an active API token as a bearer token.

Semua endpoint operator di bawah /api/v1/users, /api/v1/game, dan /api/v1/wallet memerlukan API token aktif sebagai bearer token.

Keep API tokens and secret keys on a trusted server. Never embed them in browser JavaScript, mobile applications, launch URLs, logs, or public repositories.

Simpan API token dan secret key di server tepercaya. Jangan menaruhnya di JavaScript browser, aplikasi mobile, launch URL, log, atau repository publik.

If an operator has an IP allowlist, requests must arrive from an allowed address. X-Request-ID is optional and is returned in the response headers.

Jika operator memiliki IP allowlist, request harus berasal dari alamat yang diizinkan. X-Request-ID opsional dan dikembalikan pada header respons.

Required headersHeader wajib

Authorization: Bearer <operator_api_token>
Content-Type: application/json
X-Request-ID: 6ca6a797-a9d6-4b16-ae51-f4184472ba23

Common Response Format

Format Respons Umum

Every application outcome uses HTTP 200 OK. Read the JSON status and code; do not infer the result from HTTP status.

Semua hasil aplikasi menggunakan HTTP 200 OK. Baca status dan code pada JSON; jangan menentukan hasil dari HTTP status.

A success response has data and no error. An error response has error and no data.

Respons sukses memiliki data tanpa error. Respons gagal memiliki error tanpa data.

SuccessSukses

{
  "status": true,
  "code": "SUCCESS",
  "data": {}
}

Error

{
  "status": false,
  "code": "VALIDATION_ERROR",
  "error": {}
}

Integer Money Rules

Aturan Nominal Integer

All wallet amounts are signed 64-bit JSON integers in minor units. Never send floating-point values or numeric strings. A mutation amount must be from 1 through 1000000000000.

Semua nominal wallet adalah integer JSON 64-bit dalam minor unit. Jangan mengirim floating-point atau string angka. Amount mutasi harus dari 1 sampai 1000000000000.

IDR: configured with zero decimal places and multiplier 1, so 1000 means IDR 1,000.
Currency: exactly three uppercase ASCII letters and must match the player.
Overflow: credits that exceed integer balance capacity are rejected.

IDR: dikonfigurasi tanpa angka desimal dan multiplier 1, jadi 1000 berarti IDR 1.000.
Currency: tepat tiga huruf ASCII kapital dan harus sama dengan currency pemain.
Overflow: credit yang membuat saldo melewati kapasitas integer akan ditolak.

Idempotency

reference_id is the operator-scoped idempotency key for debit, credit, deposit, and withdraw. rollback_reference_id is the key for rollback.

reference_id adalah idempotency key per operator untuk debit, credit, deposit, dan withdraw. rollback_reference_id adalah key untuk rollback.

Retry an identical request with the same key to receive the original result.
Reusing a key with different user, amount, currency, or operation returns IDEMPOTENCY_CONFLICT.
One completed transaction can be rolled back only once.
A seamless mutation timeout is an unknown outcome. Reconcile it before retrying.

Retry request identik dengan key yang sama untuk menerima hasil awal.
Memakai ulang key dengan user, amount, currency, atau operasi berbeda menghasilkan IDEMPOTENCY_CONFLICT.
Satu transaksi completed hanya dapat di-rollback satu kali.
Timeout mutasi seamless adalah hasil yang belum diketahui. Lakukan rekonsiliasi sebelum retry.

Games: Hosts & Base URLs

Game: Host & Base URL

The API host serves operator and native gameplay APIs. The game host serves the Ze Zeus client and its static assets. The documentation host serves this guide and its protected trial launcher.

Host API melayani API operator dan gameplay native. Host game melayani client Ze Zeus beserta aset statis. Host dokumentasi melayani panduan ini dan trial launcher yang terlindungi.

Production hostsHost production

Operator API   https://api-hacksaw.ohmybet.online
Game client    https://hacksaw.ohmybet.online
Documentation https://hacksaw-docs.pages.dev

https://api-hacksaw.ohmybet.online/api/v1

Create a Player

Buat Pemain

Create the player before launch. external_user_id is the stable identity within one operator. A duplicate identity returns USER_ALREADY_EXISTS.

Buat pemain sebelum launch. external_user_id adalah identitas stabil di dalam satu operator. Identitas duplikat menghasilkan USER_ALREADY_EXISTS.

POST/api/v1/users

Request fields

Field request

operator_id      string  required  Authenticated operator UUID
external_user_id string  required  Stable player identity
username         string  optional  Display name
currency         string  required  Exact uppercase currency

operator_id      string  wajib     UUID operator terautentikasi
external_user_id string  wajib     Identitas pemain yang stabil
username         string  opsional  Nama tampilan
currency         string  wajib     Currency kapital yang tepat

Request bodyBody request

{
  "operator_id": "<operator_uuid>",
  "external_user_id": "player-1001",
  "username": "Player 1001",
  "currency": "IDR"
}

Success responseRespons sukses

{
  "status": true,
  "code": "SUCCESS",
  "data": {
    "id": "7cf96ba7-9bca-4eb8-9823-65423fdc32f1",
    "operator_id": "<operator_uuid>",
    "external_user_id": "player-1001",
    "username": "Player 1001",
    "currency": "IDR",
    "balance_amount": 0,
    "rtp": 96.00,
    "status": "active",
    "created_at": "2026-06-15T12:00:00Z",
    "updated_at": "2026-06-15T12:00:00Z"
  }
}

Launch a Game

Launch Game

Request a fresh launch URL from your trusted backend, then redirect or open it in the player's browser. The launch session expires after 30 minutes.

Minta launch URL baru dari backend tepercaya Anda, lalu redirect atau buka URL tersebut di browser pemain. Sesi launch berakhir setelah 30 menit.

POST/api/v1/game/launch

Request fields

Field request

game_code       string  required  Canonical game ID, currently "1508"
external_user_id string required  Existing active player
currency        string  required  Must match player currency
language        string  optional  Defaults to "en"
device          string  optional  "desktop" or "mobile"

game_code       string  wajib     ID game kanonik, saat ini "1508"
external_user_id string wajib     Pemain aktif yang sudah ada
currency        string  wajib     Harus sama dengan currency pemain
language        string  opsional  Default "en"
device          string  opsional  "desktop" atau "mobile"

Unknown games return NOT_FOUND. Unknown players return USER_NOT_FOUND. Currency mismatch returns CURRENCY_MISMATCH.

Game tidak dikenal menghasilkan NOT_FOUND. Pemain tidak dikenal menghasilkan USER_NOT_FOUND. Currency berbeda menghasilkan CURRENCY_MISMATCH.

Request bodyBody request

{
  "game_code": "1508",
  "external_user_id": "player-1001",
  "currency": "IDR",
  "language": "en",
  "device": "desktop"
}

Success responseRespons sukses

{
  "status": true,
  "code": "SUCCESS",
  "data": {
    "launch_url": "https://hacksaw.ohmybet.online/1508/1.32.0/index.html?...",
    "game_code": "1508",
    "currency": "IDR"
  }
}

curl

curl -sS https://api-hacksaw.ohmybet.online/api/v1/game/launch \
  -H "Authorization: Bearer <operator_api_token>" \
  -H "Content-Type: application/json" \
  --data '{
    "game_code":"1508",
    "external_user_id":"player-1001",
    "currency":"IDR",
    "language":"en",
    "device":"desktop"
  }'

Native Gameplay Protocol

Protokol Gameplay Native

After launch, the game client calls these endpoints directly. Operators should not call them and should not parse or modify their payloads.

Setelah launch, client game memanggil endpoint berikut secara langsung. Operator tidak perlu memanggil, membaca, atau mengubah payload-nya.

POST /api/play/authenticate
POST /api/play/gameLaunch
POST /api/play/bet
GET /api/meta/gameInfo

Native responses use statusCode and statusMessage, not the operator API envelope. A native success has statusCode: 0.

Respons native menggunakan statusCode dan statusMessage, bukan envelope API operator. Respons native sukses memiliki statusCode: 0.

Native success exampleContoh sukses native
{
  "statusCode": 0,
  "statusMessage": "",
  "serverTime": "2026-06-15T12:00:00Z"
}
Native error exampleContoh error native
{
  "statusCode": 7,
  "statusMessage": "Session expired"
}

Supported Games

Game Tersedia

The production catalog currently exposes one canonical game configuration.

Katalog production saat ini menyediakan satu konfigurasi game kanonik.

game_code          1508
name               Ze Zeus
version            1.32.0
currency           IDR
currency decimals  0
currency multiplier 1
bet levels         10, 20, 50, 100, 200, 500, 1000
default bet        100
max exposure       10000000
max feature cost   250000

Live Trial

Coba Langsung

The button calls a same-origin Cloudflare Pages Function. The function keeps the operator token server-side, requests a fresh launch URL for the fixed trial player, and returns only the launch result.

Tombol memanggil Cloudflare Pages Function pada origin yang sama. Function menyimpan token operator di server, meminta launch URL baru untuk pemain trial tetap, dan hanya mengembalikan hasil launch.

game       Ze Zeus
game_code  1508
currency   IDR
player     trial-player-001

Ze Zeus

slot

Production trial using a dedicated transfer-wallet player.

Trial production menggunakan pemain transfer-wallet khusus.

Transfer Wallet Flow

Alur Transfer Wallet

Transfer mode stores the authoritative balance locally. Create the player, deposit funds, launch the game, and use the ledger endpoints for audit or controlled corrections.

Mode transfer menyimpan saldo utama secara lokal. Buat pemain, deposit dana, launch game, lalu gunakan endpoint ledger untuk audit atau koreksi terkontrol.

Create the player with POST /api/v1/users.
Fund it with POST /api/v1/wallet/deposit.
Launch game 1508.
Use balance and transactions for reconciliation.
Rollback one completed debit or credit only when required.

Buat pemain dengan POST /api/v1/users.
Isi dana dengan POST /api/v1/wallet/deposit.
Launch game 1508.
Gunakan balance dan transactions untuk rekonsiliasi.
Rollback satu debit atau credit completed hanya bila diperlukan.

Balance

Returns the current authoritative local balance. This read does not create a ledger row.

Mengembalikan saldo lokal utama saat ini. Operasi baca ini tidak membuat row ledger.

GET/api/v1/wallet/balance

external_user_id string required
currency         string required

RequestRequest

GET /api/v1/wallet/balance?external_user_id=player-1001&currency=IDR

Success responseRespons sukses

{
  "status": true,
  "code": "SUCCESS",
  "data": {
    "balance_amount": 1000000,
    "currency": "IDR",
    "timestamp": "2026-06-15T12:00:00Z"
  }
}

Deposit

Credits a transfer player's local balance and creates one completed credit ledger row.

Menambah saldo lokal pemain transfer dan membuat satu row ledger credit berstatus completed.

POST/api/v1/wallet/deposit

operator_id      string  required
external_user_id string  required
reference_id     string  required, unique per operator
amount           integer required, 1..1000000000000
currency         string  required

Request bodyBody request

{
  "operator_id": "<operator_uuid>",
  "external_user_id": "player-1001",
  "reference_id": "deposit-20260615-0001",
  "amount": 500000,
  "currency": "IDR"
}

Response data fieldsField data respons

id, operator_id, user_id, external_user_id,
wallet_type, type, amount, currency,
balance_before, balance_after, reference_id,
status, failure_code, metadata,
created_at, completed_at

Withdraw

Debits the local balance for an operator-controlled transfer-out. Insufficient funds do not change the balance.

Mengurangi saldo lokal untuk transfer-out yang dikontrol operator. Saldo tidak cukup tidak mengubah balance.

POST/api/v1/wallet/withdraw

The body shape is identical to deposit. Use a new reference_id for every distinct transfer.

Bentuk body sama dengan deposit. Gunakan reference_id baru untuk setiap transfer yang berbeda.

Request bodyBody request

{
  "operator_id": "<operator_uuid>",
  "external_user_id": "player-1001",
  "reference_id": "withdraw-20260615-0001",
  "amount": 100000,
  "currency": "IDR"
}

Debit & Credit

These provider-neutral wallet operations are used for game financial movement. Debit removes funds; credit adds funds. The game engine uses the same wallet gateway internally.

Operasi wallet netral-provider ini digunakan untuk pergerakan finansial game. Debit mengurangi dana; credit menambah dana. Game engine memakai wallet gateway yang sama secara internal.

POST/api/v1/wallet/debit

POST/api/v1/wallet/credit

Unlike deposit and withdraw, these bodies do not contain operator_id.

Berbeda dari deposit dan withdraw, body ini tidak memiliki operator_id.

Debit or credit bodyBody debit atau credit

{
  "external_user_id": "player-1001",
  "reference_id": "round-5501-bet",
  "amount": 100,
  "currency": "IDR"
}

Response dataData respons

{
  "transaction_id": "659c881f-8afd-44f5-b35e-57f75dd07aa2",
  "balance_after": 999900,
  "currency": "IDR",
  "timestamp": "2026-06-15T12:00:00Z"
}

Rollback

Reverses one eligible completed debit or credit. The backend derives the original amount and currency; do not send them.

Membalik satu debit atau credit completed yang memenuhi syarat. Backend mengambil amount dan currency dari transaksi awal; jangan mengirimkannya.

POST/api/v1/wallet/rollback

Request bodyBody request

{
  "external_user_id": "player-1001",
  "original_reference_id": "round-5501-bet",
  "rollback_reference_id": "round-5501-bet-rollback"
}

Important codesKode penting

TRANSACTION_NOT_FOUND
TRANSACTION_NOT_ROLLBACKABLE
TRANSACTION_ALREADY_ROLLED_BACK
IDEMPOTENCY_CONFLICT

Transactions

Lists operator-owned ledger rows. Filters are optional. Default limit is 20; maximum limit is 100; maximum offset is 10000.

Menampilkan row ledger milik operator. Filter bersifat opsional. Limit default 20; limit maksimum 100; offset maksimum 10000.

GET/api/v1/wallet/transactions

external_user_id optional
type             optional: credit, debit, rollback
status           optional: pending, completed, failed,
                           reversed, mismatch
reference_id     optional
limit            optional: 1..100
offset           optional: 0..10000

RequestRequest

GET /api/v1/wallet/transactions?external_user_id=player-1001&status=completed&limit=20&offset=0

Response shapeBentuk respons

{
  "status": true,
  "code": "SUCCESS",
  "data": {
    "items": [],
    "limit": 20,
    "offset": 0
  }
}

Transfer Wallet Test Checklist

Checklist Pengujian Transfer Wallet

Create one active IDR player and verify duplicate creation.
Deposit, balance-check, withdraw, debit, credit, and rollback.
Repeat identical idempotent requests concurrently and verify one financial effect.
Reuse a key with a different amount and expect IDEMPOTENCY_CONFLICT.
Verify insufficient debit leaves balance unchanged.

Buat satu pemain IDR aktif dan uji pembuatan duplikat.
Uji deposit, balance, withdraw, debit, credit, dan rollback.
Ulangi request idempotent identik secara concurrent dan pastikan hanya ada satu efek finansial.
Pakai ulang key dengan amount berbeda dan harapkan IDEMPOTENCY_CONFLICT.
Pastikan debit dengan saldo tidak cukup tidak mengubah balance.

Seamless Wallet Flow

Alur Seamless Wallet

The operator remains the balance authority. Configure an HTTPS callback base URL and secret key. This backend appends the endpoint path and signs every raw JSON request.

Operator tetap menjadi pemilik saldo. Konfigurasikan base callback URL HTTPS dan secret key. Backend ini menambahkan path endpoint dan menandatangani setiap raw JSON request.

Every callback response must use HTTP 200 OK and the same success/error envelope documented above. A non-200 response is treated as unavailable for reads or an unknown outcome for mutations.

Setiap respons callback wajib memakai HTTP 200 OK dan envelope sukses/error yang sama seperti di atas. Respons non-200 dianggap unavailable untuk operasi baca atau unknown outcome untuk mutasi.

Implement all callback endpoints below.
Verify signature before parsing or processing the request.
Deduplicate debit, credit, and rollback by reference_id.
Return the exact original result for identical duplicates.
Support transaction status reconciliation for unknown outcomes.

Implementasikan semua endpoint callback di bawah.
Verifikasi signature sebelum parsing atau memproses request.
Deduplicate debit, credit, dan rollback berdasarkan reference_id.
Kembalikan hasil awal yang sama untuk duplikat identik.
Dukung rekonsiliasi transaction status untuk hasil yang belum diketahui.

Public API Triggers

Pemicu API Publik

The operator-facing balance, debit, credit, and rollback routes keep the same request contract as transfer mode. The authenticated operator's stored wallet type causes the gateway to call your callback service.

Route balance, debit, credit, dan rollback yang menghadap operator memakai kontrak request yang sama dengan mode transfer. Wallet type operator terautentikasi membuat gateway memanggil layanan callback Anda.

GET  /api/v1/wallet/balance
POST /api/v1/wallet/debit
POST /api/v1/wallet/credit
POST /api/v1/wallet/rollback

deposit and withdraw are transfer-only and return WALLET_TYPE_NOT_SUPPORTED for a seamless operator.

deposit dan withdraw hanya untuk transfer dan menghasilkan WALLET_TYPE_NOT_SUPPORTED pada operator seamless.

Callback Signing

Signature Callback

Every callback is an HTTPS POST with compact JSON. Sign the exact raw request body bytes; parsing and re-serializing JSON can change the signature input.

Setiap callback adalah POST HTTPS dengan JSON compact. Verifikasi menggunakan raw body persis; parsing lalu serialisasi ulang JSON dapat mengubah input signature.

operation = "POST\n" + path + "\n" + X-Timestamp
message   = operation + "\n" + raw_json_body
signature = hex(HMAC-SHA256(secret_key, message))

Compare signatures in constant time. Resolve the secret by X-Key-Version. Validate that X-Timestamp equals the body timestamp and reject stale or replayed requests.

Bandingkan signature secara constant-time. Ambil secret berdasarkan X-Key-Version. Pastikan X-Timestamp sama dengan timestamp body dan tolak request stale atau replay.

Callback headersHeader callback
Content-Type: application/json
X-Signature: <lowercase_hex_hmac_sha256>
X-Timestamp: 2026-06-15T12:00:00Z
X-Key-Version: <credential_version_uuid>
Common body fieldsField body umum
operator_code         string
external_user_id      string
currency              string
request_id            UUID correlation ID
timestamp             RFC3339
transaction_id        mutation callback only
reference_id          mutation/status callback
original_reference_id rollback callback
amount                integer mutation callback
metadata              optional JSON object

POST /balance

Return the current authoritative operator balance for the requested player and currency.

Kembalikan saldo utama operator saat ini untuk pemain dan currency yang diminta.

Request bodyBody request

{
  "operator_code": "YOUR_OPERATOR",
  "external_user_id": "player-1001",
  "currency": "IDR",
  "request_id": "97fdf0cb-c451-4bc2-8c9b-e923a3dfd45d",
  "timestamp": "2026-06-15T12:00:00Z"
}

Success responseRespons sukses

{
  "status": true,
  "code": "SUCCESS",
  "data": {
    "balance": 1000000,
    "currency": "IDR"
  }
}

POST /debit & POST /credit

Debit and credit have the same body shape. Apply the mutation atomically with its idempotency record. Return the exact request fields plus the resulting balance.

Debit dan credit memiliki bentuk body yang sama. Terapkan mutasi secara atomik bersama idempotency record. Kembalikan field request yang sama beserta saldo akhir.

For an identical duplicate, return the original successful response. For mismatched immutable fields, return IDEMPOTENCY_CONFLICT.

Untuk duplikat identik, kembalikan respons sukses awal. Untuk immutable field berbeda, kembalikan IDEMPOTENCY_CONFLICT.

Request bodyBody request

{
  "operator_code": "YOUR_OPERATOR",
  "external_user_id": "player-1001",
  "currency": "IDR",
  "request_id": "e0741886-797d-48bc-b1f4-953ca3627a40",
  "timestamp": "2026-06-15T12:00:00Z",
  "transaction_id": "c941df2c-df11-4918-8ce2-acac6160a3c1",
  "reference_id": "round-5501-bet",
  "amount": 100
}

Success responseRespons sukses

{
  "status": true,
  "code": "SUCCESS",
  "data": {
    "transaction_id": "c941df2c-df11-4918-8ce2-acac6160a3c1",
    "reference_id": "round-5501-bet",
    "amount": 100,
    "balance_after": 999900,
    "currency": "IDR"
  }
}

POST /rollback

Reverse the referenced completed mutation once. Validate the supplied original reference, amount, currency, and player against the stored original transaction.

Balikkan mutasi completed yang direferensikan satu kali. Validasi original reference, amount, currency, dan pemain terhadap transaksi awal yang tersimpan.

Request bodyBody request

{
  "operator_code": "YOUR_OPERATOR",
  "external_user_id": "player-1001",
  "currency": "IDR",
  "request_id": "6e25d5c2-fe52-46aa-941c-1120e8bcbd30",
  "timestamp": "2026-06-15T12:05:00Z",
  "transaction_id": "ab7f211a-36b9-42f6-986b-bb4d05025fc5",
  "reference_id": "round-5501-bet-rollback",
  "original_reference_id": "round-5501-bet",
  "amount": 100
}

Success responseRespons sukses

{
  "status": true,
  "code": "SUCCESS",
  "data": {
    "transaction_id": "ab7f211a-36b9-42f6-986b-bb4d05025fc5",
    "reference_id": "round-5501-bet-rollback",
    "original_reference_id": "round-5501-bet",
    "amount": 100,
    "balance_after": 1000000,
    "currency": "IDR"
  }
}

POST /transaction-status

Used to reconcile a seamless mutation after an unknown outcome. Return completed, failed, or not_found.

Digunakan untuk rekonsiliasi mutasi seamless setelah hasil tidak diketahui. Kembalikan completed, failed, atau not_found.

When available, return the original amount, currency, reference, and transaction type so the backend can detect mismatches.

Jika tersedia, kembalikan amount, currency, reference, dan transaction type awal agar backend dapat mendeteksi mismatch.

Request bodyBody request

{
  "operator_code": "YOUR_OPERATOR",
  "external_user_id": "player-1001",
  "currency": "IDR",
  "request_id": "a09ef2c7-dfb8-46df-a9fd-d310205d4262",
  "timestamp": "2026-06-15T12:06:00Z",
  "reference_id": "round-5501-bet"
}

Success responseRespons sukses

{
  "status": true,
  "code": "SUCCESS",
  "data": {
    "transaction_status": "completed",
    "operator_transaction_id": "operator-tx-99881",
    "transaction_type": "debit",
    "reference_id": "round-5501-bet",
    "amount": 100,
    "currency": "IDR"
  }
}

Seamless Wallet Test Checklist

Checklist Pengujian Seamless Wallet

Reject missing, malformed, stale, replayed, or wrong-version signatures.
Verify raw-body signing with non-ASCII and optional metadata.
Run concurrent duplicate debit, credit, and rollback calls.
Simulate timeout after committing a mutation, then reconcile it as completed.
Return mismatched amount or currency and verify it becomes an unknown outcome.
Ensure logs never contain secrets, signatures, or full sensitive payloads.

Tolak signature yang hilang, malformed, stale, replay, atau salah versi.
Uji raw-body signing dengan non-ASCII dan metadata opsional.
Jalankan debit, credit, dan rollback duplikat secara concurrent.
Simulasikan timeout setelah mutasi committed, lalu rekonsiliasi sebagai completed.
Kembalikan amount atau currency berbeda dan pastikan menjadi unknown outcome.
Pastikan log tidak menyimpan secret, signature, atau payload sensitif lengkap.

Error Codes

Kode Error

Handle errors by stable code. Do not depend on a human-readable message because public API errors intentionally do not include one.

Tangani error berdasarkan code yang stabil. Jangan bergantung pada pesan untuk manusia karena error API publik memang tidak menyertakannya.

VALIDATION_ERRORMalformed JSON, unknown field, or missing required value.JSON malformed, field tidak dikenal, atau nilai wajib kosong.
UNAUTHORIZEDMissing, invalid, revoked, or expired operator credential.Credential operator hilang, salah, revoked, atau expired.
FORBIDDENAuthenticated operator is not permitted to access the resource.Operator terautentikasi tidak diizinkan mengakses resource.
NOT_FOUNDRoute, game, or generic resource was not found.Route, game, atau resource umum tidak ditemukan.
RATE_LIMITEDRequest rate exceeded the configured limit.Laju request melewati limit.
USER_NOT_FOUNDPlayer does not exist for this operator.Pemain tidak ada untuk operator ini.
USER_ALREADY_EXISTSThe operator already owns this external user identity.Operator sudah memiliki external user identity ini.
USER_INACTIVEPlayer status does not allow wallet operations.Status pemain tidak mengizinkan operasi wallet.
OPERATOR_MISMATCHRequest identity is owned by another operator.Identitas request dimiliki operator lain.
INVALID_CURRENCYCurrency is not exactly three uppercase ASCII letters.Currency bukan tepat tiga huruf ASCII kapital.
CURRENCY_MISMATCHCurrency differs from player or wallet currency.Currency berbeda dari currency pemain atau wallet.
INVALID_AMOUNTAmount is zero or negative.Amount nol atau negatif.
AMOUNT_LIMIT_EXCEEDEDAmount exceeds 1000000000000 minor units.Amount melewati 1000000000000 minor unit.
INSUFFICIENT_BALANCEBalance cannot cover the requested debit.Saldo tidak cukup untuk debit.
BALANCE_OVERFLOWCredit would overflow the integer balance.Credit akan membuat saldo integer overflow.
IDEMPOTENCY_CONFLICTA key was reused with different immutable fields.Key dipakai ulang dengan immutable field berbeda.
WALLET_TYPE_NOT_SUPPORTEDOperation is not supported by this operator wallet mode.Operasi tidak didukung mode wallet operator ini.
TRANSACTION_NOT_FOUNDReferenced ledger transaction does not exist.Transaksi ledger yang direferensikan tidak ada.
TRANSACTION_NOT_ROLLBACKABLEThe referenced transaction cannot be reversed.Transaksi yang direferensikan tidak dapat dibalik.
TRANSACTION_ALREADY_ROLLED_BACKThe original transaction was already reversed.Transaksi awal sudah pernah dibalik.
TRANSACTION_STATUS_UNKNOWNSeamless mutation outcome requires reconciliation.Hasil mutasi seamless memerlukan rekonsiliasi.
PROVIDER_UNAVAILABLESeamless callback service is unavailable.Layanan callback seamless tidak tersedia.
UPSTREAM_TIMEOUTSeamless balance or status check timed out.Pemeriksaan balance atau status seamless timeout.
INTERNAL_ERRORUnexpected internal failure; use the request ID when reporting it.Kegagalan internal tak terduga; sertakan request ID saat melaporkan.