Checklist integrasi project
Sebelum go-live:
- Minta tim Payroute membuatkan client (staging dulu, lalu production) dengan host callback Anda.
- Simpan
key_iddansecretdi env/secret manager server (bukan di kiosk, bukan di repo). - Implementasi signature lolos test vector (
9820b41a…bb50). - Jam server sinkron NTP (batas ±5 menit).
-
POST /v1/chargesdipanggil dari server project, denganinvoice_idunik per transaksi. - Retry create saat timeout memakai
invoice_idyang sama (create bisa sampai ±30 detik saat failover; timeout pendek di kiosk → retry/GET, bukan error ke pelanggan). -
gateway,rerouted,reroute_reasondisimpan per transaksi (untuk finance). - Endpoint callback: https, verifikasi signature, jawab 2xx < 10 detik, dedup
X-Payroute-Delivery, ikuticharge.status. -
paidsetelahexpiredditangani (pembayaran terlambat). - Polling
GET /v1/charges/{id}sebagai cadangan (mis. tiap 5 detik selama QR tampil). - Error
401,409,422,502ditangani dan dicatat denganrequest_id. - Alur lengkap diuji di staging dengan gateway
fake+/simulate. - Untuk pilihan gateway per tenant (saas): ambil daftar dari
GET /v1/gateways.