API Key

Base URL

Authentication

Semua request API harus menyertakan API Key di header:

X-API-Key: YOUR_API_KEY_HERE

Atau sebagai query parameter:

?apiKey=YOUR_API_KEY_HERE

Cara Kerja OVO Payment

Integrasi OVO memungkinkan Anda menerima pembayaran langsung ke akun OVO Anda dengan pencocokan nominal otomatis.

Langkah Setup

1. Buka menu Pengaturan → Hubungkan OVO
2. Masukkan nomor OVO Anda dan verifikasi dengan kode OTP
3. Masukkan PIN OVO untuk menyelesaikan koneksi
4. Setelah terhubung, Anda dapat membuat pembayaran dengan metode OVO

Cara Kerja Pencocokan

Contoh Request dengan OVO

curl -X POST https://www.bayar.gg/api/create-payment.php \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -d '{
    "amount": 50000,
    "description": "Pembayaran Produk A",
    "payment_method": "ovo"
  }'

Cara Kerja BRI Merchant QRIS

BRI Merchant QRIS memungkinkan Anda menerima pembayaran langsung ke rekening BRI Anda sendiri dengan QRIS merchant Anda.

Keuntungan BRI Merchant QRIS

• Dana langsung ke rekening Anda - Tidak perlu proses withdrawal
• QRIS merchant Anda sendiri - Menggunakan credentials BRI API Anda
• Real-time detection - Pembayaran dideteksi otomatis via BRI API

Langkah Setup

1. Pastikan langganan Anda aktif (trial atau berbayar)
2. Buka menu BRI QRIS Merchant di dashboard
3. Masukkan kredensial BRI API Anda (Host, Username, Password, MID, TID)
4. Test koneksi untuk memastikan API berfungsi
5. Upload gambar QRIS merchant Anda
6. Setelah terhubung, Anda dapat membuat pembayaran dengan metode qris_user

Contoh Request dengan BRI Merchant QRIS

curl -X POST https://www.bayar.gg/api/create-payment.php \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -d '{
    "amount": 50000,
    "description": "Pembayaran Produk A",
    "payment_method": "qris_user"
  }'

Cara Kerja GoPay Merchant QRIS

GoPay Merchant QRIS memungkinkan Anda menerima pembayaran langsung ke akun GoPay Merchant Anda sendiri menggunakan QRIS.

Keuntungan GoPay Merchant QRIS

• Dana langsung ke GoPay Anda - Tidak perlu proses withdrawal
• QRIS GoPay Merchant - Menggunakan akun GoPay Merchant Anda sendiri
• Real-time detection - Pembayaran dideteksi otomatis via GoPay Merchant API
• Tanpa limit nominal - Tidak ada batasan Rp 500.000 seperti QRIS Admin

Langkah Setup

1. Pastikan langganan Anda aktif (trial atau berbayar)
2. Buka menu GoPay Merchant QRIS di dashboard
3. Capture token dari GoPay Merchant App menggunakan HTTP Inspector
4. Paste JSON token + device info di halaman koneksi
5. Upload gambar QRIS GoPay Merchant Anda
6. Setelah terhubung, buat pembayaran dengan metode gopay_qris

Contoh Request dengan GoPay Merchant QRIS

curl -X POST https://www.bayar.gg/api/create-payment.php \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -d '{
    "amount": 50000,
    "description": "Pembayaran Produk A",
    "payment_method": "gopay_qris"
  }'

Response

{
  "success": true,
  "payment": {
    "invoice_id": "PAY-admin-1234567890-ABC123",
    "amount": 50000,
    "unique_code": 347,
    "final_amount": 50347,
    "payment_method": "gopay_qris",
    "status": "pending",
    "expires_at": "2026-02-15 12:30:00"
  },
  "payment_url": "https://www.bayar.gg/pay?invoice=PAY-admin-1234567890-ABC123"
}

Callback

Jika Anda menyertakan callback_url saat membuat pembayaran, sistem akan mengirim POST request ke URL tersebut saat pembayaran berhasil.

Callback Payload

{
  "event": "payment.paid",
  "invoice_id": "PAY-admin-1234567890-ABC123",
  "status": "paid",
  "amount": 50000,
  "final_amount": 50123,
  "unique_code": 123,
  "paid_at": "2024-01-15 12:25:30",
  "paid_amount": 50123,
  "paid_reff_num": "TRX123456789",
  "customer_name": "John Doe",
  "customer_email": "john@example.com",
  "customer_phone": "08123456789",
  "description": "Pembayaran Produk A",
  "redirect_url": "https://yoursite.com/thank-you",
  "has_file": true,
  "has_content": false,
  "timestamp": 1705312530,
  "signature": "sha256_hmac_signature"
}

Callback Headers

Verifikasi Signature

<?php
// Verifikasi callback signature
$payload = json_decode(file_get_contents('php://input'), true);
$signature = $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'] ?? '';
$timestamp = $_SERVER['HTTP_X_WEBHOOK_TIMESTAMP'] ?? '';

// Buat signature untuk verifikasi
$signatureData = $payload['invoice_id'] . '|' . $payload['status'] . '|' . $payload['final_amount'] . '|' . $timestamp;
$expectedSignature = hash_hmac('sha256', $signatureData, 'YOUR_WEBHOOK_SECRET'); // Pengaturan → Webhook

if (hash_equals($expectedSignature, $signature)) {
    // Signature valid, proses callback
    if ($payload['status'] === 'paid') {
        // Update order status
        http_response_code(200);
        echo json_encode(['success' => true]);
    }
} else {
    // Signature tidak valid
    http_response_code(401);
    echo json_encode(['error' => 'Invalid signature']);
}
?>

Webhook Settings

Konfigurasi webhook tersedia di Pengaturan → Webhook:

Telegram Notifications & 2FA

BAYAR GG mendukung notifikasi real-time dan verifikasi 2 langkah melalui Telegram Bot.

Fitur Telegram

Cara Menghubungkan

1. Buka Pengaturan → Telegram
2. Klik Hubungkan Telegram
3. Klik link yang muncul, lalu tekan START di Telegram
4. Aktifkan Notifikasi dan/atau 2FA

Login dengan Facebook

Pengguna dapat mendaftar dan login menggunakan akun Facebook.

Ketentuan

• Akun Facebook akan di-link berdasarkan facebook_id atau email yang cocok.
• Jika username sudah terpakai, sistem otomatis menambah 3 karakter random.
• Akun Facebook tidak memiliki password — menu ubah password disembunyikan.
• Wajib mengisi nomor HP setelah login pertama kali.
• Jika 2FA aktif, OTP tetap diminta via Telegram sebelum masuk dashboard.