Prayana PayGate API Docs

Satu API untuk semua payment gateway Indonesia. Daftar 1x, langsung bisa pake Duitku, Midtrans, iPaymu, dan QRIS.

Getting Started

1. Daftar & Dapatkan API Key

1. Buka halaman registrasi
2. Isi form: nama, email, password
3. Setelah berhasil, Anda langsung mendapatkan API Key

2. Setup HTTP Client

Setiap request memerlukan header x-api-key.

curl -X GET https://paygate.prayana.id/api/v1/health \
  -H "x-api-key: your_platform_api_key"

3. Buat Transaksi Pertama

curl -X POST https://paygate.prayana.id/api/v1/transactions \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -d '{
    "orderId": "TEST-001",
    "gateway": "duitku",
    "amount": 10000,
    "paymentMethod": "BC",
    "customerName": "Test",
    "customerEmail": "test@mail.com"
  }'

4. Setup Webhook

Daftarkan endpoint Anda di dashboard untuk menerima notifikasi real-time.

// Next.js App Router
export async function POST(request: Request) {
  const { event, data } = await request.json()

  if (event === 'payment.success') {
    // Update order status
    await updateOrderStatus(data.orderId, 'PAID')
  }

  return Response.json({ received: true })
}

Authentication

Setiap platform memiliki satu API Key unik. Kirim di header x-api-key setiap request.

Create Transaction

Request Body

{
  "orderId": "INV-001",         // required - unique from your system
  "gateway": "duitku",          // required - "duitku" | "midtrans" | "ipaymu"
  "amount": 100000,             // required - amount without fee
  "fee": 4000,                  // optional - admin fee
  "totalAmount": 104000,        // optional - amount + fee (auto if empty)
  "paymentMethod": "BC",        // required - channel code
  "customerName": "John Doe",   // optional
  "customerEmail": "john@...",  // optional
  "customerPhone": "08123...",  // optional
  "productDetails": "Paket Basic", // optional
  "expiryPeriod": 1440,         // optional - minutes (default 1440 = 24h)
  "metadata": { "orderId": "abc123" } // optional - extra data
}

Response (201 Created)

{
  "data": {
    "id": "clx...",
    "orderId": "INV-001",
    "gateway": "duitku",
    "amount": 100000,
    "totalAmount": 104000,
    "status": "PENDING",
    "paymentUrl": "https://app.duitku.com/payment/REF123",
    "vaNumber": "881234567890",  // Virtual Account (for VA channels)
    "qrString": null,             // QRIS string (for QRIS channels)
    "reference": "REF123456"      // Gateway reference
  }
}

Check Status

POST /api/v1/transactions/{id}/check-status

{
  "data": {
    "status": "SUCCESS",
    "gatewayStatus": "settlement"
  }
}

Webhook

Prayana PayGate mengirim webhook ke URL Anda ketika status transaksi berubah. Daftarkan webhook URL di dashboard > Edit Platform.

Payload

{
  "event": "payment.success",
  "data": {
    "transactionId": "clx...",
    "orderId": "INV-001",
    "gateway": "duitku",
    "amount": 100000,
    "status": "SUCCESS",
    "reference": "REF123456",
    "paidAt": "2024-01-01T12:05:00.000Z"
  }
}

Signature Verification

const crypto = require('crypto')

const body = JSON.stringify(req.body) // raw JSON
const expected = crypto
  .createHmac('sha256', webhookSecret)
  .update(body)
  .digest('hex')

const isValid = (expected === req.headers['x-webhook-signature'])

Payment Channels

QRIS & Unique Code

Sistem kode unik (2/3 digit) ditambahkan ke nominal pembayaran. Ketika user membayar, sistem mencocokkan jumlah yang dibayar dengan kode unik.

Generate QRIS Dinamis

POST /api/v1/qris/generate

{
  "qrisString": "000201010211...",
  "baseAmount": 100000,
  "type": "ORDER",
  "referenceId": "INV-001"
}

{
  "data": {
    "dynamicQrisString": "000201010212...",
    "uniqueAmount": 100523,
    "code": 523,
    "codeFormatted": "523"
  }
}

Generate Kode Unik (tanpa QRIS)

POST /api/v1/unique-codes/generate

{
  "type": "ORDER",
  "referenceId": "INV-001",
  "amount": 100000
}

{
  "data": {
    "code": 523,
    "uniqueAmount": 100523,
    "codeFormatted": "523",
    "note": "Bayar tepat Rp 100.523"
  }
}

Verify Payment

POST /api/v1/unique-codes/verify

{ "amount": 100523 }

{
  "matched": true,
  "data": {
    "code": 523,
    "type": "ORDER",
    "referenceId": "INV-001",
    "amount": 100000,
    "uniqueAmount": 100523
  }
}

Security

Status Codes

Error Handling

Semua error response format: { "error": "deskripsi error" }