Pakasir Payment Gateway

SDK TypeScript ringan untuk integrasi pembayaran digital Indonesia pakasir.com. Dukung QRIS, Virtual Account multi-bank & PayPal dalam hitungan menit.

Installation · Quick Start · Configuration · Payment Methods · API Reference

📦 Installation

Install pakasir-sdk using your preferred package manager:

npm install pakasir-sdk
# or
pnpm add pakasir-sdk
# or
bun add pakasir-sdk

⚡ Quick Start

Here is a minimal example to create a payment:

import { Pakasir } from 'pakasir-sdk';

const pakasir = new Pakasir({
  slug: 'your-slug',
  apikey: 'your-api-key',
});

const result = await pakasir.createPayment('qris', 'your-order-id', 10000);

console.log(result);

🛠️ Configuration

The Pakasir constructor accepts a configuration object:

| Option | Type | Description | | :------- | :------- | :---------------------------------------------------------- | | slug | string | Required. Project slug. | | apikey | string | Required. API key. |

💰 Payment Methods

For more information about payment methods, please visit Pakasir Biaya.

| Method | Code | Fee | | -------------- | ---------------- | ---------------- | | All Methods | all | Varies | | QRIS | qris | 0.7% - 1% | | PayPal | paypal | 1% (min Rp3.000) | | BNI VA | bni_va | Rp3.500 | | BRI VA | bri_va | Rp3.500 | | CIMB Niaga VA | cimb_niaga_va | Rp3.500 | | Maybank VA | maybank_va | Rp3.500 | | Permata VA | permata_va | Rp3.500 | | BNC VA | bnc_va | Rp3.500 | | ATM Bersama VA | atm_bersama_va | Rp3.500 | | Sampoerna VA | sampoerna_va | Rp2.000 | | Artha Graha VA | artha_graha_va | Rp2.000 |

📖 API Reference

Quick Jump: Create Payment · Get Payment URL · Detail Payment · Cancel Payment · Simulation Payment · Watch Payment · Stop Watch

Create Payment

Create a new payment transaction via API.

const payment = await pakasir.createPayment('qris', 'ORDER-12345', 100_000, 'https://example.com/success');

console.log(payment);

| Parameter | Type | Description | | :------------- | :-------------- | :------------------------------------------------------- | | method | PaymentMethod | Payment method code Payment Methods | | order_id | string | Unique order ID (min 5 characters) | | amount | number | Amount in Rupiah (min Rp500) | | redirect_url | string? | Optional redirect URL after payment |

Get Payment URL

Generate payment URL without API call. Useful for client-side redirects.

const payment = pakasir.getPaymentUrl('qris', 'ORDER-12345', 100_000);

console.log(payment);

Detail Payment

Retrieve current status of a payment.

const detail = await pakasir.detailPayment('ORDER-12345', 100_000);

console.log(detail);

Cancel Payment

Cancel an existing pending payment.

const canceled = await pakasir.cancelPayment('ORDER-12345', 100_000);

console.log(canceled);

Simulation Payment

Simulate a successful payment for testing purposes.

const simulated = await pakasir.simulationPayment('ORDER-12345', 100_000);

console.log(simulated);

Watch Payment

Monitor payment status changes in real-time with polling.

pakasir.watchPayment('ORDER-12345', 100_000, {
  interval: 3000,
  timeout: 600000,

  onStatusChange: (payment) => {
    console.log('Status:', payment);
  },

  onError: (error) => console.error(error),
});

| Option | Type | Default | Description | | :--------------- | :---------------------------------- | :------- | :------------------------------- | | interval | number | 3000 | Polling interval in milliseconds | | timeout | number | 600000 | Auto-stop timeout (10 minutes) | | onStatusChange | (payment: PaymentPayload) => void | - | Callback on status change | | onError | (error: Error) => void | - | Callback on error |

Stop Watch

Manually stop watching a payment.

pakasir.stopWatch('ORDER-12345', 100_000);

PaymentPayload Type

Response type returned by all payment methods:

type PaymentPayload = {
  project: string;
  order_id: string;
  amount: number;
  fee: number;
  status: 'pending' | 'canceled' | 'completed';
  total_payment: number;
  payment_method: string;
  payment_number: string | null;
  payment_url: string | null;
  redirect_url: string | null;
  expired_at: string | Date | null;
  completed_at: string | Date | null;
};

🤝 Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create new branch: git checkout -b feature/my-feature.
3. Commit your changes: git commit -m 'Add some feature'.
4. Push to the branch: git push origin feature/my-feature.
5. Open Pull Request.

🎯 Issues & Feedback

If you encounter any problems or have feature requests, please open an issue

• Buy me coffee ☕
• Ko-Fi
• Trakteer
• ⭐ Star the repo on GitHub

📜 License

Distributed under the MIT License. See LICENSE for details.