@crediblemark/buayar 0.3.2 → 0.4.0

package/docs/razorpay.md

@@ -1,77 +0,0 @@
-# 💳 Integrasi Razorpay (`razorpay`)
-
-Panduan lengkap integrasi Payment Gateway **Razorpay** dengan `@crediblemark/buayar`.
-
----
-
-## ⚙️ Konfigurasi Kredensial
-
-Kredensial Razorpay dapat diperoleh melalui [dashboard.razorpay.com/app/keys](https://dashboard.razorpay.com/app/keys):
-
-```env
-# Menggunakan .env (Direkomendasikan)
-PROVIDER_PG=razorpay
-RAZORPAY_KEY_ID=rzp_test_...
-RAZORPAY_KEY_SECRET=...
-RAZORPAY_WEBHOOK_SECRET=...
-RAZORPAY_SANDBOX=true
-```
-
-Atau inisialisasi manual:
-
-```typescript
-import { Buayar } from "@crediblemark/buayar";
-
-const buayarRzp = new Buayar({
-  provider: "razorpay",
-  clientKey: "rzp_test_...", // Key ID
-  apiKey: "...",             // Key Secret
-  extra: {
-    webhookSecret: "...",
-  },
-  sandbox: true,
-});
-```
-
----
-
-## 🛠️ Membuat Transaksi
-
-### 1. Semi Integrasi (Razorpay Standard Hosted Payment Links)
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-const invoice = await buayar.createInvoice({
-  orderId: "ORDER-RZP-001",
-  amount: 50000, // minor units (500.00 INR)
-  currency: "INR",
-  productDetails: "Online Course Access",
-  customer: {
-    name: "Aarav Sharma",
-    email: "aarav@example.com",
-    phone: "+919876543210",
-  },
-  returnUrl: "https://myapp.com/payment/callback",
-});
-
-if (invoice.success) {
-  console.log("Short Payment Link URL:", invoice.paymentUrl);
-  console.log("Razorpay Link ID:", invoice.reference);
-}
-```
-
-### 2. Full Integrasi (Razorpay Orders API untuk Checkout.js)
-
-```typescript
-const order = await buayar.createInvoice({
-  orderId: "ORDER-RZP-002",
-  amount: 75000,
-  currency: "INR",
-  paymentMethod: "upi", // atau "credit_card"
-  productDetails: "Course Upgrade",
-  customer: { name: "Aarav", email: "aarav@example.com" },
-});
-
-console.log("Razorpay Order ID:", order.reference);
-```

package/docs/square.md

@@ -1,61 +0,0 @@
-# 💳 Integrasi Square (`square`)
-
-Panduan lengkap integrasi Payment Gateway **Square (Payment Links API)** dengan `@crediblemark/buayar`.
-
----
-
-## ⚙️ Konfigurasi Kredensial
-
-Kredensial Square dapat diperoleh melalui [developer.squareup.com/apps](https://developer.squareup.com/apps):
-
-```env
-# Menggunakan .env (Direkomendasikan)
-PROVIDER_PG=square
-SQUARE_ACCESS_TOKEN=EAAA...
-SQUARE_APPLICATION_ID=sq0idp-...
-SQUARE_LOCATION_ID=L...
-SQUARE_WEBHOOK_SIGNATURE_KEY=...
-SQUARE_SANDBOX=true
-```
-
-Atau inisialisasi manual:
-
-```typescript
-import { Buayar } from "@crediblemark/buayar";
-
-const buayarSquare = new Buayar({
-  provider: "square",
-  apiKey: "EAAA...",              // Access Token
-  clientKey: "sq0idp-...",        // Application ID
-  projectId: "L...",              // Location ID
-  extra: {
-    webhookSignatureKey: "...",
-  },
-  sandbox: true,
-});
-```
-
----
-
-## 🛠️ Membuat Transaksi
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-const invoice = await buayar.createInvoice({
-  orderId: "ORDER-SQ-001",
-  amount: 3500, // minor units ($35.00)
-  currency: "USD",
-  productDetails: "Merchandise Coffee Mug",
-  customer: {
-    name: "Michael Scott",
-    email: "michael@example.com",
-  },
-  returnUrl: "https://myapp.com/payment/complete",
-});
-
-if (invoice.success) {
-  console.log("Square Checkout URL:", invoice.paymentUrl);
-  console.log("Payment Link ID:", invoice.reference);
-}
-```

package/docs/stripe.md

@@ -1,103 +0,0 @@
-# 💳 Integrasi Stripe (`stripe`)
-
-Panduan lengkap integrasi Payment Gateway **Stripe** dengan `@crediblemark/buayar`.
-
----
-
-## ⚙️ Konfigurasi Kredensial
-
-Kredensial Stripe dapat diperoleh melalui [dashboard.stripe.com/apikeys](https://dashboard.stripe.com/apikeys):
-
-```env
-# Menggunakan .env (Direkomendasikan)
-PROVIDER_PG=stripe
-STRIPE_SECRET_KEY=sk_test_51...
-STRIPE_PUBLIC_KEY=pk_test_51...
-STRIPE_WEBHOOK_SECRET=whsec_...
-STRIPE_SANDBOX=true
-```
-
-Atau inisialisasi manual:
-
-```typescript
-import { Buayar } from "@crediblemark/buayar";
-
-const buayarStripe = new Buayar({
-  provider: "stripe",
-  apiKey: "sk_test_51...", // Secret Key
-  clientKey: "pk_test_51...", // Publishable Key
-  extra: {
-    webhookSecret: "whsec_...",
-  },
-  sandbox: true,
-});
-```
-
----
-
-## 🛠️ Membuat Transaksi
-
-### 1. Semi Integrasi (Stripe Checkout Session)
-Kosongkan parameter `paymentMethod`:
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-const invoice = await buayar.createInvoice({
-  orderId: "ORDER-STRIPE-001",
-  amount: 250000,
-  currency: "IDR", // Default 'IDR', atau 'USD', 'SGD', dll
-  productDetails: "Pro Subscription",
-  customer: {
-    name: "John Doe",
-    email: "john@example.com",
-  },
-  returnUrl: "https://myapp.com/payment/success",
-});
-
-if (invoice.success) {
-  // Arahkan user ke URL Checkout Stripe
-  console.log("Checkout URL:", invoice.paymentUrl);
-}
-```
-
-### 2. Full Integrasi (Stripe Payment Intent)
-Berikan parameter `paymentMethod` (misal: `credit_card`):
-
-```typescript
-const direct = await buayar.createInvoice({
-  orderId: "ORDER-STRIPE-002",
-  amount: 150000,
-  paymentMethod: "credit_card",
-  productDetails: "Top Up Wallet",
-  customer: { name: "John Doe", email: "john@example.com" },
-});
-
-console.log("Client Secret / Reference:", direct.reference);
-```
-
----
-
-## 🔔 Verifikasi Webhook
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-// Endpoint: POST /api/payment/webhook
-app.post("/api/payment/webhook", async (req, res) => {
-  const payload = req.body;
-  const headers = req.headers;
-
-  const result = await buayar.verifyWebhook(payload, headers);
-
-  if (!result.isValid) {
-    return res.status(400).send("Invalid signature");
-  }
-
-  if (result.isPaid) {
-    console.log(`Pesanan ${result.orderId} terbayar sejumlah ${result.amount}!`);
-  }
-
-  return res.json({ received: true });
-});
-```

package/docs/twocheckout.md

@@ -1,59 +0,0 @@
-# 💳 Integrasi 2Checkout / Verifone (`twocheckout`)
-
-Panduan lengkap integrasi Payment Gateway **2Checkout / Verifone (Orders API v6)** dengan `@crediblemark/buayar`.
-
----
-
-## ⚙️ Konfigurasi Kredensial
-
-Kredensial 2Checkout dapat diperoleh melalui [secure.2checkout.com/cpanel](https://secure.2checkout.com/cpanel):
-
-```env
-# Menggunakan .env (Direkomendasikan)
-PROVIDER_PG=twocheckout
-TWOCHECKOUT_MERCHANT_CODE=...
-TWOCHECKOUT_SECRET_KEY=...
-TWOCHECKOUT_SECRET_WORD=...
-TWOCHECKOUT_SANDBOX=true
-```
-
-Atau inisialisasi manual:
-
-```typescript
-import { Buayar } from "@crediblemark/buayar";
-
-const buayar2Co = new Buayar({
-  provider: "twocheckout",
-  merchantCode: "...", // Merchant Code
-  apiKey: "...",       // Secret Key
-  extra: {
-    secretWord: "...",
-  },
-  sandbox: true,
-});
-```
-
----
-
-## 🛠️ Membuat Transaksi
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-const invoice = await buayar.createInvoice({
-  orderId: "ORDER-2CO-001",
-  amount: 4900, // minor units ($49.00)
-  currency: "USD",
-  productDetails: "SaaS Monthly License",
-  customer: {
-    name: "Tony Stark",
-    email: "tony@example.com",
-  },
-  returnUrl: "https://myapp.com/payment/complete",
-});
-
-if (invoice.success) {
-  console.log("Hosted Checkout Link:", invoice.paymentUrl);
-  console.log("2Checkout Reference:", invoice.reference);
-}
-```

package/docs/xendit.md

@@ -1,112 +0,0 @@
-# 💳 Integrasi Xendit (`xendit`)
-
-Panduan lengkap integrasi Payment Gateway **Xendit** dengan `@crediblemark/buayar`.
-
----
-
-## ⚙️ Konfigurasi Kredensial
-
-Kredensial Xendit berupa **Secret API Key** yang dapat diambil melalui menu **Settings > API Keys** pada dashboard [dashboard.xendit.co](https://dashboard.xendit.co):
-
-```env
-# Menggunakan .env (Direkomendasikan)
-PROVIDER_PG=xendit
-XENDIT_SECRET_KEY=xnd_development_xxxxxxxxxxxxxxxxxxxxxxxx
-XENDIT_WEBHOOK_TOKEN=your_webhook_verification_token
-```
-
-Atau inisialisasi manual:
-
-```typescript
-import { Buayar } from "@crediblemark/buayar";
-
-const buayarXendit = new Buayar({
-  provider: "xendit",
-  apiKey: "xnd_development_xxxxxxxxxxxxxxxxxxxxxxxx",
-});
-```
-
----
-
-## 🛠️ Membuat Transaksi
-
-### 1. Semi Integrasi (Invoice Checkout / Redirect)
-Kosongkan parameter `paymentMethod`:
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-const invoice = await buayar.createInvoice({
-  orderId: "ORDER-XND-001",
-  amount: 250000,
-  productDetails: "Langganan Premium Pro 1 Bulan",
-  customer: {
-    name: "Budi Santoso",
-    email: "budi@example.com",
-    phone: "081234567890",
-  },
-  returnUrl: "https://myapp.com/payment/finish",
-});
-
-if (invoice.success) {
-  // Arahkan user ke halaman checkout Xendit
-  console.log("Invoice URL:", invoice.paymentUrl);
-}
-```
-
-### 2. Full Integrasi (Direct VA / QRIS / E-Wallet / Retail)
-Berikan parameter `paymentMethod` (misal: `bca_va`, `mandiri_va`, `bri_va`, `qris`, `gopay`, `shopeepay`, `alfamart`):
-
-```typescript
-// Direct Virtual Account (Payment Requests API v3)
-const va = await buayar.createInvoice({
-  orderId: "ORDER-XND-002",
-  amount: 150000,
-  paymentMethod: "bca_va",
-  productDetails: "Top Up Wallet",
-  customer: { name: "Budi", email: "budi@example.com" },
-});
-
-console.log("Nomor VA BCA:", va.vaNumber);
-console.log("Expired At:", va.expiresAt);
-
-// Direct QRIS
-const qris = await buayar.createInvoice({
-  orderId: "ORDER-XND-003",
-  amount: 50000,
-  paymentMethod: "qris",
-  productDetails: "Menu Makan Siang",
-  customer: { name: "Budi", email: "budi@example.com" },
-});
-
-console.log("Raw QRIS (EMVCo):", qris.qrString);
-console.log("QR Image:", qris.qrCodeUrl);
-```
-
----
-
-## 🏦 Ekstensi `XenditClient` (Cek Saldo, Expire Invoice, Payout)
-
-```typescript
-import { buayar } from "@crediblemark/buayar";
-
-const xenditClient = buayar.getXenditClient();
-
-// 1. Cek Saldo Merchant
-const balance = await xenditClient.checkBalance("CASH");
-console.log("Saldo Merchant:", balance.balance);
-
-// 2. Memaksa Invoice Expired
-await xenditClient.expireInvoice("inv_67890");
-
-// 3. Eksekusi Transfer Dana / Payout (Disbursement)
-const disbursement = await xenditClient.createDisbursement({
-  externalId: "DISB-001",
-  bankCode: "BCA",
-  accountHolderName: "BUDI SANTOSO",
-  accountNumber: "1234567890",
-  description: "Penarikan Dana Affiliate",
-  amount: 500000,
-});
-console.log("Status Transfer:", disbursement);
-```