Instalasi

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.

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

const { MerchantId, GopayProvider, ShopeeProvider } = require("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.

Pendahuluan

Konsep lintas provider

CLI

Keamanan

Bantuan

Memasang paket

Impor

Verifikasi runtime

Kompatibilitas runtime

Langkah berikutnya

Quickstart

CLI

​Memasang paket

​Impor

​Verifikasi runtime

​Kompatibilitas runtime

​Langkah berikutnya

Quickstart

CLI

Memasang paket

Impor

Verifikasi runtime

Kompatibilitas runtime

Langkah berikutnya