Gambaran Umum PayIn
PayIn API memungkinkan merchant untuk menerima pembayaran dari pelanggan melalui QRIS (QR Code Indonesian Standard). Pelanggan membayar menggunakan aplikasi dompet digital atau m-banking yang mendukung QRIS.
Endpoint
| Endpoint | Metode | Keterangan |
|---|---|---|
POST /api/v1/merchant/payin/qris/create | POST | Buat QRIS untuk satu transaksi |
POST /api/v1/merchant/payin/qris/check | POST | Cek status pembayaran QRIS |
POST /api/v1/merchant/payin/qris/refund | POST | Refund pembayaran QRIS yang berhasil |
Biller
PayIn QRIS menggunakan biller GPay (GPAY) — payment gateway yang menyediakan QRIS merchant.
Alur Transaksi PayIn QRIS
Merchant Sistem Pelanggan
│ │ │
│ POST /payin/qris/create │ │
│────────────────────────────────>│ │
│ 200 OK { qr_code, trace_number}│ │
│<────────────────────────────────│ │
│ │ │
│ Tampilkan QR kepada pelanggan ─────────────────────────> │
│ │ Pelanggan scan & bayar │
│ │<─────────────────────────│
│ │ │
│ Webhook dari GPay (callback) │ │
│<────────────────────────────────│ │
│ │ │
│ ATAU polling /qris/check │ │
│────────────────────────────────>│ │
│ 200 OK { status } │ │
│<────────────────────────────────│ │
Konsep Penting
trace_number
Setiap QRIS yang dibuat memiliki trace_number unik yang diterbitkan oleh GPay. Gunakan nilai ini untuk:
- Cek status pembayaran via
/qris/check - Inisiasi refund via
/qris/refund
Webhook Callback
GPay mengirimkan notifikasi webhook ke sistem Relay ketika pembayaran QRIS dikonfirmasi. Sistem Relay kemudian memperbarui status transaksi secara otomatis. Anda dapat:
- Polling status via
/qris/check, atau - Menyediakan callback URL di konfigurasi merchant untuk menerima notifikasi push.
Status Transaksi
| Status | Keterangan |
|---|---|
SUCCESS | Pembayaran dikonfirmasi oleh bank/dompet pelanggan |
PENDING | Menunggu pembayaran dari pelanggan (QRIS belum dibayar) |
FAILED | QRIS kedaluwarsa atau pembayaran gagal |
Autentikasi
Semua endpoint PayIn menggunakan API Key via header X-API-Key dan opsional Signature Validation. Lihat Autentikasi.