Louvin API Documentation

Louvin API memungkinkan Anda menerima pembayaran digital (QRIS, GoPay, ShopeePay, Virtual Account) tanpa memerlukan identitas bisnis. Semua request menggunakan JSON melalui HTTPS.

Base URL: https://api.louvin.dev

Version: v1.0

Overview

Quick Start

1. Buat Project di Dashboard — Masuk ke Dashboard → Proyek → Buat Proyek. Anda akan mendapat API key yang dimulai dengan lv_.
2. Buat Transaksi

   const res = await fetch("https://api.louvin.dev/create-transaction", {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
       "x-api-key": "lv_your_api_key_here"
     },
     body: JSON.stringify({
       amount: 50000,
       payment_type: "qris",
       customer_name: "John Doe"
     })
   });
   
   const data = await res.json();
   // data.payment.qr_string → tampilkan sebagai QR code
   // data.payment.va_number → tampilkan nomor VA ke customer

3. Terima Notifikasi — Set Webhook URL di pengaturan proyek. Louvin akan kirim HTTP POST setiap kali status transaksi berubah.

Louvin SDK

SDK JavaScript ringan untuk integrasi cepat. Tanpa dependency, bekerja di browser dan Node.js.

Instalasi

<!-- CDN -->
<script src="https://louvin.dev/sdk/louvin.min.js"></script>

<!-- ES Module -->
<script type="module">
  import { Louvin } from 'https://louvin.dev/sdk/louvin.js';
</script>

Buat Pembayaran

const louvin = new Louvin('lv_your_api_key');

const result = await louvin.createPayment({
  amount: 50000,
  payment_type: 'qris',
  customer_name: 'John Doe',
  description: 'Order #123'
});

console.log(result.payment.qr_string);
console.log(result.transaction.id);

Shortcut Methods

await louvin.createQRIS(50000, { customer_name: 'John' });
await louvin.createBNI(100000);
await louvin.createBRI(100000);
await louvin.createPermata(100000);
await louvin.createCIMB(100000);

Cek Status & Polling

const status = await louvin.checkStatus('transaction-uuid');
console.log(status.transaction.status); // 'pending' | 'settled' | 'failed'

const final = await louvin.waitForPayment('transaction-uuid', {
  interval: 3000,
  timeout: 600000,
  onStatusChange: (data) => console.log('Status:', data.transaction.status)
});

Authentication

Setiap request harus menyertakan API key di header. API key didapat dari Dashboard → Proyek → Detail Proyek.

curl -X POST https://api.louvin.dev/create-transaction \
  -H "Content-Type: application/json" \
  -H "x-api-key: lv_your_api_key_here" \
  -d '{"amount": 50000, "payment_type": "qris"}'

Biaya Transaksi

Fee dihitung otomatis. Tidak ada biaya bulanan atau biaya setup.

Contoh Perhitungan

Jika fee_on_customer aktif (default), fee ditambahkan ke total yang dibayar customer. Merchant menerima penuh net_amount.

Create Transaction

POST /create-transaction

Request Body

Contoh Request

const response = await fetch("https://api.louvin.dev/create-transaction", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "lv_your_api_key_here"
  },
  body: JSON.stringify({
    amount: 50000,
    payment_type: "qris",
    customer_name: "John Doe",
    customer_email: "john@example.com",
    description: "Pembelian Produk A"
  })
});

const data = await response.json();

Response — QRIS (201 Created)

{
  "success": true,
  "transaction": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "amount": 50750,
    "fee": 750,
    "net_amount": 50000,
    "status": "pending",
    "reference": "550e8400-1711234567890-a1b2c3",
    "fee_on_customer": true,
    "created_at": "2026-03-09T10:30:00Z"
  },
  "payment": {
    "order_id": "550e8400-1711234567890-a1b2c3",
    "payment_type": "qris",
    "qr_string": "00020101021226...",
    "payment_number": "00020101021226...",
    "expired_at": "2026-03-09T10:45:00Z",
    "total_payment": 50750
  }
}

Response — Virtual Account

{
  "success": true,
  "transaction": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "amount": 106500,
    "fee": 6500,
    "net_amount": 100000,
    "status": "pending",
    "reference": "550e8400-1711234567890-x1y2z3",
    "fee_on_customer": true,
    "created_at": "2026-03-09T10:30:00Z"
  },
  "payment": {
    "order_id": "550e8400-1711234567890-x1y2z3",
    "payment_type": "bni_va",
    "va_number": "8810123456789012",
    "bank": "bni",
    "payment_number": "8810123456789012",
    "expired_at": "2026-03-10T10:30:00Z",
    "total_payment": 106500
  }
}

Check Status

GET /check-status?id=TRANSACTION_ID

Cek status pembayaran. Juga mendukung POST dengan body {"id": "..."}.

Response

{
  "success": true,
  "transaction": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "settled",
    "amount": 50750,
    "fee": 750,
    "net_amount": 50000,
    "reference": "550e8400-1711234567890-a1b2c3",
    "created_at": "2026-03-09T10:30:00Z",
    "updated_at": "2026-03-09T10:35:00Z"
  }
}

Payment Types

Status Flow

Setiap transaksi memiliki siklus: pending → settled atau pending → failed

Webhooks

Jika proyek memiliki Webhook URL, Louvin akan mengirim HTTP POST setiap kali status transaksi berubah.

Webhook Payload

{
  "event": "payment.settled",
  "data": {
    "transaction_id": "550e8400-e29b-41d4-a716-446655440000",
    "gateway_transaction_id": "gateway-uuid",
    "project_id": "project-uuid",
    "order_id": "550e8400-1711234567890-a1b2c3",
    "amount": 50750,
    "fee": 750,
    "net_amount": 50000,
    "payment_type": "qris",
    "status": "settled",
    "customer_name": "John Doe",
    "customer_email": "john@example.com"
  }
}

Event Types

Contoh Handler (Express.js)

app.post('/webhook/louvin', (req, res) => {
  const { event, data } = req.body;

  if (event === 'payment.settled') {
    console.log('Pembayaran berhasil:', data.order_id);
    console.log('Jumlah diterima:', data.net_amount);
  }

  if (event === 'payment.failed') {
    console.log('Pembayaran gagal:', data.order_id);
  }

  // PENTING: selalu return 200
  res.status(200).json({ received: true });
});

Error Handling

Semua error dikembalikan dalam format JSON dengan field error dan opsional details.

Contoh Error Response

{
  "error": "Invalid amount. Must be a positive number."
}

// Dengan detail dari payment gateway:
{
  "error": "Payment gateway error",
  "gateway_status_code": "406",
  "details": "Order ID has been utilized."
}

Louvin Payment Gateway — louvin.dev — API v1.0