Ikhtisar CLI

Binary merchantid: login, inspeksi sesi, pemilihan merchant/store, dan binding QRIS untuk semua provider.

MerchantId menyertakan satu binary CLI, merchantid, untuk login, inspeksi sesi, pemilihan merchant/store, dan binding QRIS statis - tanpa menulis kode.

npx merchantid help

Perintah

merchantid login [gopay|shopee]
merchantid session [gopay|shopee]
merchantid session [gopay|shopee] --reveal
merchantid merchants [gopay|shopee]
merchantid stores [gopay|shopee]
merchantid whoami
merchantid set-provider <gopay|shopee>
merchantid set-merchant <merchantId> --provider gopay
merchantid set-store <storeId>
merchantid set-qris [gopay|shopee]

Perintah	Kegunaan
login [provider]	Login OTP interaktif
session [provider]	Tampilkan sesi tersimpan yang ter-mask
session [provider] --reveal	Tampilkan sesi tanpa mask (hanya di terminal privat)
merchants [provider]	Daftar merchant dan outlet/store
stores [provider]	Alias untuk listing outlet/store
whoami	Status ter-redaksi untuk semua provider
set-provider <id>	Set provider default
set-merchant <id>	Set merchant default GoPay (--provider gopay)
set-store <id>	Set store default Shopee
set-qris [provider]	Prompt QRIS statis secara aman

Login

npx merchantid login gopay
npx merchantid login shopee

• GoPay: meminta nomor telepon dan country code, lalu OTP.
• Shopee: meminta nomor internasional dan password (opsional), lalu OTP; bila multi-merchant, menampilkan pilihan merchant usable, lalu pilihan store bila perlu.

Provider pertama yang login menjadi default bila belum ada. Lihat Login GoPay dan Login Shopee.

Inspeksi sesi

npx merchantid session gopay
npx merchantid whoami

session menampilkan sesi tersimpan dengan seluruh kredensial ter-mask secara default. --reveal menampilkan nilai penuh dan hanya boleh dipakai di terminal privat. whoami menampilkan lokasi config dan state ter-redaksi tiap provider (login atau tidak, jumlah merchant, apakah QRIS terikat).

session --reveal mencetak token, cookie, dan switchCredential. Jalankan hanya di terminal privat. Untuk Shopee, switchCredential juga di-mask tanpa --reveal karena dapat mencetak token merchant tanpa OTP kedua.

Binding QRIS

npx merchantid set-qris gopay
npx merchantid set-qris shopee

Memvalidasi checksum dan menjalankan staticToDynamicQris sebelum menyimpan. Untuk Shopee, store harus terpilih lebih dulu; QRIS disimpan bersama owner (staticQrisScope). Lihat Pembayaran Shopee.

Lokasi konfigurasi

Lokasi default adalah ~/.merchantid/config.json. Gunakan env MERCHANTID_CONFIG untuk memilih lokasi lain. File harus mengikuti schema version 1:

{
  "version": 1,
  "defaultProvider": "shopee",
  "providers": {
    "gopay": {
      "session": { "tokens": {}, "deviceId": "..." },
      "merchants": [],
      "defaultMerchantId": "G000000001",
      "staticQris": "000201...",
    },
    "shopee": {
      "session": { "version": 1, "cookies": [], "merchant": {}, "stores": [] },
      "staticQris": "000201...",
      "staticQrisScope": {
        "merchantId": "123456789",
        "storeId": "987654321",
      },
    },
  },
}

File config memuat kredensial dan tidak boleh dikomit. session GoPay memuat access/refresh token; sesi Shopee memuat cookie yang dapat memberi akses merchant. QRIS Shopee juga sensitif dan metadata owner-nya mencegah payload dipakai pada store berbeda. Jangan menyalin konfigurasi asli ke issue. Contoh di atas sengaja tanpa trailing comma: file dibaca dengan JSON.parse, sehingga koma di akhir ditolak.

Debug

Set env MERCHANTID_DEBUG untuk diagnostik umum. Output debug tidak mencetak token, cookie, OTP, atau QRIS - hanya sinyal ada/tidak. Lihat Logging.

Referensi

Lihat Keamanan untuk penanganan kredensial dan Bantuan bila menemui masalah.