KiPaydocs
Dokumentasi/Referensi

REFERENSI

Jaga credential di server dan keputusan pembayaran di backend

Keamanan integrasi KiPay dimulai dari pemisahan credential, log yang bersih, dan pemenuhan order yang tidak mempercayai browser.

8 menit Diperbarui 29 Agustus 2026
TRUST BOUNDARYAPI key hanya melintasi jalur yang dapat dikendalikan backend.
Trust boundary untuk API key KiPayBrowser berada di luar trust boundary dan hanya mengirim data awal order. Backend berada di dalam boundary, menyimpan API key, dan mengirim request dengan credential ke KiPay. Bundle source, analytics, dan log URL mentah adalah risiko eksposur yang harus dicegah.JALUR CREDENTIAL DAN RISIKO EKSPOSURTRUST BOUNDARY SERVERBROWSERhanya data awal orderamount + noteBACKEND ANDAAPI KEY TERSIMPAN DI SINIrequest dengan credentialKIPAY APICegah eksposurbundle sourceanalyticslog URL mentahsamarkan credential sebelum telemetry
01

API key adalah credential server

  • Simpan di secret manager atau environment variable
  • Jangan commit ke Git
  • Jangan kirim ke analytics
  • Jangan tampilkan di console browser
  • Gunakan API key berbeda untuk sandbox dan production
  • Rotasi API key ketika akses tim berubah
02

Perhatikan credential pada URL

Kontrak saat ini menempatkan API key pada path

URL dapat muncul di proxy log, access log, browser history, dan telemetry. Pastikan request hanya dibuat secara server-to-server dan terapkan redaksi path pada seluruh log.

03

Webhook tidak boleh langsung memenuhi order

  1. 01
    Terima payload

    Parse payload dengan batas ukuran dan Content-Type yang sesuai.

  2. 02
    Kirim response 2xx

    Berikan response dengan cepat tanpa menunggu pekerjaan berat.

  3. 03
    Verifikasi

    Baca data transaksi terbaru melalui API.

  4. 04
    Penuhi order satu kali

    Gunakan trx_id untuk mencegah pekerjaan ganda.

04

Kesiapan production

KontrolMinimum
TransportHTTPS tanpa downgrade
SecretTidak tersedia di source atau client
LogCredential telah disamarkan
Pemenuhan orderIdempotent
MonitoringAlert untuk webhook dan status yang tidak sinkron
RecoveryRekonsiliasi transaksi terjadwal