Testing

Gunakan staging (https://api-payroute-staging.vogsystem.com) dengan key staging. Staging memakai akun sandbox gateway dan punya gateway fake yang bisa Anda kendalikan.

Alur uji tanpa bayar sungguhan

1. Buat charge di gateway fake:

   { "invoice_id": "TEST-1", "method": "qris", "amount": 15000, "gateway": "fake",
     "callback_url": "https://<host-anda>/payroute/callback" }
   

2. Simulasikan hasilnya:

   POST /v1/charges/{id}/simulate
   { "status": "paid" }        // atau "expired" / "failed"
   

3. Endpoint callback Anda menerima webhook charge.paid yang sama persis dengan produksi (signature, retry, dedup).
4. Cek GET /v1/charges/{id} → status: paid.

/simulate hanya untuk charge di gateway fake dan tidak ada di production (404).

Postman

Collection dan environment ada di repo: docs/postman/. Isi variabel base_url, key_id, secret; signature dihitung otomatis oleh pre-request script.

Yang perlu diuji di project Anda

• Signature request benar (cocokkan dengan test vector di Authentication).
• Retry create dengan invoice sama → charge sama.
• Webhook: verifikasi signature, dedup X-Payroute-Delivery, ikuti charge.status.
• 502 gateway_unavailable ditangani (retry, pesan ke pengguna).
• Polling status berhenti saat paid / expired / failed.