Kesles PSP — Integration Docs
Confidential
Dokumen ini hanya untuk bank dan acquirer yang sudah memiliki perjanjian kerja sama (NDA) dengan Kesles. Jangan disebarkan ke pihak lain.
Untuk Siapa
Dokumentasi ini ditujukan untuk tim teknis dari bank dan payment acquirer yang terintegrasi dengan platform Kesles Merchant sebagai PSP.
Kamu mendapatkan akses read-only ke data merchant yang NMID-nya diterbitkan oleh acquirer kamu.
Sections
| Section | Isi |
|---|---|
| Integration | Kontrak integrasi, HMAC auth, flow overview |
| Events | Lifecycle events merchant yang dikirim Kesles ke PSP |
| Testing | Sandbox environment dan test scenarios |
| Reference | Endpoint list, error codes |
Onboarding
Untuk mulai integrasi sebagai PSP, hubungi tim Kesles dengan informasi berikut:
- Bank/acquirer code — kode SWIFT 4 huruf (contoh:
BMRI,BRIN,BBNI) - IP allowlist — range IP production yang akan digunakan untuk request
- Technical PIC — nama dan kontak untuk koordinasi HMAC key rotation
- NDA yang sudah ditandatangani
Tim Kesles akan menyiapkan:
- Kredensial HMAC (API Key ID + secret, dikirim via saluran aman)
- Akses ke sandbox/staging environment
- Jadwal UAT sebelum go-live
Checklist Sebelum Go-Live
- NDA ditandatangani
- Bank code terdaftar di sistem Kesles
- IP allowlist dikonfigurasi
- HMAC credentials diterima via saluran aman (1Password / Bitwarden)
- Signature computation diverifikasi di staging
- Merchant lookup (
GET /merchants/by-nmid/{nmid}) berhasil di staging - Timestamp freshness check (±300 detik) diimplementasikan
- Retry dengan exponential backoff diimplementasikan
- Key rotation schedule disepakati (setiap 90 hari)
- UAT sign-off dari kedua pihak
Butuh Bantuan?
Hubungi tim Kesles di support@kesles.com untuk pertanyaan teknis terkait integrasi.