Pengenalan Gerbang Pay

Apa itu Gerbang Pay?

Gerbang Pay adalah Payment Orchestration API yang memungkinkan bisnis Indonesia menerima pembayaran dari berbagai metode dan provider melalui satu integrasi tunggal. Daripada harus mengintegrasikan Winpay dan Midtrans secara terpisah, Anda cukup terhubung ke Gerbang Pay — dan sistem kami yang mengelola routing, signature, retry, serta forwarding webhook ke aplikasi Anda.

Platform ini dirancang untuk multi-tenant: setiap bisnis (tenant) memiliki konfigurasi provider, routing rule, dan webhook URL sendiri-sendiri yang terisolasi.

---

Arsitektur Platform

Aplikasi Klien
      │
      │  POST /v1/payments/create
      ▼
┌─────────────────────┐
│    Gerbang Pay API  │  ← Autentikasi, Validasi, Idempotency
│   (Orchestrator)    │
└─────────┬───────────┘
          │  Routing berdasarkan konfigurasi tenant
    ┌─────┴──────┐
    ▼            ▼
┌───────┐   ┌──────────┐
│Winpay │   │ Midtrans │   ← Provider eksternal
└───────┘   └──────────┘
    │            │
    └─────┬──────┘
          │  Callback (POST /v1/callbacks/{provider}/{tenant_id})
          ▼
┌─────────────────────┐
│    Gerbang Pay API  │  ← Verifikasi signature, update status
└─────────┬───────────┘
          │  Webhook (HMAC-signed)
          ▼
   Webhook URL Klien

Alur singkat:

1. Klien membuat payment → Gerbang Pay meneruskan ke provider yang dikonfigurasi
2. Provider memproses dan mengirim callback ke Gerbang Pay
3. Gerbang Pay memverifikasi callback, memperbarui status, lalu mengirim webhook ke URL klien

---

Provider yang Didukung

Winpay

Provider payment berbasis SNAP API standard Bank Indonesia.

Metode Pembayaran	Channel yang Didukung
Virtual Account	BCA, BRI, BNI, Mandiri, BSI, CIMB, Permata, Muamalat, Sinarmas, BNC, Maybank
QRIS	MPM Dynamic
E-Wallet	DANA, OVO, ShopeePay, AstraPay, SpeedCash
Over The Counter	Alfamart, Indomaret, Fastpay

Midtrans

Provider payment terkemuka dengan coverage luas.

Metode Pembayaran	Channel yang Didukung
Virtual Account	BCA, BNI, BRI, Mandiri, Permata, CIMB, Danamon
QRIS	MPM Dynamic
E-Wallet	GoPay
Cardless Credit	Akulaku, Kredivo
Over The Counter	Alfamart, Indomaret

---

Base URL

https://gerbang-pay-api.gai.co.id

Semua endpoint berada di bawah prefix /v1.

Contoh URL lengkap:

https://gerbang-pay-api.gai.co.id/v1/payments/create

---

Format Response

Semua response dari Gerbang Pay menggunakan envelope JSON yang konsisten.

Response Sukses

{
  "success": true,
  "data": { ... }
}

Untuk endpoint dengan pagination, response menyertakan total_count:

{
  "success": true,
  "total_count": 42,
  "data": [ ... ]
}

Response Error

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Pesan error yang dapat dibaca manusia"
  }
}

Lihat halaman Error Codes untuk daftar lengkap semua kode error.

---

Versi API

API saat ini berada di versi v1. Semua perubahan breaking akan diluncurkan sebagai versi baru dengan periode deprecation.

---

💡 Langkah selanjutnya: Lanjut ke Quickstart untuk membuat payment pertama Anda dalam 5 langkah, atau pelajari cara autentikasi terlebih dahulu.