Utility & Reference Data

Modul ini berisi endpoint utilitas dan data referensi umum yang dipakai oleh fitur lain.

Daftar route

Method	Path	Controller@method	Middleware
GET	/api/wallet-status	GeneralController@walletConfigurationStatus	publik
GET	/api/dicts	DictController@getDictList	auth.xtoken, verified:api
POST	/api/collect	CollectController@collect	auth.xtoken, verified:api
GET	/api/deposit/get-digit-transfer	DepositController@getDigitTransfer	auth.xtoken, verified:api

---

Wallet status

Route

• GET /api/wallet-status
• Controller: GeneralController@walletConfigurationStatus

Behavior

• Membaca WalletConfiguration berdasarkan type:
  • WD -> withdrawal_status
  • DEPO -> deposit_status
• Nilai status dipetakan ke string:
  • 1 -> active
  • selain itu -> inactive

Response

• sukses: api.wallet_status_success
• data:

{
  "withdrawal_status": "active",
  "deposit_status": "active"
}

• gagal: api.wallet_status_failed

---

Dictionary list

Route

• GET /api/dicts
• Controller: DictController@getDictList
• Request validation: GetDictListRequest

Query parameter

Field	Type	Required
type	string	Ya

Behavior

• Validasi type wajib ada.
• Jika tidak ada data dict dengan type tersebut -> error "Dict list not found".
• Jika ada, data diurutkan (is_chinese, sortBy/sort) dan diformat via Dict::format_data.

Response

• sukses: sendResponse(formattedData, null)
• gagal: sendError("Dict list not found")

---

Collect (watchlist pair)

Route

• POST /api/collect
• Controller: CollectController@collect

Payload

{
  "txPair": "BTCUSDT"
}

Behavior

• Cari pasangan pair di TxPair berdasarkan txPair.
• Jika pair tidak ada -> error "txPair not exist!".
• Jika pair ada:
  • belum di-collect -> create record Collect, response "collect ok!"
  • sudah di-collect -> delete record (toggle off), response "cancel ok!"

Response

• sukses create: sendResponse("collect ok!", [])
• sukses cancel: sendResponse("cancel ok!", [])
• gagal: sendError("txPair not exist!")

---

Manual deposit digit helper

Route

• GET /api/deposit/get-digit-transfer
• Controller: DepositController@getDigitTransfer

Behavior

• Hitung jumlah deposit manual (cash_deposit) pada hari ini.
• Batas digit menggunakan env DEPOSIT_MANUAL_MAX_DIGIT.
• Jika count melebihi batas, nilai digit diputar sesuai kalkulasi modulo internal controller.

Response

• sukses: api.manual_deposit_digits_success
• data:

{
  "digit": 7
}

• gagal: api.manual_deposit_digits_failed