Quickstart

Dari login sampai mendeteksi pembayaran pertama, untuk GoPay dan Shopee.

Halaman ini membawa Anda dari nol sampai pembayaran pertama yang terdeteksi. Cara tercepat mencoba adalah lewat CLI; integrasi kode ada di bawahnya.

Setiap langkah di sini memakai API provider live. Pengiriman OTP, discovery, dan rekonsiliasi mengirim request nyata. Gunakan hanya akun merchant milik Anda sendiri.

Jalur CLI (paling cepat)

1. Login

   npx merchantid login gopay
   

   CLI meminta nomor telepon dan OTP, lalu menyimpan sesi ke ~/.merchantid/config.json. Untuk Shopee, npx merchantid login shopee juga meminta password akun.

2. Periksa status

   npx merchantid whoami
   

   Menampilkan provider default, jumlah merchant, dan apakah QRIS statis sudah terikat - semua ter-redaksi.

3. Pilih merchant dan QRIS

   npx merchantid merchants gopay
   npx merchantid set-merchant G000000001 --provider gopay
   

   Untuk Shopee, ikat QRIS statis secara manual dengan npx merchantid set-qris shopee setelah store dipilih.

Lihat Ikhtisar CLI untuk seluruh perintah.

Jalur kode: GoPay

GoPay menemukan QRIS statis dari profil outlet, jadi Anda tidak perlu menyediakannya manual.

import { GopayProvider } from "merchantid";

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

const payments = gopay.payments();
payments.on("paid", (payment) => {
  console.log("lunas", payment.reference, payment.uniqueAmount);
});
payments.on("expired", (payment) => {
  console.log("kedaluwarsa", payment.reference);
});
payments.start();

const payment = await gopay.createPayment({
  amount: 10_000,
  reference: "order-42",
});

console.log(payment.uniqueAmount); // 10001, pembeli harus membayar persis
await displayQrLocally(payment.qrString); // jangan tulis payload QRIS mentah ke log

Untuk mendapatkan sesi pertama kali lewat kode, lihat Login GoPay.

Jalur kode: Shopee

Shopee memakai OTP fetch-only dan QRIS statis manual yang terikat ke store.

import { ShopeeProvider } from "merchantid";

const shopee = new ShopeeProvider({
  session: sessionFromSecretStore,
  staticQris: qrisFromSecretStore.payload,
  staticQrisScope: qrisFromSecretStore.scope,
  onSessionUpdated: async (session) => {
    await saveSecret("shopee-session", session);
  },
});

const payment = await shopee.createPayment({
  amount: 30_000,
  reference: "order-shopee-17",
});

const result = await shopee.payments().tick();
console.log(result.paid, result.expired);

Untuk login OTP dari awal dan binding QRIS, lihat Login Shopee dan Pembayaran Shopee.

Polling vs tick manual

start() memulai timer background. Untuk Worker, Edge, Lambda, atau proses tanpa timer persisten, jangan gunakan start(). Panggil tick() dari scheduler platform:

const { paid, expired } = await gopay.payments().tick();

Satu tick() menjalankan satu putaran rekonsiliasi: menarik feed, menyelesaikan yang cocok, lalu menandai kedaluwarsa yang sudah lewat masa berlaku. Lihat Model pembayaran.

Langkah berikutnya

Konsep inti

Kenapa nominal unik, scope, dan grace window penting.

Model pembayaran

Siklus lengkap create sampai settle/expire.

GoPay Merchant

Login, merchant, dan pembayaran GoPay.

Shopee Merchant

OTP, store, QRIS, dan sesi Shopee.