Instalasi

Pasang MerchantId, verifikasi runtime, dan pahami format paket ESM/CommonJS.

Memasang paket

npm install merchantid

MerchantId tidak memiliki dependency runtime dan memakai fetch global. Node.js 18 atau runtime lain dengan Web Fetch API dapat menjalankan library.

Nama paket dan binary CLI adalah merchantid. Versi 0.1.0 sempat dipublikasikan dengan nama merchid; sejak 0.1.1 paket bernama merchantid. Jika Anda pernah memakai merchid, pasang ulang dengan npm install merchantid dan ganti perintah CLI dari merchid ke merchantid.

Impor

MerchantId adalah paket ESM dengan build CommonJS pendamping dan deklarasi tipe untuk keduanya.

ESM

import { MerchantId, GopayProvider, ShopeeProvider } from "merchantid";

Seluruh API publik diekspor dari entry tunggal merchantid. Tidak ada subpath import lain selain merchantid/package.json. Lihat Referensi API untuk daftar lengkap ekspor.

Verifikasi runtime

Library membutuhkan fetch global. Node.js 18+ menyediakannya. Untuk runtime tanpa fetch global, atau untuk memakai client yang dipooling/diproxy, injeksikan implementasi sendiri lewat opsi fetch pada provider:

import { GopayProvider } from "merchantid";
import { fetch as undiciFetch } from "undici";

const gopay = new GopayProvider({
  fetch: undiciFetch as typeof fetch,
});

Tanpa fetch global dan tanpa fetch kustom, konstruksi provider melempar ConfigError dengan pesan yang meminta upgrade Node atau injeksi implementasi.

Kompatibilitas runtime

Runtime	Status	Pola rekonsiliasi
Node.js 18+	Diuji di CI	start() atau scheduler dengan tick()
Cloudflare Workers	Belum diuji	Cron/Alarm memanggil tick()
Vercel Edge, Deno, Bun	Belum diuji	Scheduler platform memanggil tick()
Browser	Tidak dianjurkan	Jangan tempatkan kredensial merchant di client

CI menjalankan Node 18 dan 24 di Linux serta Node 24 di Windows. Core dan API publik tidak mengimpor satu pun Node builtin: kriptografi memakai globalThis.crypto dengan fallback, dan node:fs, node:os, node:path, serta node:readline/promises hanya dipakai CLI. Lihat Dukungan runtime.

Langkah berikutnya

Quickstart

Login, buat pembayaran, deteksi settlement.

CLI

Login dan kelola sesi tanpa menulis kode.