API REFERENCE

Empat operasi untuk satu lifecycle pembayaran

Referensi ini menjelaskan kontrak publik KiPay saat ini, termasuk parameter, response, error, dan batas perilakunya.

4 menit Diperbarui 29 Agustus 2026

API CONSOLE

Kirim request langsung dan baca response dengan jelas

Masukkan API key sandbox, periksa parameter, lalu jalankan endpoint dari halaman ini. Credential hanya diteruskan untuk request tersebut dan tidak disimpan.

POSThttps://api.kipay.biz.id/api/pay/{apiKey}/transactions

Buat transaksi

Contoh response

Responseapplication/json

CONTOHPreview bodyBelum dikirim

1{2  "trx_id": "SBX-20260825-VG57V5",3  "mode": "sandbox",4  "requested_amount": 285000,5  "unique_code": 215,6  "amount": 285215,7  "status": "pending",8  "expires_at": "2026-08-26 06:50:08"9}

Contoh kode

curl --request POST \
  --url https://api.kipay.biz.id/api/pay/$KIPAY_API_KEY/transactions \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"amount":285000,"note":"order_nusa_2048"}'

OPERASI RESOURCEEmpat endpoint ditempatkan pada momen lifecycle yang tepat.

Base URL

Semua endpoint publik menggunakan HTTPS. apiKey pada path mengikat setiap request ke project pemiliknya. Selalu kirim request dari backend.

base-url

Text

https://api.kipay.biz.id

Operasi

Method	Path	Tujuan
POST	/api/pay/{apiKey}/transactions	Buat transaksi
GET	/api/pay/{apiKey}/transactions/{trxId}	Baca status
GET	/api/pay/{apiKey}/transactions/{trxId}/qr.png	Ambil gambar QR
POST	/api/pay/{apiKey}/transactions/{trxId}/simulate	Simulasikan paid pada sandbox

Format data

Request dan response utama menggunakan application/json
Endpoint QR mengembalikan image/png
Timestamp ditampilkan sebagai string date-time
Nominal disimpan sebagai integer dalam rupiah
trx_id sandbox diawali SBX

Dokumen OpenAPI

Gunakan dokumen OpenAPI sebagai sumber kontrak yang dapat diproses oleh tool. Gunakan panduan ini untuk memahami workflow dan keputusan integrasi.

openapi-url

Text

https://api.kipay.biz.id/openapi.json