GopayProvider

Provider GoPay Merchant (GoBiz): login OTP GoID dua langkah, auto-refresh token, QRIS, dan pembayaran.

GopayProvider mengimplementasikan MerchantProvider<SessionState>. Ia menyatukan HTTP client, AuthClient, MerchantClient, TransactionClient, TokenManager, dan orkestrasi pembayaran di balik satu permukaan.

import { GopayProvider } from "merchantid";

const gopay = new GopayProvider({ merchantId: "G000000001" });

GopayProviderConfig

Opsi	Tipe	Default	Kegunaan
merchantId	string	resolve dari profil	Merchant id (mis. "G000000001"); wajib untuk polling
session	SessionState	-	Restore sesi sebelumnya alih-alih login ulang
staticQris	string	resolve dari profil	QRIS statis outlet untuk turunan QRIS dinamis
clientId	string	bawaan	Override client id GoID
appVersion	string	DEFAULT_APP_VERSION	Override header versi aplikasi
deviceId	string	dari sesi atau acak	Device id stabil
store	PaymentStore	InMemoryPaymentStore	Backend pembayaran durable
payment	lihat di bawah	-	Penyetelan polling dan pembayaran
onTokenRefreshed	(session) => void | Promise<void>	-	Callback persist setelah auto-refresh token
refreshBeforeExpiryMs	number	300000 (5 menit)	Refresh token sekian ms sebelum kedaluwarsa
requestTimeoutMs	number	20000	Timeout request
fetch	FetchLike	globalThis.fetch	Implementasi fetch kustom
logger	Logger	noopLogger	Logger terstruktur

Objek payment menerima pollIntervalMs, defaultExpiryMs, clockSkewMs, transactionPageSize, dan maxUniqueOffset.

Login

requestOtp(phoneNumber: string, countryCode?: string): Promise<LoginRequestResult>
verifyOtp(params: { otp: string; otpToken: string; phoneNumber?: string; countryCode?: string }): Promise<TokenSet>

requestOtp menerima format Indonesia apa pun (62/+62/08/8) dan mengirim nomor subscriber apa adanya plus country code (default INDONESIA_COUNTRY_CODE). verifyOtp menyimpan sesi, meresolusi merchant id, dan meresolusi QRIS statis. Lihat Login GoPay.

Sesi dan token

Metode	Kembalian	Kegunaan
get authenticated	boolean	Ada TokenManager aktif
refreshSession()	Promise<TokenSet>	Paksa refresh via TokenManager (melempar AUTH_REQUIRED bila belum login)
exportSession()	SessionState	Ekspor sesi untuk persist (melempar bila belum login)

TokenManager menyegarkan token otomatis sebelum kedaluwarsa, mengulang request 401 secara transparan, dan menjaga device id stabil. Refresh token tersarang di data pada respons GoID. Lihat Login GoPay.

Merchant dan QRIS

Metode	Kembalian	Kegunaan
resolveMerchantId()	Promise<string | undefined>	Resolve dan cache merchant id dari /v1/users/me
resolveStaticQris(popId?)	Promise<string | undefined>	Resolve QRIS outlet dari profil merchant
listMerchants(limit?)	Promise<StoredMerchant[]>	Enumerasi semua merchant yang dapat diakses (default 200)
getMerchantProfile()	Promise<MerchantProfile>	Profil merchant aktif
get staticQris	string | undefined	QRIS outlet yang teresolusi atau dikonfigurasi
getPaymentScope()	PaymentScope | undefined	{ provider: "gopay", merchantId } bila id ada

Client tingkat rendah auth (AuthClient), merchant (MerchantClient), dan transactions (TransactionClient) diekspos sebagai properti readonly untuk kebutuhan lanjutan. Lihat Merchant GoPay.

Pembayaran

Metode	Kembalian	Kegunaan
payments()	PaymentService	Service pembayaran (lazy; wajib login + merchant id)
createPayment(input)	Promise<Payment>	Shortcut payments().createPayment(input)

Lihat Pembayaran GoPay dan PaymentService.

Client aliased

GopayProvider di-reexport bersama client tingkat rendah ber-prefix: GopayAuthClient, GopayMerchantClient, GopayTransactionClient, GopayLoginService/LoginService, GopayTokenManager, serta GopayHttpClient (HttpClient) dan FetchLike.