KiPaydocs

DOKUMENTASI KIPAY

Dari API key ke pembayaran pertama, tanpa menebak langkah berikutnya.

Buat transaksi sandbox, tampilkan QRIS, lalu jaga status order tetap sinkron melalui webhook. Setiap langkah menjelaskan apa yang dikirim, response yang diterima, dan tindakan berikutnya.

Mulai quickstart Lihat API Reference
Sekitar 10 menit Sandbox terisolasi Webhook real-time
Anda akan membangun01 / FIRST PAYMENT
Buat transaksi2 Tampilkan QRIS3 Terima konfirmasi4 Penuhi order
Status akhirtransaction.paidOrder aman untuk dipenuhi

ALUR YANG MUDAH DIIKUTI

Satu request. Satu lifecycle yang jelas.

KiPay menjaga hubungan antara transaksi, QR, konfirmasi jaringan, dan status order. Gunakan diagram ini sebagai gambaran utama saat membaca dokumentasi.

REQUEST HINGGA PAIDSiapa mengetahui apa, dan kapan order aman dipenuhi.
Urutan pembayaran KiPay dari request sampai order terpenuhiEmpat lane menunjukkan backend, KiPay API, checkout, dan jaringan QRIS. Request sinkron membuat transaksi dan QR. Konfirmasi jaringan mengubah status. Webhook kembali ke backend, lalu backend memverifikasi status sebelum memenuhi order.BACKENDsumber kebenaranKIPAY APIstatus transaksiCHECKOUTaksi pelangganQRISkonfirmasi jaringan01Buat transaksiPOST /transactions02Transaksi pendingtrx_id + qr_payload + expires_at03Render QR dari transaksi yang samaGET /qr.pngimage/png04Pelanggan membayarintent pembayaran QRIS05Konfirmasi jaringan mengubah statuspending menjadi paid06Webhook memberi sinyaltransaction.paidPenuhi setelah verifikasiGET transaksi berstatus paid
Prinsip operasionalCheckout memulai pembayaran. Backend memutuskan kapan order dipenuhi.

PILIH TITIK MULAI

Masuk lewat konteks kerja Anda.

Anda tidak perlu membaca seluruh dokumentasi sebelum mengirim request pertama.

QUICKSTART

Terima pembayaran pertama.

Ikuti satu alur lengkap dari project sandbox hingga menerima webhook paid.

Mulai integrasi API REFERENCE

Cari kontrak endpoint.

Lihat parameter, payload, response, dan error untuk setiap operasi.

Buka referensi GO LIVE

Bergerak dari pengujian ke production.

Validasi webhook, penanganan error, dan lifecycle sebelum menerima dana nyata.

Lihat checklist

REQUEST PERTAMA

Buat transaksi sandbox dengan satu request yang dapat diulang dengan aman.

Gunakan API key dari project sandbox. KiPay mengembalikan trx_id, QR payload, expires_at, dan status awal dalam satu response.

  1. 01
    Ambil API key sandbox

    Buka project sandbox dan salin credential khusus server.

  2. 02
    Kirim nominal dan referensi

    Referensi membantu menghubungkan transaksi KiPay dengan order Anda.

  3. 03
    Simpan trx_id

    Gunakan ID ini untuk membaca status dan mengambil gambar QR.

Buka quickstart lengkap
create-transaction.sh
curl --request POST \
  --url https://api.kipay.biz.id/api/pay/apg_your_project_key/transactions \
  --header "Content-Type: application/json" \
  --data '{
    "amount": 285000,
    "note": "order_nusa_2048"
  }'
201 Createdstatus: "pending"transaction_id: trx_7N4Q2M
DOCS STATUS

API v1.0 tersedia untuk sandbox. Checklist production dan webhook signing sedang disiapkan untuk dokumentasi publik.

Lihat perubahan terbaru