GoPay Merchant - MerchantId

GopayProvider adalah adapter untuk GoPay Merchant / GoBiz. Ia menangani OTP GoID, refresh token otomatis pada 401, discovery merchant dan outlet, resolusi QRIS statis dari profil outlet, serta feed transaksi offset-based.

Karakteristik

OTP GoID dua langkah: request OTP, lalu verifikasi untuk mendapatkan access/refresh token.
Refresh otomatis: token disegarkan sebelum kedaluwarsa (buffer 5 menit) dan pada 401 request diretry sekali dengan token baru.
QRIS otomatis: payload QRIS statis ditemukan dari pops[].gopay.aspi_qr_string profil merchant. Anda dapat juga menyediakannya manual.
Feed offset: merchant-analytics/v2 dipaginasi berbasis offset dengan page size di-clamp ke 100.

Konstruksi

import { GopayProvider } from "merchantid";

const gopay = new GopayProvider({
  merchantId: "G000000001",
  session: sessionFromSecretStore,
  onTokenRefreshed: async (session) => {
    await saveSecret("gopay-session", session);
  },
});

Opsi utama config:

Opsi	Kegunaan
`merchantId`	Merchant id (mis. `"G000000001"`); wajib untuk polling transaksi
`session`	Pulihkan sesi sebelumnya alih-alih login lagi
`staticQris`	Payload QRIS statis; bila kosong, ditemukan dari profil outlet
`onTokenRefreshed`	Callback persistence setelah refresh token otomatis
`store`	`PaymentStore` kustom; default in-memory
`payment`	Tuning polling/pembayaran (lihat Model pembayaran)
`fetch`	Implementasi fetch kustom untuk runtime tanpa `fetch` global
`logger`	`Logger` kustom

Lihat Referensi API GopayProvider untuk seluruh opsi.

Token dan sesi

GopayProvider mengelola siklus token secara transparan lewat TokenManager:

Token disegarkan proaktif sebelum kedaluwarsa (buffer default 5 menit).
Request yang menerima 401 diretry sekali setelah force-refresh.
Refresh token yang berotasi diadopsi dan dipersist lewat onTokenRefreshed sebelum menjadi sesi in-memory aktif.
Device id stabil dipertahankan lintas sesi untuk header x-uniqueid yang konsisten.

Access token GoPay berbentuk JWE yang klaim exp-nya tidak dapat dibaca, dan respons refresh tidak selalu menyediakan expires_in. TokenManager memakai fallback 30 menit sebagai perkiraan konservatif. Refresh token wajib dikirim tersarang di objek data; bentuk flat ditolak 401 generik. Lihat Login GoPay.

Halaman GoPay

Login

OTP GoID dan refresh token.

Merchant

Discovery merchant dan outlet.

Pembayaran

Buat dan pantau pembayaran.

​Karakteristik

​Konstruksi

​Token dan sesi

​Halaman GoPay

Login

Merchant

Pembayaran

Karakteristik

Konstruksi

Token dan sesi

Halaman GoPay