VOG Payroute — Overview

VOG Payroute adalah satu pintu pembayaran untuk semua project VOG (saas, events, prev, dan berikutnya). Project tidak lagi bicara langsung ke Tripay, GDCPay, atau Midtrans: project memanggil Payroute, Payroute meneruskan ke payment gateway, lalu mengabari project lewat webhook saat pembayaran selesai.

Alur

Project ──(1) POST /v1/charges──────────────► Payroute ──► Tripay / GDCPay / Midtrans
        ◄─(2) qr_string, gateway, rerouted ──
                     pelanggan scan & bayar
                                              Payroute ◄──(3) webhook gateway
Project ◄─(4) webhook charge.paid (signed) ── Payroute
Project ──(opsional) GET /v1/charges/{id} ──► Payroute   (polling status)

Project membuat charge: invoice_id, amount, callback_url, dan (opsional) gateway.
Payroute memilih gateway, membuat QRIS, dan mengembalikan qr_string serta gateway yang benar-benar dipakai.
Gateway mengabari Payroute (satu URL webhook per gateway untuk semua project).
Payroute mengirim webhook bertanda tangan ke callback_url project, dengan retry.

Lingkungan

	Production	Staging
Base URL	`https://api-payroute.vogsystem.com`	`https://api-payroute-staging.vogsystem.com`
Akun gateway	live	sandbox
Gateway `fake` + `/simulate`	tidak ada	ada

Staging dan production adalah instance terpisah: key/secret client, data, dan credential gateway berbeda. Key staging tidak berlaku di production.

Konsep

Client — satu per project per instance. Punya key_id (pk_…) dan secret (sk_…, diberikan sekali oleh tim Payroute), plus daftar host yang boleh menerima webhook.
Charge — satu percobaan pembayaran untuk satu invoice. Id PR + 20 karakter. Status: pending → paid | expired | failed. paid final.
Gateway — tripay, gdc, midtrans (dan fake di staging). Default tripay, bisa diganti tim Payroute.
Reroute — kalau gateway yang diminta/default dimatikan atau error, Payroute memakai gateway berikutnya dan menandai rerouted: true + reroute_reason.

Yang bukan urusan Payroute

MDR/fee dan laporan finance tetap di masing-masing project. Payroute hanya memberi tahu gateway mana yang dipakai (gateway) supaya project bisa mencatatnya.

Dokumen lain

Authentication · Charges · Webhooks · Routing & failover · Testing · Checklist integrasi · referensi lengkap: /docs