API Documentation

Instalasi CHOJI ke VPS

Prompt siap pakai buat AI coding assistant supaya bantu pasang CHOJI dari nol

Bagian ini khusus buat kamu yang mau memasang source code CHOJI di server (VPS) kamu sendiri — beda dengan bagian "Integrasi via AI Assistant" di bawah yang buat nyambungin API CHOJI ke aplikasi lain. Tinggal salin prompt di bawah, paste ke AI coding assistant kamu (Claude Code, ChatGPT, Cursor, dll) sambil pastikan kamu sudah SSH ke VPS tujuan, terus ikuti arahannya.

Sebelum mulai: siapin domain yang sudah diarahkan (DNS A record) ke IP VPS kamu, dan pastikan port 80/443 terbuka di firewall. Jangan pernah kasih isi file .env asli ke AI/chat publik — biarin AI cuma bantu generate strukturnya, isi credential-nya kamu masukin manual.

Kebutuhan Server (Minimum)

1 vCPU / 1-2 GB RAM

VPS Ubuntu 22.04 LTS ke atas sudah cukup untuk trafik menengah.

PostgreSQL 14+

Tabel dibuat otomatis (CREATE TABLE IF NOT EXISTS) saat app pertama kali jalan — kamu cuma perlu bikin database kosongnya.

Node.js 20 LTS + Nginx

