@crediblemark/buayar 0.3.2 → 0.5.1

package/docs/ipaymu.md

@@ -1,106 +0,0 @@
-# 💳 Integrasi iPaymu (`ipaymu`)
-
-Panduan lengkap integrasi Payment Gateway **iPaymu** v2 dengan `@crediblemark/buayar`.
-
----
-
-## ⚙️ Konfigurasi Kredensial
-
-Kredensial iPaymu dapat diperoleh melalui menu **Integrasi** pada dashboard [my.ipaymu.com](https://my.ipaymu.com):
-
-```env
-# Menggunakan .env (Direkomendasikan)
-PROVIDER_PG=ipaymu
-IPAYMU_VA=0000001411234567
-IPAYMU_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-IPAYMU_SANDBOX=true
-```
-
-Atau passing konfigurasi manual:
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-const buayarIpaymu = new Buayar({
-  provider: "ipaymu",
-  merchantCode: "0000001411234567", // Nomor VA iPaymu
-  apiKey: "xxxxxxxxxxxxxxxx",
-  sandbox: true,
-});
-```
-
----
-
-## 🛠️ Membuat Transaksi
-
-### 1. Semi Integrasi (Redirect Checkout)
-Kosongkan parameter `paymentMethod`:
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-const invoice = await buayar.createInvoice({
-  orderId: "ORDER-IPAYMU-001",
-  amount: 150000,
-  productDetails: "Pembelian Domain & Hosting",
-  customer: {
-    name: "Budi Santoso",
-    email: "budi@example.com",
-    phone: "081234567890",
-  },
-  returnUrl: "https://myapp.com/payment/finish",
-});
-
-if (invoice.success) {
-  // Arahkan pelanggan ke URL Checkout iPaymu
-  console.log("Redirect URL:", invoice.paymentUrl);
-}
-```
-
-### 2. Full Integrasi (Direct VA / QRIS / Retail)
-Berikan parameter `paymentMethod` (misal: `bca_va`, `mandiri_va`, `qris`, `alfamart`, `indomaret`):
-
-```typescript
-// Direct Virtual Account
-const vaInvoice = await buayar.createInvoice({
-  orderId: "ORDER-IPAYMU-002",
-  amount: 100000,
-  paymentMethod: "bca_va", // Canonical ID
-  productDetails: "Top Up Game",
-  customer: { name: "Budi", email: "budi@example.com", phone: "081234567890" },
-});
-
-console.log("Nomor VA:", vaInvoice.vaNumber);
-console.log("Bank:", vaInvoice.vaBank);
-console.log("Expired At:", vaInvoice.expiresAt);
-
-// Direct QRIS
-const qrisInvoice = await buayar.createInvoice({
-  orderId: "ORDER-IPAYMU-003",
-  amount: 50000,
-  paymentMethod: "qris",
-  productDetails: "Kopi Kenangan",
-  customer: { name: "Budi", email: "budi@example.com" },
-});
-
-console.log("Raw QRIS String (EMVCo):", qrisInvoice.qrString);
-console.log("QR Image URL:", qrisInvoice.qrCodeUrl);
-```
-
----
-
-## 🏦 Ekstensi `IpaymuClient` (Cek Saldo & Detail Transaksi)
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-const ipaymuClient = buayar.getIpaymuClient();
-
-// Cek Saldo Merchant
-const balance = await ipaymuClient.checkBalance();
-console.log("Saldo iPaymu:", balance.balance);
-
-// Cek Detail Transaksi
-const tx = await ipaymuClient.checkTransaction("123456");
-console.log("Detail Transaksi:", tx);
-```

package/docs/midtrans.md

@@ -1,207 +0,0 @@
-# 💳 Integrasi Midtrans (`midtrans`)
-
-Halaman ini berisi panduan lengkap untuk menggunakan provider **Midtrans** dengan `@crediblemark/buayar`.
-
----
-
-## ⚙️ Konfigurasi Kredensial
-Untuk menggunakan provider Midtrans, Anda perlu menyiapkan objek konfigurasi berikut:
-
-```typescript
-const providerConfig = {
-  merchantCode: "",              // Boleh kosong / diisi string kosong untuk Midtrans
-  apiKey: "SB-Mid-server-xxxx",  // Server Key Midtrans Anda
-  sandbox: true,                 // Set true untuk Sandbox, false untuk Production
-};
-```
-
----
-
-## 🛠️ Membuat Transaksi (Invoice)
-
-### 1. Mode Snap API (Halaman Pembayaran Midtrans / Redirect)
-Jika Anda ingin menggunakan halaman Snap Midtrans yang telah disediakan untuk menyelesaikan transaksi pelanggan:
-
-```typescript
-import { paymentManager } from "@crediblemark/buayar";
-
-const invoiceParams = {
-  orderId: "ORDER-200350",
-  amount: 250000,                // Nominal dalam Rupiah (integer)
-  productDetails: "Pembelian Lisensi Software Premium",
-  customer: {
-    name: "Rasyiqi Crediblemark",
-    email: "rasyiqi@crediblemark.com",
-    phone: "081234567890",
-  },
-  returnUrl: "https://situsbisnis.com/payment/success",
-  callbackUrl: "https://api.situsbisnis.com/v1/payment/callback",
-};
-
-async function checkoutSnap() {
-  try {
-    const result = await paymentManager.createInvoice(
-      "midtrans",
-      invoiceParams,
-      providerConfig
-    );
-
-    if (result.success) {
-      console.log("Invoice Snap Berhasil Dibuat! 🎉");
-      console.log("Redirect URL:", result.paymentUrl); // Redirect pelanggan ke URL ini
-      console.log("Snap Token:", result.reference);
-    } else {
-      console.error("Gagal membuat invoice Snap:", result.error);
-    }
-  } catch (error) {
-    console.error("Error:", error);
-  }
-}
-```
-
-### 2. Mode Core API / Direct Charge (Dapatkan VA / QRIS Instan)
-Jika Anda ingin mengambil detail pembayaran secara langsung tanpa memunculkan UI Snap Midtrans, sertakan parameter `paymentMethod`:
-
-```typescript
-const coreParams = {
-  ...invoiceParams,
-  paymentMethod: "bca_va", // Pilihan: bca_va, bni_va, bri_va, mandiri_va, qris, gopay, dll.
-};
-
-async function checkoutDirect() {
-  try {
-    const result = await paymentManager.createInvoice(
-      "midtrans",
-      coreParams,
-      providerConfig
-    );
-
-    if (result.success) {
-      console.log("Nomor VA BCA:", result.vaNumber);
-      console.log("Transaksi Reference ID:", result.reference);
-    } else {
-      console.error("Gagal memproses Direct Charge:", result.error);
-    }
-  } catch (error) {
-    console.error("Error:", error);
-  }
-}
-```
-
-#### Kode `paymentMethod` Core API yang Didukung:
-- **Virtual Account (VA)**: `bca_va`, `bni_va`, `bri_va`, `permata_va`, `cimb_va`, `danamon_va`, `bsi_va`, `seabank_va`, `mandiri_va` (menggunakan echannel).
-- **QRIS & E-Wallet**: `qris`, `gopay`, `shopeepay`, `ovo` (membutuhkan nomor telepon yang terdaftar pada `customer.phone`), `dana`, `linkaja`.
-- **Retail Outlet**: `alfamart`, `indomaret`.
-- **Kartu Kredit & Google Pay**: `credit_card` (memerlukan `token_id` dari browser client pada `providerParams.credit_card.token_id`), `googlepay`.
-- **Paylater / Cicilan**: `kredivo`, `akulaku`.
-
----
-
-## 🔔 Verifikasi Webhook Callback
-Gunakan fungsi ini di endpoint API notifikasi Midtrans untuk memverifikasi keaslian signature SHA-512:
-
-```typescript
-import { paymentManager } from "@crediblemark/buayar";
-
-async function handleMidtransCallback(req: any, res: any) {
-  const callbackPayload = req.body; // Payload POST dari Midtrans
-
-  try {
-    const verification = await paymentManager.verifyCallback(
-      "midtrans",
-      callbackPayload,
-      providerConfig
-    );
-
-    if (verification.isValid) {
-      console.log(`Signature valid untuk Order ID: ${verification.orderId}`);
-      
-      if (verification.status === "paid") {
-        console.log("Status: PEMBAYARAN LUNAS! ✅");
-        // Update database: Tandai transaksi selesai
-      } else if (verification.status === "failed") {
-        console.log("Status: PEMBAYARAN GAGAL ❌");
-      }
-      
-      res.status(200).json({ status: "OK" });
-    } else {
-      console.warn("Peringatan: Signature callback tidak valid!");
-      res.status(400).send("Invalid Signature");
-    }
-  } catch (error) {
-    console.error("Gagal memproses callback:", error);
-    res.status(500).send("Internal Server Error");
-  }
-}
-```
-
----
-
-## 🔍 Cek Status Transaksi Manual
-```typescript
-async function checkMidtransStatus() {
-  const result = await paymentManager.checkTransaction(
-    "midtrans",
-    { merchantOrderId: "ORDER-200350" },
-    providerConfig
-  );
-
-  if (result.success) {
-    console.log("Status Transaksi:", result.status); // "paid" | "pending" | "failed"
-    console.log("Pesan Status:", result.statusMessage);
-  }
-}
-```
-
----
-
-## ⚡ Fitur Khusus: Midtrans Client (`MidtransClient`)
-
-Jika Anda memerlukan manipulasi transaksi pasca-pembayaran atau fitur-fitur spesifik Midtrans yang tidak masuk ke dalam interface umum SDK, Anda dapat membuat instance `MidtransClient`:
-
-```typescript
-const midtransClient = paymentManager.getMidtransClient(providerConfig);
-```
-
-### 1. Transaksi & Refund
-* **Membatalkan Transaksi**
-  ```typescript
-  await midtransClient.cancelTransaction("ORDER-200350");
-  ```
-* **Melakukan Refund**
-  ```typescript
-  await midtransClient.refundTransaction("ORDER-200350", {
-    amount: 50000,
-    reason: "Pengembalian dana produk cacat",
-  });
-  ```
-* **Mengubah Transaksi Menjadi Kadaluarsa (Force Expire)**
-  ```typescript
-  await midtransClient.expireTransaction("ORDER-200350");
-  ```
-* **Aksi Lainnya**: `approveTransaction(orderId)`, `denyTransaction(orderId)`, `captureTransaction(transactionId, amount)`.
-
-### 2. GoPay Tokenization API
-Digunakan untuk menautkan dan mengelola akun GoPay pengguna di platform Anda:
-- `linkPayAccount(payload)`: Mendaftarkan akun GoPay pengguna.
-- `getPayAccount(accountId)`: Mengambil status tokenisasi akun GoPay.
-- `unbindPayAccount(accountId)`: Memutuskan tautan akun GoPay.
-- `getGoPayPromo(accountId, grossAmount)`: Mengambil promo GoPay yang tersedia untuk akun tersebut.
-
-### 3. Subscription (Recurring) API
-Digunakan untuk layanan berlangganan berkala:
-- `createSubscription(payload)`: Membuat paket langganan baru.
-- `getSubscription(subscriptionId)`: Mengambil status langganan.
-- `updateSubscription(subscriptionId, payload)`: Memperbarui paket langganan.
-- `disableSubscription(subscriptionId)`: Menonaktifkan langganan.
-- `enableSubscription(subscriptionId)`: Mengaktifkan kembali langganan.
-
-### 4. Payment Link API
-- `createPaymentLink(payload)`: Membuat tautan pembayaran instan Midtrans.
-- `getPaymentLink(paymentLinkId)`: Mengambil detail tautan pembayaran.
-- `deletePaymentLink(paymentLinkId)`: Menghapus tautan pembayaran.
-
-### 5. Invoicing & Balance API
-- `createBillingInvoice(payload)`: Membuat e-invoice.
-- `voidBillingInvoice(invoiceId)`: Membatalkan e-invoice.
-- `getBalance()`: Mengambil sisa saldo merchant (Mendukung integrasi IRIS API).

package/docs/nicepay.md

@@ -1,106 +0,0 @@
-# 💳 Integrasi Nicepay (`nicepay`)
-
-Panduan lengkap integrasi Payment Gateway **Nicepay (IONPAY)** dengan `@crediblemark/buayar`.
-
----
-
-## ⚙️ Konfigurasi Kredensial
-
-Kredensial Nicepay dapat diperoleh melalui dashboard [merchant.nicepay.co.id](https://merchant.nicepay.co.id):
-
-```env
-# Menggunakan .env (Direkomendasikan)
-PROVIDER_PG=nicepay
-NICEPAY_IMID=IONPAYTEST
-NICEPAY_KEY=nicepay-merchant-key-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-NICEPAY_SANDBOX=true
-```
-
-Atau inisialisasi manual:
-
-```typescript
-import { Buayar } from "@crediblemark/buayar";
-
-const buayarNicepay = new Buayar({
-  provider: "nicepay",
-  merchantCode: "IONPAYTEST", // iMid
-  apiKey: "nicepay-merchant-key-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", // Merchant Key
-  sandbox: true,
-});
-```
-
----
-
-## 🛠️ Membuat Transaksi
-
-### 1. Semi Integrasi (Order Regist / Hosted Checkout)
-Kosongkan parameter `paymentMethod`:
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-const invoice = await buayar.createInvoice({
-  orderId: "ORDER-NICE-001",
-  amount: 250000,
-  productDetails: "Sepatu Olahraga Running",
-  customer: {
-    name: "Budi Santoso",
-    email: "budi@example.com",
-    phone: "081234567890",
-  },
-  returnUrl: "https://myapp.com/payment/finish",
-});
-
-if (invoice.success) {
-  // Arahkan user ke URL Checkout Nicepay
-  console.log("Payment URL:", invoice.paymentUrl);
-}
-```
-
-### 2. Full Integrasi (Direct VA / QRIS / Retail / E-Wallet)
-Berikan parameter `paymentMethod` (misal: `bca_va`, `mandiri_va`, `bri_va`, `qris`, `alfamart`, `indomaret`, `ovo`, `dana`):
-
-```typescript
-// Direct Virtual Account (oneStepVa.do)
-const va = await buayar.createInvoice({
-  orderId: "ORDER-NICE-002",
-  amount: 150000,
-  paymentMethod: "bca_va",
-  productDetails: "Top Up Saldo",
-  customer: { name: "Budi", email: "budi@example.com" },
-});
-
-console.log("Nomor VA BCA:", va.vaNumber);
-console.log("Bank Code:", va.vaBank);
-console.log("Expired At:", va.expiresAt);
-
-// Direct QRIS (oneStepQris.do)
-const qris = await buayar.createInvoice({
-  orderId: "ORDER-NICE-003",
-  amount: 50000,
-  paymentMethod: "qris",
-  productDetails: "Kopi",
-  customer: { name: "Budi", email: "budi@example.com" },
-});
-
-console.log("Raw QRIS (EMVCo):", qris.qrString);
-console.log("QR Image URL:", qris.qrCodeUrl);
-```
-
----
-
-## 🏦 Ekstensi `NicepayClient` (Inquiry & Cancel)
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-const nicepayClient = buayar.getNicepayClient();
-
-// 1. Cek status transaksi pembayaran
-const status = await nicepayClient.checkTransaction("ORDER-NICE-001", 250000);
-console.log("Status Transaksi:", status);
-
-// 2. Batalkan transaksi
-const cancel = await nicepayClient.cancelTransaction("TX-NICE-123456", "02", "Pembatalan oleh Merchant");
-console.log("Hasil Cancel:", cancel);
-```

package/docs/oy.md

@@ -1,115 +0,0 @@
-# 💳 Integrasi OY! Bisnis (`oy`)
-
-Panduan lengkap integrasi Payment Gateway **OY! Indonesia (OY! Bisnis)** dengan `@crediblemark/buayar`.
-
----
-
-## ⚙️ Konfigurasi Kredensial
-
-Kredensial OY! Bisnis dapat diperoleh melalui dashboard [business.oyindonesia.com](https://business.oyindonesia.com):
-
-```env
-# Menggunakan .env (Direkomendasikan)
-PROVIDER_PG=oy
-OY_USERNAME=myusername
-OY_API_KEY=oy-secret-key-xxxxxxxxxxxxxxxxxxxxxxxx
-OY_SANDBOX=true
-```
-
-Atau inisialisasi manual:
-
-```typescript
-import { Buayar } from "@crediblemark/buayar";
-
-const buayarOy = new Buayar({
-  provider: "oy",
-  merchantCode: "myusername", // OY Username
-  apiKey: "oy-secret-key-xxxxxxxxxxxxxxxxxxxxxxxx", // API Key
-  sandbox: true,
-});
-```
-
----
-
-## 🛠️ Membuat Transaksi
-
-### 1. Semi Integrasi (Payment Checkout Link v2)
-Kosongkan parameter `paymentMethod`:
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-const invoice = await buayar.createInvoice({
-  orderId: "ORDER-OY-001",
-  amount: 250000,
-  productDetails: "Sepatu Olahraga Running",
-  customer: {
-    name: "Budi Santoso",
-    email: "budi@example.com",
-    phone: "081234567890",
-  },
-  returnUrl: "https://myapp.com/payment/finish",
-});
-
-if (invoice.success) {
-  // Arahkan user ke URL Checkout OY! Bisnis
-  console.log("Payment URL:", invoice.paymentUrl);
-}
-```
-
-### 2. Full Integrasi (Direct VA / QRIS)
-Berikan parameter `paymentMethod` (misal: `bca_va`, `mandiri_va`, `bri_va`, `qris`, `alfamart`, `indomaret`):
-
-```typescript
-// Direct Virtual Account (generate-static-va)
-const va = await buayar.createInvoice({
-  orderId: "ORDER-OY-002",
-  amount: 150000,
-  paymentMethod: "bca_va",
-  productDetails: "Top Up Game",
-  customer: { name: "Budi", email: "budi@example.com" },
-});
-
-console.log("Nomor VA BCA:", va.vaNumber);
-console.log("Reference:", va.reference);
-
-// Direct QRIS (qris/create-transaction)
-const qris = await buayar.createInvoice({
-  orderId: "ORDER-OY-003",
-  amount: 50000,
-  paymentMethod: "qris",
-  productDetails: "Kopi",
-  customer: { name: "Budi", email: "budi@example.com" },
-});
-
-console.log("Raw QRIS (EMVCo):", qris.qrString);
-console.log("QR Image URL:", qris.qrCodeUrl);
-```
-
----
-
-## 🏦 Ekstensi `OyClient` (Cek Status, Saldo & Kirim Uang)
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-const oyClient = buayar.getOyClient();
-
-// 1. Cek status pembayaran transaksi
-const status = await oyClient.checkTransaction("ORDER-OY-001");
-console.log("Status Pesanan:", status);
-
-// 2. Cek saldo akun OY! Bisnis
-const balance = await oyClient.checkBalance();
-console.log("Saldo Merchant:", balance);
-
-// 3. Kirim Uang / Transfer Dana (Disbursement / Remittance)
-const remit = await oyClient.remit({
-  recipientBank: "014", // BCA
-  recipientAccount: "1234567890",
-  amount: 500000,
-  note: "Penarikan Dana Mitra",
-  partnerTrxId: "DISB-001",
-});
-console.log("Hasil Transfer:", remit);
-```

package/docs/paypal.md

@@ -1,73 +0,0 @@
-# 💳 Integrasi PayPal (`paypal`)
-
-Panduan lengkap integrasi Payment Gateway **PayPal REST API v2** dengan `@crediblemark/buayar`.
-
----
-
-## ⚙️ Konfigurasi Kredensial
-
-Kredensial PayPal dapat diperoleh melalui [developer.paypal.com/dashboard/applications](https://developer.paypal.com/dashboard/applications):
-
-```env
-# Menggunakan .env (Direkomendasikan)
-PROVIDER_PG=paypal
-PAYPAL_CLIENT_ID=Ae...
-PAYPAL_CLIENT_SECRET=EL...
-PAYPAL_WEBHOOK_ID=...
-PAYPAL_SANDBOX=true
-```
-
-Atau inisialisasi manual:
-
-```typescript
-import { Buayar } from "@crediblemark/buayar";
-
-const buayarPaypal = new Buayar({
-  provider: "paypal",
-  clientKey: "Ae...", // Client ID
-  apiKey: "EL...",    // Client Secret
-  sandbox: true,
-});
-```
-
----
-
-## 🛠️ Membuat Transaksi
-
-### Semi Integrasi (PayPal Hosted Checkout / Orders API)
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-const invoice = await buayar.createInvoice({
-  orderId: "ORDER-PP-001",
-  amount: 2500, // Misal $25.00 (atau dalam satuan mata uang terpilih)
-  currency: "USD",
-  productDetails: "Digital eBook License",
-  customer: {
-    name: "Jane Smith",
-    email: "jane@example.com",
-  },
-  returnUrl: "https://myapp.com/payment/success",
-});
-
-if (invoice.success) {
-  // Arahkan pembeli ke URL pembayaran PayPal
-  console.log("PayPal Approval URL:", invoice.paymentUrl);
-  console.log("PayPal Order ID:", invoice.reference);
-}
-```
-
----
-
-## 🏦 Ekstensi `PaypalClient`
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-const paypalClient = buayar.getPaypalClient();
-
-// Capture pesanan yang telah disetujui pembeli
-const captureResult = await paypalClient.captureOrder("PAYPAL-ORDER-ID");
-console.log("Capture Result:", captureResult);
-```

package/docs/payu.md

@@ -1,61 +0,0 @@
-# 💳 Integrasi PayU (`payu`)
-
-Panduan lengkap integrasi Payment Gateway **PayU (OpenPayU REST API v2.1)** dengan `@crediblemark/buayar`.
-
----
-
-## ⚙️ Konfigurasi Kredensial
-
-Kredensial PayU dapat diperoleh melalui dashboard merchant PayU:
-
-```env
-# Menggunakan .env (Direkomendasikan)
-PROVIDER_PG=payu
-PAYU_POS_ID=300746
-PAYU_MD5_KEY=...
-PAYU_OAUTH_CLIENT_ID=300746
-PAYU_OAUTH_CLIENT_SECRET=...
-PAYU_SANDBOX=true
-```
-
-Atau inisialisasi manual:
-
-```typescript
-import { Buayar } from "@crediblemark/buayar";
-
-const buayarPayu = new Buayar({
-  provider: "payu",
-  merchantCode: "300746", // POS ID
-  apiKey: "...",          // MD5 Key
-  extra: {
-    oauthClientId: "300746",
-    oauthClientSecret: "...",
-  },
-  sandbox: true,
-});
-```
-
----
-
-## 🛠️ Membuat Transaksi
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-const invoice = await buayar.createInvoice({
-  orderId: "ORDER-PAYU-001",
-  amount: 10000, // minor units (100.00 PLN)
-  currency: "PLN",
-  productDetails: "Online Subscription",
-  customer: {
-    name: "Jan Kowalski",
-    email: "jan@example.pl",
-  },
-  returnUrl: "https://myapp.com/payment/summary",
-});
-
-if (invoice.success) {
-  console.log("PayU Redirect URL:", invoice.paymentUrl);
-  console.log("PayU Order ID:", invoice.reference);
-}
-```