Dokumentasi API

Panduan lengkap integrasi API pembayaran untuk aplikasi Anda.

A. Persiapan

Langkah pertama yang harus Anda lakukan adalah mendaftar dan login ke dashboard. Setelah itu, dapatkan API Key Anda di menu Profil untuk mulai mengintegrasikan sistem pembayaran ke aplikasi Anda.

B. Cek Saldo (Balance)

Gunakan endpoint ini untuk mendapatkan informasi saldo akun Anda secara real-time.

  • Method: GET
  • URL: /api/balance

Parameter:

  • apikey (string, wajib)

Contoh Request:

/api/balance?apikey=YOUR_API_KEY

Contoh Response:

{ "balance": 150000 }

C. Membuat Invoice Baru

Endpoint ini digunakan untuk meng-generate QRIS untuk transaksi/deposit baru. Kirimkan nominal dan API Key Anda di dalam URL.

  • Method: GET
  • URL: /api/invoice

Parameter:

  • apikey (string, wajib)
  • amount (integer, wajib)

Contoh Request:

/api/invoice?apikey=YOUR_API_KEY&amount=50000

Contoh Response:

{ "success": true, "invoice_id": "64c8d9e...", "amount": 50000, "fee": 500, "total": 50500, "qris_image": "https://...", "expired_at": "2025-01-01 12:00:00" }

D. Cek Status Invoice

Setelah pengguna melakukan scan QRIS, gunakan endpoint ini untuk mengecek apakah pembayaran telah berhasil atau belum.

  • Method: GET
  • URL: /api/invoice/status

Parameter:

  • apikey (string, wajib)
  • invoice_id (string, wajib)

Contoh Request:

/api/invoice/status?apikey=YOUR_API_KEY&invoice_id=YOUR_INVOICE_ID

Contoh Response:

{ "invoice_id": "64c8d9e...", "amount": 50000, "fee": 500, "total": 50500, "status": "paid", "qris_image": "https://...", "expired_at": "2025-01-01 12:00:00", "created_at": "2025-01-01 11:30:00" }