Node buat runtime aplikasi, Nginx sebagai reverse proxy + SSL (Let's Encrypt/Certbot).

Kamu adalah DevOps assistant. Bantu aku pasang aplikasi CHOJI (Payment Gateway berbasis NestJS + bot WhatsApp) di VPS Ubuntu yang sudah aku SSH masuk sekarang.

Stack aplikasi:
- Backend: NestJS (TypeScript), di-compile ke ./dist lalu dijalankan pakai Node.js
- Database: PostgreSQL (tabel dibuat otomatis oleh aplikasi saat pertama kali start, aku cuma perlu bikin database kosong)
- Storage tambahan: file JSON di folder ./database (dibuat otomatis oleh aplikasi)
- Bot WhatsApp: pakai library Baileys, dijalankan terpisah lewat file start-bot.js
- Process manager: PM2
- Reverse proxy: Nginx + SSL dari Let's Encrypt (Certbot)
- Konfigurasi: SEPENUHNYA dari file .env di root project (tidak ada file settings.js/config hardcode)

Tolong bantu aku, langkah demi langkah, dengan urutan:

1. Install dependency sistem: Node.js 20 LTS, PostgreSQL, Nginx, PM2 (global), Certbot, git.
2. Buat user & database PostgreSQL baru khusus buat aplikasi ini (jangan pakai user postgres default), catat username/password/nama database yang dipakai.
3. Bantu aku upload/clone source code project ke folder /var/www/choji (aku akan kirim/upload source code-nya sendiri secara terpisah, kamu fokus ke langkah server-nya).
4. Jalankan "npm install" di root project.
5. Buatkan aku file .env dari .env.example yang ada di project, dengan daftar SEMUA variabel yang perlu diisi (jangan isi otomatis dengan nilai palsu untuk secret — tanya aku satu-satu untuk value yang sensitif seperti SESSION_SECRET, POSTGRES_PASSWORD, dst, dan generate value acak yang aman untuk SESSION_SECRET pakai perintah seperti "openssl rand -hex 32").
6. Jalankan "npm run build" untuk compile TypeScript ke ./dist.
7. Setup PM2: jalankan aplikasi utama via "pm2 start dist/main.js --name CHOJI-APP", dan bot WhatsApp via "pm2 start start-bot.js --name CHOJI-WA-BOT", lalu "pm2 save" dan "pm2 startup" supaya auto-start kalau VPS reboot.
8. Setup Nginx sebagai reverse proxy dari domain aku (ganti [DOMAIN_AKU_DISINI] dengan domain asli) ke port aplikasi (default 2006, sesuai PORT di .env), termasuk header buat WebSocket kalau diperlukan.
9. Pasang SSL gratis pakai Certbot untuk domain tersebut, dan pastikan auto-renewal SSL aktif.
10. Setup firewall (ufw): buka port 22 (SSH), 80, 443 saja, tutup akses langsung ke port aplikasi dari luar (harus lewat Nginx).
11. Terakhir, kasih aku ringkasan cara cek aplikasi jalan dengan benar (pm2 status, pm2 logs, curl ke domain).

Kerjakan satu langkah dulu, tunggu konfirmasi dariku sebelum lanjut ke langkah berikutnya. Kalau ada perintah yang butuh input sensitif (password database, secret, dll), tanya aku dulu — jangan diisi sendiri dengan nilai contoh.

Setelah server jalan, jangan lupa: (1) rotate semua credential yang pernah ada di source code sebelumnya, (2) isi JS_WHITELIST_IPS di .env dengan IP VPS kamu yang baru, (3) test alur topup & withdraw dengan nominal kecil dulu sebelum dipakai publik.

Introduction

Gambaran umum dan cara kerja API

API CHOJI memungkinkan Anda mengintegrasikan layanan pembayaran QRIS, transfer saldo, dan manajemen akun. Semua permintaan menggunakan format JSON dan mengembalikan respons JSON. Endpoint API yang memerlukan autentikasi wajib menyertakan apikey yang valid.

Design Principles

GET untuk Data & Inisiasi

Endpoint read-only dan pembuatan resource seperti topup QRIS menggunakan GET dengan query parameter.

POST untuk State Change

Endpoint yang mengubah state server secara permanen (transfer, cancel) wajib menggunakan POST dengan request body.

HTTPS Wajib

Seluruh komunikasi wajib melalui HTTPS. Request HTTP biasa akan ditolak otomatis.

Base URL: Semua endpoint menggunakan base URL https://choji.web.id/api/v1. Contoh: GET https://choji.web.id/api/v1/topup?apikey=...&nominal=10000

Integrasi via AI Assistant

Prompt siap pakai buat AI coding assistant (Claude, ChatGPT, Copilot, dll)

Mau integrasiin API CHOJI ke project kamu tapi males baca dokumentasi satu-satu? Tinggal copy prompt di bawah, paste ke AI assistant kamu (Claude Code, ChatGPT, Cursor, dll), ganti bagian API Key & kebutuhan kamu, terus biarin AI-nya yang bikinin kodenya.

Jangan pernah taruh API Key asli di chat AI publik / model pihak ketiga yang nggak kamu percaya. Kalau perlu, pakai API Key dummy dulu buat contoh, baru ganti manual pas udah jadi kode aslinya.

Kamu adalah asisten developer. Aku mau integrasiin Payment Gateway CHOJI ke project aku.

Base URL API: https://choji.web.id/api/v1
Autentikasi: pakai header "x-api-key: API_KEY_AKU" ATAU query param "?apikey=API_KEY_AKU"
Semua response dalam format JSON.

Endpoint utama yang tersedia:
- GET  /topup          -> Buat transaksi QRIS baru (param: apikey, nominal)
- POST /topup/cancel    -> Batalkan transaksi topup yang masih pending
- GET  /check-status    -> Cek status transaksi berdasarkan trxId
- GET  /check-saldo     -> Cek saldo akun berdasarkan apikey
- GET  /history         -> Riwayat transaksi akun
- GET  /check-user      -> Cek info akun user
- POST /transfer        -> Transfer saldo ke akun lain
- POST /withdraw        -> Withdraw instant ke e-wallet
- GET  /inquiry         -> Cek validitas nomor e-wallet tujuan

Webhook: aku juga punya endpoint callback yang bakal nerima notifikasi pembayaran dari CHOJI via POST, dengan signature HMAC-SHA256 di header "x-signature" yang perlu diverifikasi pakai webhook secret aku.

Tolong bantu aku bikin:
1. Modul/service buat wrapping semua endpoint di atas (bahasa/framework: [ISI BAHASA & FRAMEWORK KAMU DI SINI, misal Node.js Express / PHP Laravel / Python Flask])
2. Endpoint webhook receiver yang verifikasi signature dan update status transaksi di database aku
3. Contoh penggunaan buat bikin transaksi QRIS baru dan polling status sampai selesai

Dokumentasi lengkap tiap endpoint ada di: https://choji.web.id/docs
API Key aku (contoh, ganti dengan punya asli pas implementasi): AO_xxxxx221220241234abcdefghij

Authentication

Cara mendapatkan dan menggunakan API Key

Hampir semua endpoint memerlukan API Key. Pengecualian hanya pada POST /check-user. API Key dapat dikirim melalui query parameter pada GET request, request body pada POST request, atau header x-api-key untuk integrasi backend.

Mendapatkan API Key

1. Login Dashboard

Masuk ke dashboard CHOJI PPOB menggunakan akun Anda.

2. Buka Profil

Navigasi ke halaman Profil melalui menu akun di dashboard.

3. Generate Key

Klik tombol "Daftar Apikey Sekarang!" dan salin hasilnya.

Penting: API Key hanya dapat di-generate sekali. Jangan pernah menyimpan API Key di sisi client (frontend publik). Jika hilang atau bocor, segera hubungi admin untuk reset.

Metode 1 — Query Parameter (GET)

Query Parameter

GET /api/v1/check-saldo?apikey=AO_xxxxx221220241234abcdefghij

Metode 2 — Request Body (POST)

JSON Body

{
  "apikey":  "AO_xxxxx221220241234abcdefghij",
  "email":   "johndoe@email.com",
  "nominal": 50000
}

Metode 3 — Header (x-api-key)

HTTP Header

x-api-key: AO_xxxxx221220241234abcdefghij
atau
Authorization: Bearer AO_xxxxx221220241234abcdefghij

Semua metode diterima. Sistem akan otomatis mendeteksi API Key dari query param, body, header x-api-key, maupun Authorization: Bearer. Jika sebelumnya mendapat error 401 — pastikan API Key sudah benar dan akun tidak diblokir.

Security & Rate Limiting

Standar keamanan dan pembatasan request

Prinsip Keamanan PCI DSS

Multi-Method Auth

API Key diterima via query param, body, header x-api-key, maupun Authorization Bearer untuk fleksibilitas integrasi.

TLS Enforcement

Seluruh traffic dienkripsi menggunakan TLS 1.2+. Plain HTTP diblokir penuh.

Session & Expiry

QRIS yang dibuat memiliki masa berlaku 10 menit. Transaksi EXPIRED tidak bisa diproses.

Account Lockout

Akun yang melanggar kebijakan akan diblokir. API Key dari akun banned mengembalikan 403.

User-Agent Filtering

Request dari non-browser ditolak dengan 403 untuk mencegah penyalahgunaan otomatis.

Atomic Transactions

Operasi finansial menggunakan database transaction untuk menjamin konsistensi data.

Rate Limiting

Parameter	Nilai Default	Keterangan
limit_per_minute	60 request	Maksimum request per menit untuk setiap API Key. Jika terlampaui, server akan merespon `429 Too Many Requests`.
limit_per_day	10.000 request	Batas harian (reset setiap tengah malam). Anda dapat melihat sisa kuota di dashboard.
alert_threshold	80%	Notifikasi akan dikirim (jika diaktifkan) ketika kuota harian mencapai persentase ini.

Anda dapat menyesuaikan batas limit_per_minute, limit_per_day, dan alert_threshold melalui halaman Dashboard → Profil → API Quota. Setiap perubahan akan langsung berlaku.

Perhatian: Melebihi rate limit akan mengembalikan status 429 Too Many Requests. Implementasikan exponential backoff pada klien Anda sebelum melakukan retry.

Buat Topup

Generate QRIS untuk topup saldo via API

Aku mau integrasiin endpoint "Buat Topup QRIS" dari Payment Gateway CHOJI ke project aku.

Endpoint: GET https://choji.web.id/api/v1/topup
Autentikasi: header "x-api-key: API_KEY_AKU" atau query param "?apikey=API_KEY_AKU"
Parameter: nominal (jumlah topup dalam Rupiah, contoh: 10000)
Response sukses: JSON berisi trxId, qrisString (data QR), dan expiredAt (waktu kadaluarsa QR)

Setelah dapat qrisString, aku perlu generate gambar QR-nya dan tampilkan ke user, lalu polling ke endpoint "GET /api/v1/check-status?trxId=..." tiap beberapa detik sampai status berubah jadi SUCCESS atau EXPIRED.

Tolong bantu aku bikin function/service buat:
1. Request pembuatan QRIS baru pakai endpoint di atas (bahasa/framework: [ISI BAHASA & FRAMEWORK KAMU])
2. Generate & tampilkan gambar QR dari qrisString (boleh pakai library QR code generator apapun)
3. Polling status transaksi sampai selesai, dengan timeout kalau QR sudah expired

Dokumentasi lengkap: https://choji.web.id/docs

POST /api/v1/topup Auth Required

Membuat permintaan TopUp saldo baru dan menghasilkan QRIS untuk pembayaran. Parameter dikirim melalui request body (JSON) — metode POST digunakan untuk mencegah spam dan menjaga keamanan parameter. Setelah QRIS dibuat, gunakan GET /check-status untuk memantau statusnya secara real-time.

Request Body

Parameter	Type	Status	Deskripsi
apikey	String	Wajib	API Key Anda
nominal	Number	Wajib	Nominal topup dalam Rupiah. Minimal Rp 1.000

Contoh Request

JSON Body

POST /api/v1/topup
Content-Type: application/json

{
  "apikey":  "AO_xxxxx221220241234abcdefghij",
  "nominal": 10000
}

Response (Success)

200 OK

{
  "status":  200,
  "message": "Topup Created",
  "data": {
    "trxId":         "TOPUP-1743000000000",
    "user_email":   "user@email.com",
    "type":          "TOPUP",
    "item":          "Top Up Saldo API",
    "amount":        10000,
    "fee":           3,
    "totalTransfer": 10003,
    "expiry":        1735723200000,
    "qr_string":     "000201010211..."
  }
}

Status transaksi selalu PENDING saat pertama dibuat. Gunakan GET /check-status?idTransaksi=trxId untuk memantau perkembangan secara real-time. totalTransfer adalah jumlah yang harus dibayar via QRIS (nominal + fee).

Total Bayar adalah totalTransfer. Pembayaran kurang dari jumlah ini tidak akan terdeteksi. QRIS kadaluarsa setelah 10 menit.

Cancel Topup

Membatalkan transaksi topup yang masih PENDING

Aku mau integrasiin endpoint "Cancel Topup" dari Payment Gateway CHOJI ke project aku.

Endpoint: POST https://choji.web.id/api/v1/topup/cancel
Autentikasi: header "x-api-key: API_KEY_AKU" atau query param "?apikey=API_KEY_AKU"
Body (JSON): { "trxId": "TOPUP-1743000000000" }

Endpoint ini dipakai buat membatalkan transaksi topup QRIS yang statusnya masih PENDING (belum dibayar user), misalnya kalau user klik "Batalkan" di halaman checkout mereka.

Tolong bantu aku bikin function/service buat manggil endpoint ini (bahasa/framework: [ISI BAHASA & FRAMEWORK KAMU]), lengkap dengan error handling kalau trxId tidak ditemukan atau transaksinya udah bukan PENDING lagi.

Dokumentasi lengkap: https://choji.web.id/docs

POST /api/v1/topup/cancel Auth Required

Membatalkan transaksi topup milik Anda yang berstatus PENDING. Hanya transaksi yang belum dibayar dan belum kadaluarsa yang bisa dibatalkan. Status akan berubah menjadi CANCELED.

Request Body

JSON

{
  "apikey": "AO_xxxxx221220241234abcdefghij",
  "trxId":  "674a3b8c9d0e1f2a"
}

Parameters

Parameter	Type	Status	Deskripsi
apikey	String	Wajib	API Key Anda
trxId	String	Wajib	Nilai `trxId` yang didapat dari response `POST /topup`. Contoh: `TOPUP-1743000000000`

Response

200 OK

{
  "status":  200,
  "message": "Transaksi berhasil dibatalkan"
}

Endpoint ini hanya bisa membatalkan transaksi milik akun Anda sendiri (berdasarkan API Key). Mencoba membatalkan transaksi akun lain akan mengembalikan error 400.

Check Status

Mengecek status pembayaran berdasarkan ID transaksi

Aku mau integrasiin endpoint "Check Status" dari Payment Gateway CHOJI ke project aku.

Endpoint: GET https://choji.web.id/api/v1/check-status
Autentikasi: header "x-api-key: API_KEY_AKU" atau query param "?apikey=API_KEY_AKU"
Parameter: idTransaksi (ID transaksi yang mau dicek statusnya)
Response: status transaksi (PENDING / SUCCESS / EXPIRED / CANCELED)

Endpoint ini dipakai buat polling status pembayaran QRIS/topup secara berkala sampai statusnya berubah dari PENDING.

Tolong bantu aku bikin function/service buat polling endpoint ini (bahasa/framework: [ISI BAHASA & FRAMEWORK KAMU]), dengan interval polling wajar (misal tiap 3-5 detik) dan berhenti otomatis kalau status sudah SUCCESS, EXPIRED, atau CANCELED.

Dokumentasi lengkap: https://choji.web.id/docs

GET /api/v1/check-status?apikey=&idTransaksi= Auth Required

Mengecek status pembayaran TopUp secara real-time dengan menghubungi gateway QRIS secara langsung. Lakukan polling dengan interval minimal 3 detik untuk menghindari rate limit.

Query Parameters

Parameter	Type	Status	Deskripsi
apikey	String	Wajib	API Key Anda
idTransaksi	String	Wajib	Nilai `trxId` yang didapat dari response `POST /topup`. Contoh: `TOPUP-1743000000000`

Contoh Request

URL

GET /api/v1/check-status?apikey=AO_xxxxx...&idTransaksi=TOPUP-1743000000000

Response

200 OK

{
  "status": 200,
  "data": {
    "trxId":         "TOPUP-1743000000000",
    "status":        "SUCCESS",
    "amount":        10000,
    "totalTransfer": 10003,
    "type":          "TOPUP",
    "item":          "Top Up Saldo API",
    "expiry":        1743003600000
  }
}

Nilai Status

SUCCESS PENDING EXPIRED CANCELED

Check Saldo

Mengecek saldo terkini akun Anda

Aku mau integrasiin endpoint "Check Saldo" dari Payment Gateway CHOJI ke project aku.

Endpoint: GET https://choji.web.id/api/v1/check-saldo
Autentikasi: header "x-api-key: API_KEY_AKU" atau query param "?apikey=API_KEY_AKU"
Response: saldo terkini akun

Tolong bantu aku bikin function/service buat manggil endpoint ini (bahasa/framework: [ISI BAHASA & FRAMEWORK KAMU]) buat nampilin saldo di dashboard aku, termasuk error handling kalau API key invalid.

Dokumentasi lengkap: https://choji.web.id/docs

GET /api/v1/check-saldo?apikey= Auth Required

Mengambil saldo terkini berdasarkan API Key. Endpoint ini adalah read-only murni, sehingga menggunakan GET. Disarankan untuk melakukan cache lokal selama 30 detik untuk efisiensi.

Query Parameters

Parameter	Type	Status	Deskripsi
apikey	String	Wajib	API Key Anda

Contoh Request

URL

GET /api/v1/check-saldo?apikey=AO_xxxxx221220241234abcdefghij

Response

200 OK

{
  "status": 200,
  "data": {
    "saldo": 150000
  }
}

History Transaksi

Mengambil riwayat transaksi dengan filter dan pagination

Aku mau integrasiin endpoint "History Transaksi" dari Payment Gateway CHOJI ke project aku.

Endpoint: GET https://choji.web.id/api/v1/history
Autentikasi: header "x-api-key: API_KEY_AKU" atau query param "?apikey=API_KEY_AKU"
Parameter opsional: page (nomor halaman), limit (jumlah data per halaman), filter (all/success/pending/canceled)

Tolong bantu aku bikin function/service buat ambil riwayat transaksi dengan pagination ini (bahasa/framework: [ISI BAHASA & FRAMEWORK KAMU]), termasuk contoh tampilan tabel/list riwayat transaksi dengan filter status.

Dokumentasi lengkap: https://choji.web.id/docs

GET /api/v1/history?apikey=&page=&filter=&limit= Auth Required

Mengambil riwayat seluruh transaksi akun Anda. Mendukung pagination dan filter berdasarkan status. Transaksi PENDING yang telah melewati waktu expiry akan otomatis diperbarui menjadi EXPIRED.

Query Parameters

Parameter	Type	Status	Deskripsi
apikey	String	Wajib	API Key Anda
page	Number	Opsional	Halaman ke-N. Default: 1
limit	Number	Opsional	Jumlah data per halaman. Default: 10, Maks: 50
filter	String	Opsional	Filter: all \| success \| pending \| canceled. Default: all

Contoh Request

URL

GET /api/v1/history?apikey=AO_xxxxx...&page=1&limit=10&filter=success

Response

200 OK

{
  "status":  200,
  "hasMore": false,
  "data": [
    {
      "trxId":         "674a3b8c9d0e1f2a",
      "type":          "TOPUP",
      "item":          "Top Up Saldo API",
      "amount":        10000,
      "totalTransfer": 10003,
      "date":          "2024-01-01T12:00:00Z",
      "status":        "SUCCESS"
    },
    {
      "trxId":         "TF-API-1735723200000",
      "type":          "TF_OUT",
      "item":          "Transfer API ke John Doe",
      "amount":        50000,
      "totalTransfer": 50000,
      "date":          "2024-01-01T11:30:00Z",
      "status":        "SUCCESS",
      "note":          "Penerima: johndoe@email.com"
    }
  ]
}

Nilai Type

TOPUP TF_IN TF_OUT BUY WD ADJUST_IN ADJUST_OUT

Check User

Validasi keberadaan akun sebelum transfer

Aku mau integrasiin endpoint "Check User" dari Payment Gateway CHOJI ke project aku.

Endpoint: POST https://choji.web.id/api/v1/check-user
Body (JSON): { "email": "penerima@email.com" }
Response: info dasar akun kalau email terdaftar (dipakai buat validasi sebelum transfer saldo)

Tolong bantu aku bikin function buat validasi email penerima ini (bahasa/framework: [ISI BAHASA & FRAMEWORK KAMU]) sebelum lanjut ke proses Transfer Saldo, dengan pesan error yang jelas kalau emailnya tidak terdaftar.

Dokumentasi lengkap: https://choji.web.id/docs

POST /api/v1/check-user No Auth

Memeriksa apakah email terdaftar di sistem CHOJI dan mengembalikan informasi dasar pengguna. Endpoint ini tidak memerlukan API Key. Email dikirim di body (POST) untuk menjaga privasi pengguna agar tidak terekam di server log URL.

Request Body

JSON

{
  "email": "johndoe@email.com"
}

Parameters

Parameter	Type	Status	Deskripsi
email	String	Wajib	Alamat email user yang akan dicek

Response

200 OK

{
  "status": 200,
  "data": {
    "username":    "John Doe",
    "email":       "johndoe@email.com",
    "verified":    false,
    "profile_pic": "https://ui-avatars.com/api/?name=John+Doe&..."
  }
}

Field verified bernilai true jika user sudah memiliki API Key. Gunakan endpoint ini untuk validasi penerima sebelum melakukan POST /transfer.

Transfer Saldo

Kirim saldo ke sesama pengguna CHOJI

Aku mau integrasiin endpoint "Transfer Saldo" dari Payment Gateway CHOJI ke project aku.

Endpoint: POST https://choji.web.id/api/v1/transfer
Autentikasi: header "x-api-key: API_KEY_AKU" atau query param "?apikey=API_KEY_AKU"
Body (JSON): { "email": "penerima@email.com", "nominal": 50000 }

Endpoint ini transfer saldo antar akun CHOJI secara langsung (bukan QRIS). Sebaiknya validasi dulu email penerima pakai endpoint "Check User" sebelum manggil endpoint ini.

Tolong bantu aku bikin function/service buat transfer saldo ini (bahasa/framework: [ISI BAHASA & FRAMEWORK KAMU]), lengkap dengan validasi nominal minimum dan error handling kalau saldo tidak cukup.

Dokumentasi lengkap: https://choji.web.id/docs

POST /api/v1/transfer Auth Required

Mentransfer saldo dari akun Anda ke akun penerima berdasarkan email. Transfer menggunakan database transaction (BEGIN/COMMIT) untuk menjamin atomisitas — saldo pengirim tidak akan berkurang jika saldo penerima gagal bertambah. Transfer tidak dapat dibatalkan setelah berhasil.

Request Body

JSON

{
  "apikey":  "AO_xxxxx221220241234abcdefghij",
  "email":   "johndoe@email.com",
  "nominal": 50000
}

Parameters

Parameter	Type	Status	Deskripsi
apikey	String	Wajib	API Key Anda (pengirim)
email	String	Wajib	Email penerima transfer
nominal	Number	Wajib	Jumlah saldo yang ditransfer. Harus bilangan bulat positif

Response

200 OK

{
  "status":  200,
  "message": "Transfer Berhasil"
}

Transfer tidak dapat dibatalkan setelah berhasil. Selalu gunakan POST /check-user terlebih dahulu untuk memverifikasi email penerima sebelum melakukan transfer.

Withdraw Instant (E-Wallet)

Tarik saldo ke E-Wallet secara otomatis dan realtime

Aku mau integrasiin endpoint "Withdraw Instant" dari Payment Gateway CHOJI ke project aku.

Endpoint: GET https://choji.web.id/withdraw2
Autentikasi: header "x-api-key: API_KEY_AKU" atau query param "?apikey=API_KEY_AKU"
Parameter: ewallet (dana/gopay/ovo/shopee/linkaja), nomor (nomor HP tujuan), kode (kode produk, cek daftar produk dulu pakai endpoint Cek E-Wallet Inquiry)

Endpoint ini narik saldo dari akun CHOJI langsung ke e-wallet tujuan secara otomatis & realtime.

Tolong bantu aku bikin function/service buat proses withdraw instant ini (bahasa/framework: [ISI BAHASA & FRAMEWORK KAMU]), termasuk validasi nomor tujuan pakai endpoint Cek E-Wallet Inquiry dulu sebelum eksekusi withdraw.

Dokumentasi lengkap: https://choji.web.id/docs

GET /withdraw2?apikey=&ewallet=&nomor=&kode= Auth Required

Endpoint ini memungkinkan Anda melakukan penarikan saldo (Withdraw) ke berbagai E-Wallet secara instan melalui sistem otomatis. Saldo akun akan dipotong sesuai harga produk yang dipilih. Response dapat berupa status SUCCESS (langsung atau akan diproses) atau PENDING (memerlukan pengecekan ulang).

Query Parameters

Parameter	Type	Status	Deskripsi
apikey	String	Wajib	API Key Anda
ewallet	String	Wajib	Jenis E-Wallet: dana, gopay, ovo, shopee, linkaja, dll
nomor	String	Wajib	Nomor HP tujuan E-Wallet (contoh: 08123456789)
kode	String	Wajib	Kode produk (contoh: d1 untuk Dana 1rb). Masukkan kode asal untuk melihat daftar produk

Contoh Request

URL

GET /withdraw2?apikey=YOUR_APIKEY&ewallet=dana&nomor=08123456789&kode=d1

Response (Contoh Sukses Langsung)

200 OK

{
  "status":  200,
  "message": "Transaksi withdraw2 langsung sukses.",
  "trxId":   "WD2-171123456789",
  "detail": {
    "ewallet":      "dana",
    "nomor":        "08123456789",
    "namaEwallet":  "Budi Santoso",
    "product":      "Dana 1.000",
    "harga":        1038,
    "status":        "SUCCESS"
  }
}

Response (Akan Diproses / PENDING)

200 OK

{
  "status":  200,
  "message": "Transaksi withdraw2 sedang diproses.",
  "trxId":   "WD2-171123456789",
  "detail": {
    "ewallet":      "dana",
    "nomor":        "08123456789",
    "namaEwallet":  "Budi Santoso",
    "product":      "Dana 1.000",
    "harga":        1038,
    "status":        "PENDING"
  }
}

Jika Anda memasukkan kode yang salah, API akan mengembalikan daftar kode produk yang tersedia beserta harganya dalam field available_products.

Request Log

Lihat riwayat semua request yang menggunakan API Key Anda

GET /api/profile/api-requests Session Required

Mengembalikan daftar seluruh request yang pernah dilakukan menggunakan API Key milik akun Anda. Setiap kali endpoint API dipanggil dengan API Key yang valid, sistem secara otomatis mencatat endpoint, metode, IP, dan waktu ke file database/mutasi-api.json. Akses endpoint ini memerlukan sesi login aktif (bukan API Key), sehingga hanya bisa diakses melalui dashboard. Tombol » di halaman Profil akan membuka daftar ini secara langsung.

Query Parameters

Parameter	Type	Status	Deskripsi
page	Number	Opsional	Halaman pagination. Default: 1. Setiap halaman berisi 20 entri.

Response

200 OK

{
  "status":  200,
  "data": [
    {
      "id":         "REQ-1735723200001",
      "apikey":    "AO_xxxxx...",
      "user_email": "user@email.com",
      "username": "John",
      "endpoint": "/api/v1/check-saldo",
      "method":   "GET",
      "ip":       "180.244.x.x",
      "date":     "2025-01-01T11:00:00.000Z"
    }
  ],
  "total":   1,
  "hasMore": false
}

Struktur Data

Field	Type	Deskripsi
id	String	ID unik request dengan prefix REQ-
apikey	String	API Key yang digunakan untuk request
user_email	String	Email pemilik API Key
username	String	Username pemilik API Key
endpoint	String	Path endpoint yang dipanggil, contoh: /api/v1/topup
method	String	Metode HTTP: GET atau POST
ip	String	Alamat IP pemanggil request
date	String	Timestamp ISO 8601 saat request masuk

Request Log hanya bisa diakses melalui sesi login, bukan via API Key. Endpoint ini tidak termasuk dalam sistem checkApiKey sehingga tidak akan tercatat sebagai request API. Data disimpan di database/mutasi-api.json dan dapat dipantau oleh Admin dari panel.

Cek E-Wallet (Inquiry)

Validasi nomor tujuan berbagai layanan dompet digital

Aku mau integrasiin endpoint "Cek E-Wallet (Inquiry)" dari Payment Gateway CHOJI ke project aku.

Endpoint: POST https://choji.web.id/api/v1/cek
Autentikasi: header "x-api-key: API_KEY_AKU" atau query param "?apikey=API_KEY_AKU"
Body (JSON): { "code": "CEKD", "dest": "08123456789" }
Parameter code: kode produk (CEKD | CEKGJK | CEKISAKU | CEKLINK | CEKOVO | CEKSHP, sesuai layanan e-wallet)
Parameter dest: nomor HP tujuan yang mau divalidasi

Endpoint ini dipakai buat validasi nomor e-wallet tujuan (cek nama pemilik & keberadaan akun) SEBELUM proses Withdraw Instant, biar tidak salah kirim.

Tolong bantu aku bikin function/service buat validasi nomor e-wallet ini (bahasa/framework: [ISI BAHASA & FRAMEWORK KAMU]), yang dipanggil sebelum eksekusi endpoint Withdraw Instant.

Dokumentasi lengkap: https://choji.web.id/docs

POST /api/v1/cek Auth Required

Informasi Biaya Penggunaan

Administrator — Pengguna dengan role Admin tidak dikenakan biaya apapun saat menggunakan endpoint inquiry ini.

Gratis

Member / User Reguler — Setiap pemanggilan endpoint inquiry ini akan dikenakan biaya sebesar Rp 1 per request, dipotong langsung dari saldo akun Anda.

Rp 1 / req

Melakukan validasi (inquiry) nomor tujuan untuk berbagai layanan dompet digital (E-Wallet). Gunakan endpoint ini untuk memverifikasi keberadaan akun E-Wallet penerima sebelum melakukan top-up atau transfer.

Daftar Kode E-Wallet

Kode	Layanan	Deskripsi
CEKD	Dana	Cek nama akun Dana berdasarkan nomor HP
CEKGJK	Gojek / GoPay	Cek nama akun Gojek Customer berdasarkan nomor HP
CEKISAKU	iSaku	Cek nama akun iSaku berdasarkan nomor HP
CEKLINK	LinkAja	Cek nama akun LinkAja berdasarkan nomor HP
CEKOVO	OVO	Cek nama akun OVO berdasarkan nomor HP
CEKSHP	ShopeePay	Cek nama akun ShopeePay berdasarkan nomor HP

Request Body

Parameter	Type	Status	Deskripsi
apikey	String	Wajib	API Key Anda
code	String	Wajib	Kode inquiry, contoh: CEKD
dest	String	Wajib	Nomor HP tujuan sesuai layanan E-Wallet yang dipilih

Contoh Request

JSON Body

POST /api/v1/cek
Content-Type: application/json

{
  "apikey": "AO_xxxxx221220241234abcdefghij",
  "code":   "CEKD",
  "dest":   "08123456789"
}

Response (Sukses)

200 OK

{
  "status": 200,
  "code":   "CEKD",
  "dest":   "08123456789",
  "result": "Budi Santoso | 08123456789"
}

Endpoint CEK E-Wallet menggunakan path POST /api/v1/cek. Pembeda antar layanan hanya pada nilai parameter code yang dikirimkan.

Webhook / Callback API

Terima notifikasi status transaksi secara real-time ke server Anda

Aku mau bikin webhook receiver buat nerima notifikasi transaksi dari Payment Gateway CHOJI.

CHOJI bakal ngirim POST request ke webhook URL yang aku setting, tiap kali status transaksi berubah (misal jadi SUCCESS). Body-nya JSON berisi transaction_id, event_type, dan data transaksi lainnya. Ada header signature "x-signature" berisi HMAC-SHA256 dari body payload, ditandatangani pakai secret_key yang aku dapat pas setting webhook.

Aku perlu server aku (VPS/hosting) yang bisa diakses publik via HTTPS buat nerima callback ini.

Tolong bantu aku bikin:
1. Endpoint webhook receiver (bahasa/framework: [ISI BAHASA & FRAMEWORK KAMU]) yang nerima POST request dari CHOJI
2. Verifikasi signature HMAC-SHA256 di header x-signature, cocokkan sama hasil hash body payload pakai secret_key aku, tolak request kalau signature tidak valid
3. Setelah signature valid, update status transaksi di database aku sesuai payload yang diterima
4. Balikin response 200 OK biar CHOJI tau webhook-nya berhasil diterima

Dokumentasi lengkap: https://choji.web.id/docs

CHOJI dapat mengirim notifikasi outbound (dari server kami ke server Anda) setiap kali sebuah transaksi mengalami perubahan status, sehingga Anda tidak perlu melakukan polling ke endpoint Check Status secara berulang. Fitur ini terpisah dari endpoint API lainnya dan dikonfigurasi langsung dari Dashboard, bukan lewat kode.

Ini adalah dokumentasi untuk webhook yang dikirim oleh CHOJI ke server Anda. Anda tidak perlu melakukan apa pun untuk urusan internal kami memproses pembayaran — hanya endpoint di bawah ini yang relevan untuk integrasi Anda.

Cara Mengaktifkan

Langkah	Deskripsi
1. Login Dashboard	Masuk ke dashboard CHOJI menggunakan akun Anda.
2. Buka Profil	Navigasi ke halaman Profil, lalu klik tombol Webhook / Callback.
3. Isi URL & Simpan	Masukkan URL endpoint HTTPS milik server Anda, lalu klik Simpan Pengaturan.
4. Salin Secret Key	Secret Key akan dibuat otomatis pada penyimpanan pertama. Gunakan untuk verifikasi signature (lihat bagian di bawah).

URL webhook wajib menggunakan HTTPS. URL berbasis HTTP akan ditolak saat disimpan.

Endpoint Konfigurasi (Dashboard API)

Endpoint berikut digunakan oleh dashboard untuk mengelola konfigurasi webhook Anda, dan memerlukan sesi login aktif (bukan API Key).

Method	Endpoint	Deskripsi
GET	/api/webhook/config	Mengambil konfigurasi webhook aktif Anda saat ini.
POST	/api/webhook/config	Menyimpan atau memperbarui URL webhook. Body: { "webhook_url": "https://..." }
GET	/api/webhook/logs	Mengambil 50 log pengiriman webhook terbaru.

Format Data Payload

Struktur JSON yang dikirim ke server Anda

POST URL Webhook Anda HMAC-SHA256 Signed

Server Anda akan menerima request POST dengan Content-Type: application/json setiap kali sebuah transaksi mencapai status akhir (contoh: SUCCESS). Server Anda wajib merespons dengan HTTP 200 atau 201 agar pengiriman ditandai berhasil.

Contoh Body Request

application/json

{
  "transaction_id": "TOPUP-1735723200001",
  "event_type":     "PAYMENT_SUCCESS",
  "amount":         55000,
  "status":         "SUCCESS"
}

Struktur Data

Field	Type	Deskripsi
transaction_id	String	ID transaksi di sistem CHOJI. Simpan untuk pencocokan dengan transaksi lokal Anda.
event_type	String	Jenis event, contoh: PAYMENT_SUCCESS.
amount, status, dll	Mixed	Field tambahan mengikuti jenis transaksi, dapat bervariasi antar event.

Server Anda memiliki waktu 5 detik untuk merespons. Kami tidak melakukan retry otomatis saat ini — setiap percobaan pengiriman (berhasil maupun gagal) tercatat di log webhook pada Dashboard, termasuk status code dan response body dari server Anda.

Verifikasi Signature (HMAC-SHA256)

Pastikan request benar-benar berasal dari CHOJI

Setiap callback ditandatangani menggunakan Secret Key unik milik akun Anda (dibuat otomatis saat pertama kali menyimpan konfigurasi webhook). Tanda tangan dikirim melalui header X-FR3-Signature.

Cara Verifikasi

Langkah	Deskripsi
1	Ambil raw body (string JSON mentah, bukan hasil parse ulang) dari request yang masuk.
2	Hitung HMAC-SHA256 dari raw body tersebut menggunakan Secret Key Anda.
3	Bandingkan hasilnya dengan nilai header X-FR3-Signature menggunakan constant-time comparison (contoh: crypto.timingSafeEqual di Node.js), bukan operator === biasa, untuk mencegah timing attack.
4	Jika tidak cocok, tolak request dengan HTTP 401. Jangan proses payload sebagai transaksi valid.

Contoh Kode (Node.js / Express)

JavaScript

const crypto = require("crypto");

function isValidFr3Signature(rawBody, signatureHeader, secretKey) {
  if (!signatureHeader) return false;
  const expected = crypto.createHmac("sha256", secretKey).update(rawBody).digest("hex");
  const a = Buffer.from(signatureHeader);
  const b = Buffer.from(expected);
  if (a.length !== b.length) return false;
  return crypto.timingSafeEqual(a, b);
}

Jangan pernah membagikan Secret Key Anda secara publik atau menyimpannya di kode sisi client (frontend). Perlakukan sama seperti API Key.

Error Codes

Referensi lengkap kode error dan cara penanganannya

Semua error mengembalikan JSON dengan field status (HTTP status code) dan error berisi pesan deskriptif.

Format Error

Error Response

{
  "status": 401,
  "error":  "API Key tidak valid atau tidak ditemukan"
}

Kode HTTP

200

OK

Request berhasil diproses.

400

Bad Request

Parameter tidak valid atau tidak lengkap.

401

Unauthorized

API Key tidak ada, tidak valid, atau tidak ditemukan.

403

Forbidden

Akun diblokir atau akses ditolak.

404

Not Found

Resource (user/transaksi) tidak ditemukan.

429

Too Many Requests

Rate limit terlampaui. Terapkan exponential backoff.

500

Server Error

Kesalahan internal server. Coba lagi dalam beberapa saat.

Pesan Error Umum

Error Message	HTTP	Endpoint	Penanganan
API Key diperlukan	401	Semua (kecuali check-user)	Sertakan parameter apikey
API Key tidak valid atau tidak ditemukan	401	Semua	Periksa kembali nilai API Key — pastikan sudah ter-generate di Profil
Akun Anda dibekukan	403	Semua	Hubungi admin
Minimum topup 1000	400	POST /topup	Nominal minimal Rp 1.000
Saldo tidak mencukupi	400	POST /transfer	Topup saldo terlebih dahulu
Email penerima tidak ditemukan	404	POST /transfer	Verifikasi dengan POST /check-user
Tidak bisa transfer ke diri sendiri	400	POST /transfer	Email penerima harus berbeda
Transaksi tidak ditemukan	404	GET /check-status	Periksa nilai idTransaksi
Internal server error	500	Semua	Retry dengan exponential backoff
code dan dest diperlukan	400	POST /cek	Lengkapi kedua parameter
Nomor tidak ditemukan atau tidak valid	404	POST /cek	Pastikan nomor benar dan terdaftar di layanan terkait

Integrasi Pembayaran
Cepat & Aman

Instalasi CHOJI ke VPS

1 vCPU / 1-2 GB RAM

PostgreSQL 14+

Node.js 20 LTS + Nginx

Introduction

GET untuk Data & Inisiasi

POST untuk State Change

HTTPS Wajib

Integrasi via AI Assistant

Authentication

1. Login Dashboard

2. Buka Profil

3. Generate Key

Security & Rate Limiting

Multi-Method Auth

TLS Enforcement

Session & Expiry

Account Lockout

User-Agent Filtering

Atomic Transactions

Buat Topup

Cancel Topup

Check Status

Check Saldo

History Transaksi

Check User

Transfer Saldo

Withdraw Instant (E-Wallet)

Request Log

Cek E-Wallet (Inquiry)

Webhook / Callback API

Format Data Payload

Verifikasi Signature (HMAC-SHA256)

Error Codes

Siap Mengintegrasikan API?

API Tester

Integrasi PembayaranCepat & Aman

Instalasi CHOJI ke VPS

1 vCPU / 1-2 GB RAM

PostgreSQL 14+

Node.js 20 LTS + Nginx

Introduction

GET untuk Data & Inisiasi

POST untuk State Change

HTTPS Wajib

Integrasi via AI Assistant

Authentication

1. Login Dashboard

2. Buka Profil

3. Generate Key

Security & Rate Limiting

Multi-Method Auth

TLS Enforcement

Session & Expiry

Account Lockout

User-Agent Filtering

Atomic Transactions

Buat Topup

Cancel Topup

Check Status

Check Saldo

History Transaksi

Check User

Transfer Saldo

Withdraw Instant (E-Wallet)

Request Log

Cek E-Wallet (Inquiry)

Webhook / Callback API

Format Data Payload

Verifikasi Signature (HMAC-SHA256)

Error Codes

Siap Mengintegrasikan API?

API Tester

Integrasi Pembayaran
Cepat & Aman