Payment Gateway API

Payment Gateway memungkinkan Anda menerima pembayaran tanpa punya akun e-wallet atau merchant sendiri. Pembayaran ditampung di akun milik platform, hasilnya masuk ke saldo gateway Anda, dan dicairkan ke rekening bank Anda.

Bedanya dengan Payments API biasa:

Aktivasi

Payment Gateway harus disetujui admin sebelum bisa dipakai. Ajukan lewat dashboard → Payment Gateway → Ajukan Akses, isi data usaha Anda, lalu tunggu peninjauan.

Status pengajuan bisa dibaca lewat API:

GET /api/v1/gateway

Status akses, metode yang tersedia, saldo, dan tarif — dalam satu request.

Response 200

{
  "status": "success",
  "data": {
    "access": {
      "status": "APPROVED",
      "note": null,
      "createdAt": "2026-08-20T04:11:02.000Z",
      "processedAt": "2026-08-21T02:40:11.000Z",
      "feeToCustomer": false
    },
    "walletAccountId": "GATEWAY",
    "methods": [
      { "value": "QRIS-DYNAMIC", "label": "QRIS" },
      { "value": "VA-BCA", "label": "Virtual Account BCA" }
    ],
    "balance": {
      "settled": 480000,
      "pending": 120000,
      "onHold": 0,
      "available": 480000
    },
    "fee": 3000,
    "qrisFee": { "rate": 0.007, "flat": 200 },
    "minWithdrawal": 50000
  }
}

Penjelasan Field Respons

Contoh

curl 'https://mutasiku.co.id/api/v1/gateway' \
  -H 'x-api-key: YOUR_API_KEY'

Membuat Pembayaran Gateway

Sama persis dengan POST /api/v1/payments, hanya walletAccountId yang diisi "GATEWAY".

curl -X POST 'https://mutasiku.co.id/api/v1/payments' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": 100000,
    "walletAccountId": "GATEWAY",
    "orderId": "order-123",
    "redirectUrl": "https://merchant.com/order/success"
  }'

Metode dipilih pembeli

Perhatikan contoh di atas tidak mengirim type. Untuk gateway ini cara yang dianjurkan: metode dipilih pembeli sendiri di halaman pembayaran, dari daftar yang benar-benar bisa dilayani saat itu.

Responsnya belum punya nominal akhir maupun QR, karena belum ada yang dipilih:

{
  "status": "success",
  "data": {
    "id": "595a196b-191c-4767-818e-a7646dd048e8",
    "amount": 100000,
    "expiresAt": "2026-08-31T10:32:52.268Z",
    "paymentUrl": "https://mutasiku.co.id/pay/TOKEN",
    "type": null,
    "methodSelection": "payer"
  }
}

Arahkan pembeli ke paymentUrl. Begitu mereka memilih metode, server menentukan akun penampung, kode unik, dan QR-nya. Anda tahu hasil akhirnya lewat Webhooks event payment.completed, atau dengan polling status pembayaran.

Menentukan metode sendiri

Kirim type kalau Anda memang ingin mengunci satu metode. Responsnya lengkap seperti pembayaran biasa — termasuk totalAmount, accountNumber, dan qrisImage.

curl -X POST 'https://mutasiku.co.id/api/v1/payments' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": 100000,
    "walletAccountId": "GATEWAY",
    "orderId": "order-123",
    "type": "QRIS-DYNAMIC"
  }'

Biaya

Biaya hanya berlaku untuk pembayaran gateway. Kalau Anda memakai akun sendiri, tidak ada biaya gateway sama sekali.

Siapa yang menanggung

Diatur di dashboard → Payment Gateway → Pengaturan → Biaya, dan terbaca di access.feeToCustomer.

Ditanggung merchant (feeToCustomer: false, default) — pembeli membayar persis nominal yang Anda minta, biaya dipotong dari saldo Anda:

amount      : 100.000   ← yang Anda kirim, dan yang dibayar pembeli
biaya QRIS  :     900
saldo masuk :  99.100

Dibebankan ke pembeli (feeToCustomer: true) — tagihan dinaikkan sebesar biaya, saldo Anda bertambah persis sebesar nominal yang Anda minta:

amount      : 100.000   ← yang Anda kirim
tagihan     : 100.906   ← yang dibayar pembeli, muncul di field `amount` respons
biaya QRIS  :     906
saldo masuk : 100.000

Kenaikannya bukan sekadar nominal + biaya: biaya QRIS dihitung dari total yang ditagihkan, sementara total itu sudah termasuk biaya. Server menaikkan sampai bagian Anda utuh — untuk Rp 1.000.000 kenaikannya Rp 7.251, bukan Rp 7.200.

Karena tiap metode punya biaya berbeda, tagihan akhir baru pasti setelah pembeli memilih metode. Halaman pembayaran menampilkan total per metode sebelum pembeli menentukan pilihannya.

Saldo dan Pencairan

Uang dari pembayaran gateway tidak langsung bisa ditarik. Alurnya:

Errors