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 membuat invoice pembayaran DANA baru. Kirimkan nominal dan API Key Anda di dalam URL.

  • Method: GET
  • URL: /api/invoice

Parameter:

  • apikey (string, wajib)
  • amount (integer, wajib)
  • custom_id (string, opsional, ID transaksi dari sistem Anda)

Contoh Request:

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

Contoh Response:

{ "success": true, "invoice_id": "INVabc1234", "payment_id": "INVabc1234", "custom_id": "tg_5929295379_001", "amount": 50000, "fee": 500, "total": 50500, "qris_image": "data:image/png;base64,...", "expired_at": "2025-01-01 12:00:00" }

D. Cek Status Invoice

Setelah pengguna membayar lewat QR DANA, gunakan endpoint ini untuk mengecek apakah pembayaran telah berhasil atau belum. Status yang tersedia: pending, paid, expired, cancelled.

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

Parameter:

  • apikey (string, wajib)
  • invoice_id atau custom_id (string, wajib salah satu)

Contoh Request:

/api/invoice/status?apikey=YOUR_API_KEY&custom_id=tg_5929295379_001

Contoh Response:

{ "invoice_id": "INVabc1234", "payment_id": "INVabc1234", "custom_id": "tg_5929295379_001", "amount": 50000, "fee": 500, "total": 50500, "status": "paid", "qris_image": "data:image/png;base64,...", "expired_at": "2025-01-01 12:00:00", "created_at": "2025-01-01 11:30:00" }

E. Batalkan Invoice

Gunakan endpoint ini untuk membatalkan invoice yang masih pending. Invoice yang sudah paid tidak dapat dibatalkan.

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

Parameter:

  • apikey (string, wajib)
  • invoice_id atau custom_id (string, wajib salah satu)

Contoh Request:

/api/invoice/cancel?apikey=YOUR_API_KEY&custom_id=tg_5929295379_001

Contoh Response:

{ "success": true, "invoice_id": "INVabc1234", "payment_id": "INVabc1234", "custom_id": "tg_5929295379_001", "status": "cancelled" }