📚 Developer API Docs

1. Kredensial API

Setiap request wajib menyertakan header berikut — nilai di bawah ini milik akun Anda setelah login:

Salin API Key Salin ID Merchant Salin Webhook Secret

Base URL

2. Create Transaction

Generate QRIS dinamis + kode unik. Gunakan total_amount dari response sebagai nominal wajib dibayar.

Kode unik kecil per tier: produk Rp 1–5 rb (+11–60), Rp 5–10 rb (+21–90), Rp 10–500 rb (+31–150). Contoh base Rp 10.000 → total sekitar Rp 10.021–10.090.

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://pay.fncreative.org/api/qris/create',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => '{
    "order_id": "INV-123",
    "amount": 10000,
    "keterangan": "Pembayaran Invoice #123"
  }',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'x-api-key: YOUR_API_KEY',
    'id_merchant: YOUR_MERCHANT_ID'
  ),
));

Response (201)

{
  "status": true,
  "message": "Transaction Created Successfully",
  "data": {
    "order_id": "INV-123",
    "amount": "10000.00",
    "amount_uniq": "45.00",
    "total_amount": "10045.00",
    "status": "PENDING",
    "expired_at": "2026-06-13 16:05:01",
    "expired_menit": "5",
    "signature": "...",
    "keterangan": "Pembayaran Invoice #123",
    "qris_image": "data:image/png;base64,...",
    "qr_string": "00020101..."
  }
}

3. Masa Berlaku QR & Kode Unik

Setiap transaksi QRIS dinamis memiliki batas waktu pembayaran. Nilai aktual platform saat ini (live dari GET /api/docs/meta):

Alur merchant

1. Panggil POST /qris/create → tampilkan QR + total_amount + countdown dari expired_at.
2. Customer bayar dalam waktu aktif → webhook PAID atau polling GET /qris/status/{order_id} → SUCCESS.
3. Lewat waktu tanpa bayar → status EXPIRED → buat QR baru (disarankan order_id baru).

4. Webhook Callback

Server merchant harus merespon HTTP 200 OK. Callback dikirim saat pembayaran sukses — field status bernilai PAID (bukan SUCCESS seperti di API status/history).

Validasi Signature

Secret webhook akun Anda: —

signature = HMAC_SHA256(
  YOUR_WEBHOOK_SECRET,
  order_id + "|" + status + "|" + total_amount + "|" + payment_date
)

{
  "order_id": "INV-123",
  "status": "PAID",
  "amount": 10000,
  "total_amount": 10045,
  "payment_date": "2026-06-01 21:48:01",
  "created_at": "2026-06-01 21:18:01",
  "updated_at": "2026-06-01 21:48:01",
  "keterangan": "Pembayaran Invoice #123",
  "direct_url": null,
  "signature": "..."
}

5. Check Status

Header sama seperti create: x-api-key + id_merchant. Status di response API: PENDING, SUCCESS, atau EXPIRED.

6. Transaction History

7. Ringkasan Harian

Menampilkan total transaksi sukses dan pendapatan per hari (zona Asia/Jakarta). Parameter date opsional — default hari ini.

8. Login & Dashboard

Dashboard web memakai session token (Bearer). API integrasi tetap memakai x-api-key.

{
  "email": "dev@tokoabc.com",
  "password": "password-anda"
}

Response berisi session_token. Kredensial API lihat via GET /merchants/me setelah login (bukan di body login).

Header: Authorization: Bearer <session_token>

9. Dompet & Penarikan

Fee platform: 0,7% dari total pembayaran (termasuk kode unik) per transaksi SUCCESS. Di atas Rp 500.000: tambahan biaya admin 0,7% (total 1,4%). Penarikan minimum Rp 25.000.

Notifikasi Telegram untuk merchant diatur lewat dashboard web (menu Telegram). Admin platform tetap menerima semua alert operasional.

Best Practice Integrasi (Produksi)

• Tampilkan total_amount besar di checkout — bukan hanya amount.
• Countdown dari expired_at (timezone server UTC/WIB sesuai field).
• Satu order_id = satu invoice. Jangan create ulang berkali-kali tanpa perlu.
• Jika masih PENDING, API mengembalikan QR yang sama — cek status dulu sebelum create baru.
• Setelah EXPIRED, create dengan order_id baru atau hapus record expired (reuse order_id diperbolehkan setelah expired).
• Validasi webhook dengan webhook_secret + HMAC — abaikan callback tanpa signature valid.
• Fee platform (0,7% / 1,4% di atas Rp 500.000) hanya pada transaksi SUCCESS — EXPIRED tidak dikenai fee.

Status Types

Onboarding Partner

User bisa daftar sendiri tanpa hubungi admin:

1. Buka https://pay.fncreative.org/register/
2. Isi nama, email, password, dan opsional callback_url webhook HTTPS
3. Setujui Syarat & Ketentuan dan Kebijakan Privasi
4. Sistem menampilkan x-api-key, id_merchant, dan webhook_secret
5. Login kapan saja di /login/ — API key yang sama terlihat di dashboard

API Registrasi (opsional)

{
  "name": "Toko ABC",
  "email": "dev@tokoabc.com",
  "password": "password-min-8",
  "password_confirm": "password-min-8",
  "store_name": "Toko ABC",
  "callback_url": "https://tokoabc.com/webhook/fn-payment",
  "terms_accepted": true
}