Quickstart

Integrasi BITS Pay dalam 3 langkah: buat charge, tampilkan QRIS, konfirmasi pembayaran.

0. Dapatkan API key

Daftar di dashboard (panduan lengkap: Panduan Dashboard), buat aplikasi di workspace kamu. API key (sk_...) hanya ditampilkan sekali saat create/rotate — simpan di tempat aman. Semua request /v1/* pakai header:

Authorization: Bearer sk_xxxxxxxxxxxxxxxx

Base URL: https://api.pay.bits.co.id. Response sukses selalu { "success": true, "data": ... }, error { "success": false, "error": { "code", "message" } }.

1. Buat charge (QRIS dinamis)

const res = await fetch('https://api.pay.bits.co.id/v1/charges', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer sk_xxxxxxxxxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    order_id: 'ORD-001',
    amount: 150000,
    description: 'Pembayaran invoice #001',
  }),
});
const { success, data, error } = await res.json();
if (!success) throw new Error(`${error.code}: ${error.message}`);

console.log(data.amount_due);  // 150001
console.log(data.qr_image);    // data:image/png;base64,...
console.log(data.expired_at);  // batas bayar, ISO-8601 UTC: "2026-09-02T12:45:00Z"

Tampilkan data.qr_image sebagai <img src> ke pelanggan. Pelanggan bayar nominal persis amount_due.

2. Cek status pembayaran

const res = await fetch(`https://api.pay.bits.co.id/v1/payments/${id}`, {
  headers: { Authorization: 'Bearer sk_xxxxxxxxxxxxxxxx' },
});
const { data } = await res.json();
// data.status: 'pending' | 'success' | 'failed' | 'expired' | 'pending_review'

3. Konfirmasi pembayaran

const form = new FormData();
form.append('amount', '150001');        // = amount_due
form.append('proof_image', fileInput.files[0]); // opsional

const res = await fetch(`https://api.pay.bits.co.id/v1/payments/${id}/confirm`, {
  method: 'POST',
  headers: { Authorization: 'Bearer sk_xxxxxxxxxxxxxxxx' },
  body: form,
});
const { data } = await res.json();
// Request valid SELALU HTTP 200 — cek data.status:
// 'success'        → auto_confirm (lunas)
// 'pending_review' → OCR confidence rendah, direview admin
// 'failed'         → nominal tidak cocok / bukti tidak disertakan

Error handling