API Documentation

Dokumentasi lengkap REST API untuk integrasi Payment Gateway — QRIS Admin, QRIS BAYAR GG per-merchant, BRI Merchant QRIS, GoPay Merchant QRIS, OVO, dan multi e-wallet.

Lihat Contoh Integrasi di GitHub Panduan Quick Start

Contoh Integrasi GitHub

Repository resmi berisi contoh siap pakai untuk mempercepat integrasi API BAYAR GG ke website atau backend Anda.

Contoh client PHP, Python, dan Node.js
Quick start create payment, check status, dan webhook callback
Referensi endpoint dan panduan verifikasi signature

Buka Repository GitHub

API Key

Info: Login untuk melihat API Key Anda. Contoh di bawah menggunakan placeholder YOUR_API_KEY_HERE.

YOUR_API_KEY_HERE

Penting: Jangan bagikan API Key Anda kepada siapapun. API Key digunakan untuk mengautentikasi request ke API.

Base URL

Semua request API menggunakan base URL berikut:

https://www.bayar.gg/api

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

Payment Endpoints

Method	Endpoint	Description
POST	`/api/create-payment.php`	Membuat pembayaran baru
GET	`/api/check-payment.php`	Cek status pembayaran
GET	`/api/list-payments.php`	Daftar pembayaran dengan filter & pagination

POST /api/create-payment.php

Membuat pembayaran baru dengan opsi produk digital, foto produk, dan redirect URL.

Request Body

Parameter	Type	Required	Description
`amount`	number	Required	Nominal pembayaran (minimal Rp 1.000, maksimal Rp 500.000 untuk QRIS Admin)
`description`	string	Optional	Deskripsi pembayaran
`customer_name`	string	Optional	Nama pelanggan
`customer_email`	string	Optional	Email pelanggan
`customer_phone`	string	Optional	No. HP pelanggan
`callback_url`	string	Optional	URL webhook saat pembayaran sukses
`redirect_url`	string	Optional	URL redirect setelah pembayaran sukses New
`file_id`	number	Optional	ID file digital yang akan diberikan setelah bayar New
`content_id`	number	Optional	ID hidden content yang akan dibuka setelah bayar New
`product_image_id`	number	Optional	ID foto produk yang ditampilkan di halaman pembayaran New
`payment_method`	string	Optional	Metode pembayaran: `qris`, `qris_bayar_gg`, `qris_user`, `gopay_qris`, atau `ovo`. Jika kosong, sistem memilih metode pertama yang tersedia untuk akun.
`use_qris_converter`	boolean	Optional	Aktifkan QRIS Converter untuk BRI/GoPay QRIS statis. Untuk `qris` dan `qris_bayar_gg`, flag ini otomatis diabaikan karena QRIS dinamis dibuat langsung oleh provider InterActive QRIS.

Payment Method:

qris — QRIS (default, maks. Rp 500.000)
qris_bayar_gg — QRIS BAYAR GG per-merchant (wajib Premium aktif + approval admin + mID sudah di-assign + API key provider tersedia). Limit nominal mengikuti limit mID yang diatur admin.
qris_user — BRI QRIS (memerlukan langganan aktif + konfigurasi BRI, tanpa limit)
gopay_qris — GoPay QRIS (memerlukan langganan aktif + akun GoPay Merchant terhubung via OTP, tanpa limit) Recommended
ovo — OVO (memerlukan langganan aktif + akun OVO terhubung)

QRIS Converter:

Aktifkan use_qris_converter: true untuk membuat QRIS dinamis dengan nominal tertanam otomatis.

QRIS string otomatis diambil dari akun yang terhubung sesuai payment_method
gopay_qris → dari GoPay QRIS
qris_user → dari BRI QRIS
qris dan qris_bayar_gg → tidak memakai converter; QRIS dinamis dibuat provider InterActive QRIS dengan nominal tertanam
Tidak perlu kirim qris_string secara manual
Konversi nominal dilakukan otomatis di halaman pembayaran
Response: qris_converter: true

Batasan Nominal QRIS Admin:

Untuk metode pembayaran qris maksimal nominal adalah Rp 500.000. Untuk nominal lebih besar, gunakan qris_bayar_gg, qris_user, atau gopay_qris sesuai akses/koneksi akun. QRIS BAYAR GG mengikuti limit mID yang ditetapkan admin.

Catatan: Gunakan endpoint /api/get-payment-methods untuk mengecek ketersediaan, syarat Premium, grant QRIS BAYAR GG, dan limit nominal per metode.

Code Examples

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_bayar_gg"
  }'

$response = file_get_contents('https://www.bayar.gg/api/create-payment.php', false,
    stream_context_create([
        'http' => [
            'method' => 'POST',
            'header' => "Content-Type: application/json\r\nX-API-Key: YOUR_API_KEY_HERE",
            'content' => json_encode([
                'amount' => 50000,
                'description' => 'Pembayaran Produk A',
                'payment_method' => 'qris_bayar_gg'
            ])
        ]
    ])
);
$data = json_decode($response, true);

const res = await fetch('https://www.bayar.gg/api/create-payment.php', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-API-Key': 'YOUR_API_KEY_HERE'
    },
    body: JSON.stringify({
        amount: 50000,
        description: 'Pembayaran Produk A',
        payment_method: 'qris_bayar_gg'
    })
});
const data = await res.json();

import requests

response = requests.post(
    'https://www.bayar.gg/api/create-payment.php',
    headers={'X-API-Key': 'YOUR_API_KEY_HERE'},
    json={
        'amount': 50000,
        'description': 'Pembayaran Produk A',
        'payment_method': 'qris_bayar_gg'
    }
)
data = response.json()

Example Response

{
  "success": true,
  "data": {
    "invoice_id": "BAYAR-1778029840-86EFB7",
    "amount": 50000,
    "payment_url": "https://www.bayar.gg/pay?invoice=BAYAR-1778029840-86EFB7",
    "expires_at": "2026-04-16 12:30:00",
    "status": "pending",
    "payment_method": "qris_bayar_gg",
    "payment_method_label": "QRIS BAYAR GG",
    "unique_code": 0,
    "final_amount": 50000,
    "qris_string": "0002010102122676...",
    "qris_static_image_url": "https://www.bayar.gg/qris-info/api/qr.php?text=000201...",
    "qris_dynamic_string": "0002010102122676...",
    "qris_dynamic_image_url": "https://www.bayar.gg/qris-info/api/qr.php?text=000201...",
    "iqris_invoiceid": "36556065",
    "iqris_nmid": "ID1020012345678",
    "iqris_request_date": "2026-04-16 12:00:00"
  }
}

GET /api/check-payment.php

Mengecek status pembayaran berdasarkan Invoice ID.

Query Parameters

Parameter	Type	Required	Description
`invoice`	string	Required	Invoice ID pembayaran

Code Examples

curl -X GET "https://www.bayar.gg/api/check-payment.php?invoice=PAY-admin-1234567890-ABC123" \
  -H "X-API-Key: YOUR_API_KEY_HERE"

$invoice = 'PAY-admin-1234567890-ABC123';
$response = file_get_contents(
    'https://www.bayar.gg/api/check-payment.php?invoice=' . urlencode($invoice),
    false,
    stream_context_create([
        'http' => ['header' => "X-API-Key: YOUR_API_KEY_HERE"]
    ])
);
$data = json_decode($response, true);

const invoice = 'PAY-admin-1234567890-ABC123';
const res = await fetch(
    `https://www.bayar.gg/api/check-payment.php?invoice=${invoice}`,
    { headers: { 'X-API-Key': 'YOUR_API_KEY_HERE' } }
);
const data = await res.json();

import requests

response = requests.get(
    'https://www.bayar.gg/api/check-payment.php',
    headers={'X-API-Key': 'YOUR_API_KEY_HERE'},
    params={'invoice': 'PAY-admin-1234567890-ABC123'}
)
data = response.json()

Example Response

{
  "success": true,
  "invoice_id": "PAY-admin-1234567890-ABC123",
  "status": "paid",
  "amount": 50000,
  "final_amount": 50347,
  "payment_method": "gopay_qris",
  "paid_at": "2026-04-16 12:25:30",
  "paid_reff_num": "TRX123456789",
  "expires_at": "2026-04-16 12:30:00"
}

GET /api/list-payments.php

Mendapatkan daftar pembayaran dengan filter, search, dan pagination.

Query Parameters

Parameter	Type	Required	Description
`search`	string	Optional	Cari berdasarkan invoice, deskripsi, nama/email/HP pelanggan New
`status`	string	Optional	Filter by status: pending, paid, expired, cancelled
`payment_method`	string	Optional	Filter by method: qris, qris_bayar_gg, qris_user, gopay_qris, ovo New
`paid_via`	string	Optional	Filter pembayaran sukses by method: qris, qris_user, gopay_qris, ovo New
`start_date`	string	Optional	Filter dari tanggal (YYYY-MM-DD)
`end_date`	string	Optional	Filter sampai tanggal (YYYY-MM-DD)
`page`	number	Optional	Halaman (default: 1)
`limit`	number	Optional	Jumlah per halaman (default: 20, max: 100)

Code Examples

curl -X GET "https://www.bayar.gg/api/list-payments.php?status=paid&page=1&limit=10" \
  -H "X-API-Key: YOUR_API_KEY_HERE"

$response = file_get_contents(
    'https://www.bayar.gg/api/list-payments.php?status=paid&page=1&limit=10',
    false,
    stream_context_create([
        'http' => ['header' => "X-API-Key: YOUR_API_KEY_HERE"]
    ])
);
$data = json_decode($response, true);

const res = await fetch(
    'https://www.bayar.gg/api/list-payments.php?status=paid&page=1&limit=10',
    { headers: { 'X-API-Key': 'YOUR_API_KEY_HERE' } }
);
const data = await res.json();

import requests

response = requests.get(
    'https://www.bayar.gg/api/list-payments.php',
    headers={'X-API-Key': 'YOUR_API_KEY_HERE'},
    params={'status': 'paid', 'page': 1, 'limit': 10}
)
data = response.json()

Example Response

{
  "success": true,
  "data": [
    {
      "invoice_id": "PAY-admin-1234567890-ABC123",
      "amount": 50000,
      "final_amount": 50347,
      "status": "paid",
      "payment_method": "gopay_qris",
      "paid_at": "2026-04-16 12:25:30",
      "created_at": "2026-04-16 12:20:00"
    }
  ],
  "pagination": { "page": 1, "limit": 10, "total": 42, "total_pages": 5 }
}

Account Endpoints

Method	Endpoint	Description
GET	`/api/get-payment-methods.php`	Daftar metode pembayaran & ketersediaan
GET	`/api/get-account-status.php`	Status akun & integrasi
GET	`/api/get-statistics.php`	Statistik pembayaran

GET /api/get-payment-methods.php

Mendapatkan daftar metode pembayaran dan status ketersediaan. Response menyertakan user_status.has_active_subscription, grant QRIS BAYAR GG, dan status koneksi metode pembayaran.

Code Examples

curl -X GET "https://www.bayar.gg/api/get-payment-methods.php" \
  -H "X-API-Key: YOUR_API_KEY_HERE"

$response = file_get_contents(
    'https://www.bayar.gg/api/get-payment-methods.php',
    false,
    stream_context_create([
        'http' => ['header' => "X-API-Key: YOUR_API_KEY_HERE"]
    ])
);
$data = json_decode($response, true);

const res = await fetch(
    'https://www.bayar.gg/api/get-payment-methods.php',
    { headers: { 'X-API-Key': 'YOUR_API_KEY_HERE' } }
);
const data = await res.json();

import requests

response = requests.get(
    'https://www.bayar.gg/api/get-payment-methods.php',
    headers={'X-API-Key': 'YOUR_API_KEY_HERE'}
)
data = response.json()

Example Response

{
  "success": true,
  "data": {
    "payment_methods": [
      {
        "id": "qris",
        "name": "QRIS",
        "description": "Pembayaran via QRIS (Admin)",
        "enabled": true,
        "available": true,
        "requirements": []
      },
      {
        "id": "qris_bayar_gg",
        "name": "QRIS BAYAR GG",
        "description": "Pembayaran via QRIS BAYAR GG (per-user mID di-assign admin)",
        "enabled": true,
        "available": true,
        "subscription_required": true,
        "has_grant": true,
        "has_mid": true,
        "max_amount": 500000,
        "requirements": []
      },
      {
        "id": "gopay_qris",
        "name": "GoPay QRIS",
        "available": false,
        "requirements": ["GoPay Merchant harus terhubung"]
      }
    ],
    "user_status": {
      "has_active_subscription": true,
      "has_qris_bayar_gg_grant": true,
      "has_gopay_connected": false
    },
    "feature_status": {
      "qris": true,
      "qris_bayar_gg": true,
      "qris_user": true,
      "ovo": true,
      "gopay_qris": true
    }
  }
}

GET /api/get-account-status.php

Mendapatkan status akun, integrasi, dan ringkasan statistik.

Code Examples

curl -X GET "https://www.bayar.gg/api/get-account-status.php" \
  -H "X-API-Key: YOUR_API_KEY_HERE"

$response = file_get_contents(
    'https://www.bayar.gg/api/get-account-status.php',
    false,
    stream_context_create([
        'http' => ['header' => "X-API-Key: YOUR_API_KEY_HERE"]
    ])
);
$data = json_decode($response, true);

const res = await fetch(
    'https://www.bayar.gg/api/get-account-status.php',
    { headers: { 'X-API-Key': 'YOUR_API_KEY_HERE' } }
);
const data = await res.json();

import requests

response = requests.get(
    'https://www.bayar.gg/api/get-account-status.php',
    headers={'X-API-Key': 'YOUR_API_KEY_HERE'}
)
data = response.json()

Example Response

{
  "success": true,
  "account": {
    "username": "admin",
    "email": "admin@bayar.gg",
    "is_verified": true
  },
  "integrations": {"gopay": true, "bri": false, "ovo": false}
}

GET /api/get-statistics.php

Mendapatkan statistik pembayaran detail dengan breakdown per metode.

Query Parameters

Parameter	Type	Required	Description
`period`	string	Optional	Periode statistik: `all`, `today`, `week`, `month`, `year` (default: all)

Code Examples

curl -X GET "https://www.bayar.gg/api/get-statistics.php?period=month" \
  -H "X-API-Key: YOUR_API_KEY_HERE"

$response = file_get_contents(
    'https://www.bayar.gg/api/get-statistics.php?period=month',
    false,
    stream_context_create([
        'http' => ['header' => "X-API-Key: YOUR_API_KEY_HERE"]
    ])
);
$data = json_decode($response, true);

const res = await fetch(
    'https://www.bayar.gg/api/get-statistics.php?period=month',
    { headers: { 'X-API-Key': 'YOUR_API_KEY_HERE' } }
);
const data = await res.json();

import requests

response = requests.get(
    'https://www.bayar.gg/api/get-statistics.php',
    headers={'X-API-Key': 'YOUR_API_KEY_HERE'},
    params={'period': 'month'}
)
data = response.json()

Example Response

{
  "success": true,
  "period": "month",
  "total_transactions": 150,
  "total_amount": 7500000,
  "total_paid": 120,
  "breakdown": {"qris": 80, "gopay_qris": 30, "ovo": 10}
}

Digital Products Endpoints

Method	Endpoint	Description
GET	`/api/list-files.php`	Daftar file digital
GET	`/api/list-contents.php`	Daftar hidden content
GET	`/api/list-images.php`	Daftar foto produk

GET /api/list-files.php

Mendapatkan daftar file digital yang sudah diupload.

Query Parameters

Parameter	Type	Required	Description
`active_only`	boolean	Optional	Hanya file aktif (default: true)

Code Examples

curl -X GET "https://www.bayar.gg/api/list-files.php?active_only=true" \
  -H "X-API-Key: YOUR_API_KEY_HERE"

$response = file_get_contents(
    'https://www.bayar.gg/api/list-files.php?active_only=true',
    false,
    stream_context_create([
        'http' => ['header' => "X-API-Key: YOUR_API_KEY_HERE"]
    ])
);
$data = json_decode($response, true);

const res = await fetch(
    'https://www.bayar.gg/api/list-files.php?active_only=true',
    { headers: { 'X-API-Key': 'YOUR_API_KEY_HERE' } }
);
const data = await res.json();

import requests

response = requests.get(
    'https://www.bayar.gg/api/list-files.php',
    headers={'X-API-Key': 'YOUR_API_KEY_HERE'},
    params={'active_only': 'true'}
)
data = response.json()

Example Response

{
  "success": true,
  "data": [
    {"id": 1, "filename": "ebook.pdf", "size": 2048576, "active": true}
  ]
}

GET /api/list-contents.php

Mendapatkan daftar hidden content yang sudah dibuat.

Query Parameters

Parameter	Type	Required	Description
`active_only`	boolean	Optional	Hanya konten aktif (default: true)

Code Examples

curl -X GET "https://www.bayar.gg/api/list-contents.php?active_only=true" \
  -H "X-API-Key: YOUR_API_KEY_HERE"

$response = file_get_contents(
    'https://www.bayar.gg/api/list-contents.php?active_only=true',
    false,
    stream_context_create([
        'http' => ['header' => "X-API-Key: YOUR_API_KEY_HERE"]
    ])
);
$data = json_decode($response, true);

const res = await fetch(
    'https://www.bayar.gg/api/list-contents.php?active_only=true',
    { headers: { 'X-API-Key': 'YOUR_API_KEY_HERE' } }
);
const data = await res.json();

import requests

response = requests.get(
    'https://www.bayar.gg/api/list-contents.php',
    headers={'X-API-Key': 'YOUR_API_KEY_HERE'},
    params={'active_only': 'true'}
)
data = response.json()

Example Response

{
  "success": true,
  "data": [
    {"id": 1, "title": "License Key", "type": "text", "active": true}
  ]
}

GET /api/list-images.php

Mendapatkan daftar foto produk yang sudah diupload.

Query Parameters

Parameter	Type	Required	Description
`active_only`	boolean	Optional	Hanya gambar aktif (default: true)

Code Examples

curl -X GET "https://www.bayar.gg/api/list-images.php?active_only=true" \
  -H "X-API-Key: YOUR_API_KEY_HERE"

$response = file_get_contents(
    'https://www.bayar.gg/api/list-images.php?active_only=true',
    false,
    stream_context_create([
        'http' => ['header' => "X-API-Key: YOUR_API_KEY_HERE"]
    ])
);
$data = json_decode($response, true);

const res = await fetch(
    'https://www.bayar.gg/api/list-images.php?active_only=true',
    { headers: { 'X-API-Key': 'YOUR_API_KEY_HERE' } }
);
const data = await res.json();

import requests

response = requests.get(
    'https://www.bayar.gg/api/list-images.php',
    headers={'X-API-Key': 'YOUR_API_KEY_HERE'},
    params={'active_only': 'true'}
)
data = response.json()

Example Response

{
  "success": true,
  "data": [
    {"id": 1, "filename": "product.jpg", "url": "https://...", "active": true}
  ]
}

QRIS Converter Endpoints

Method	Endpoint	Description
POST	`/api/qris-convert.php`	Konversi QRIS statis → dinamis dengan nominal
GET POST	`/api/qris-info.php`	Info & validasi QRIS

POST /api/qris-convert.php

Mengkonversi QRIS statis ke QRIS dinamis dengan nominal tertanam. Support input text QRIS atau gambar QRIS.

Request Body (JSON)

Parameter	Type	Required	Description
`nominal`	number	Required	Nominal yang akan ditanam di QRIS (dalam Rupiah)
`qris`	string	Pilih salah satu	String QRIS yang akan dikonversi
`image`	string	Pilih salah satu	Base64 encoded gambar QR code
`image_url`	string	Pilih salah satu	URL gambar QR code

File Upload (Multipart Form Data)

Field	Type	Description
`nominal`	number	Nominal yang akan ditanam
`image`	file	File gambar QR code (JPEG, PNG, GIF, WebP)

Tips: Gunakan qr_image_url untuk menampilkan QR code yang sudah dikonversi langsung di aplikasi Anda.

Code Examples

curl -X POST https://www.bayar.gg/api/qris-convert.php \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -d '{
    "qris": "00020101021126...",
    "nominal": 50000
  }'

$response = file_get_contents('https://www.bayar.gg/api/qris-convert.php', false,
    stream_context_create([
        'http' => [
            'method' => 'POST',
            'header' => "Content-Type: application/json\r\nX-API-Key: YOUR_API_KEY_HERE",
            'content' => json_encode([
                'qris' => '00020101021126...',
                'nominal' => 50000
            ])
        ]
    ])
);
$data = json_decode($response, true);

const res = await fetch('https://www.bayar.gg/api/qris-convert.php', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-API-Key': 'YOUR_API_KEY_HERE'
    },
    body: JSON.stringify({
        qris: '00020101021126...',
        nominal: 50000
    })
});
const data = await res.json();

import requests

response = requests.post(
    'https://www.bayar.gg/api/qris-convert.php',
    headers={'X-API-Key': 'YOUR_API_KEY_HERE'},
    json={
        'qris': '00020101021126...',
        'nominal': 50000
    }
)
data = response.json()

Example Response

{
  "success": true,
  "qris": "00020101021226...",
  "qr_image_url": "https://www.bayar.gg/qris-info/api/qr.php?data=...",
  "merchant_name": "GOPAY MERCHANT",
  "amount": 50000
}

GET POST /api/qris-info.php

Mendapatkan informasi dari QRIS tanpa mengkonversinya. Berguna untuk validasi dan preview.

Query Parameters (GET)

Parameter	Type	Required	Description
`qris`	string	Required	String QRIS untuk dianalisis

Use Case: Gunakan endpoint ini untuk validasi QRIS sebelum proses konversi, atau untuk menampilkan preview merchant info ke user.

Code Examples

curl -X GET "https://www.bayar.gg/api/qris-info.php?qris=00020101021126..." \
  -H "X-API-Key: YOUR_API_KEY_HERE"

$response = file_get_contents(
    'https://www.bayar.gg/api/qris-info.php?qris=00020101021126...',
    false,
    stream_context_create([
        'http' => ['header' => "X-API-Key: YOUR_API_KEY_HERE"]
    ])
);
$data = json_decode($response, true);

const res = await fetch(
    'https://www.bayar.gg/api/qris-info.php?qris=00020101021126...',
    { headers: { 'X-API-Key': 'YOUR_API_KEY_HERE' } }
);
const data = await res.json();

import requests

response = requests.get(
    'https://www.bayar.gg/api/qris-info.php',
    headers={'X-API-Key': 'YOUR_API_KEY_HERE'},
    params={'qris': '00020101021126...'}
)
data = response.json()

Example Response

{
  "success": true,
  "merchant_name": "GOPAY MERCHANT",
  "merchant_city": "JAKARTA",
  "amount": 0,
  "is_dynamic": false
}

WhatsApp Store API

Method	Endpoint	Description
GET	`/api/wa-store-orders.php`	Daftar pesanan WA Store
POST	`/api/wa-store-complete.php`	Update status pesanan

GET /api/wa-store-orders.php

Ambil daftar pesanan WhatsApp Store atau detail pesanan tertentu. Mendukung pencarian berdasarkan nomor order, nama customer, atau nomor telepon.

Query Parameters

Parameter	Tipe	Required	Keterangan
`order_number`	string	Optional	Ambil detail satu pesanan (e.g. WA260329-A1B2)
`status`	string	Optional	Filter: pending, waiting_payment, paid, processing, completed, cancelled
`search`	string	Optional	Cari berdasarkan nomor order, nama customer, nomor telepon, atau invoice ID
`limit`	integer	Optional	Max 100, default 50
`offset`	integer	Optional	Pagination offset

Code Examples

curl -X GET "https://www.bayar.gg/api/wa-store-orders.php?status=paid&limit=10" \
  -H "X-API-Key: YOUR_API_KEY_HERE"

$response = file_get_contents(
    'https://www.bayar.gg/api/wa-store-orders.php?status=paid&limit=10',
    false,
    stream_context_create([
        'http' => ['header' => "X-API-Key: YOUR_API_KEY_HERE"]
    ])
);
$data = json_decode($response, true);

const res = await fetch(
    'https://www.bayar.gg/api/wa-store-orders.php?status=paid&limit=10',
    { headers: { 'X-API-Key': 'YOUR_API_KEY_HERE' } }
);
const data = await res.json();

import requests

response = requests.get(
    'https://www.bayar.gg/api/wa-store-orders.php',
    headers={'X-API-Key': 'YOUR_API_KEY_HERE'},
    params={'status': 'paid', 'limit': 10}
)
data = response.json()

Example Response

{
  "success": true,
  "data": [
    {
      "order_number": "WA260329-A1B2",
      "customer_name": "Rahim",
      "status": "paid",
      "total": 75000
    }
  ],
  "total": 5
}

POST /api/wa-store-complete.php

Update status pesanan WA Store (completed, cancelled). Pesanan hanya bisa diselesaikan (completed) jika sudah dibayar (status: paid/processing). Pesanan yang sudah selesai tidak bisa dibatalkan. Notifikasi WhatsApp otomatis dikirim ke customer.

Body Parameters

Parameter	Tipe	Required	Keterangan
`order_number`	string	Required	Nomor order WA Store
`status`	string	Optional	completed, cancelled (default: completed)
`notify`	boolean	Optional	Kirim notifikasi WhatsApp ke customer (default: true)

Validasi: Status completed hanya bisa diset jika pesanan sudah berstatus paid atau processing. Pesanan completed tidak bisa di-cancel.

Code Examples

curl -X POST https://www.bayar.gg/api/wa-store-complete.php \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -d '{
    "order_number": "WA260329-A1B2",
    "status": "completed",
    "notify": true
  }'

$response = file_get_contents('https://www.bayar.gg/api/wa-store-complete.php', false,
    stream_context_create([
        'http' => [
            'method' => 'POST',
            'header' => "Content-Type: application/json\r\nX-API-Key: YOUR_API_KEY_HERE",
            'content' => json_encode([
                'order_number' => 'WA260329-A1B2',
                'status' => 'completed',
                'notify' => true
            ])
        ]
    ])
);
$data = json_decode($response, true);

const res = await fetch('https://www.bayar.gg/api/wa-store-complete.php', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-API-Key': 'YOUR_API_KEY_HERE'
    },
    body: JSON.stringify({
        order_number: 'WA260329-A1B2',
        status: 'completed',
        notify: true
    })
});
const data = await res.json();

import requests

response = requests.post(
    'https://www.bayar.gg/api/wa-store-complete.php',
    headers={'X-API-Key': 'YOUR_API_KEY_HERE'},
    json={
        'order_number': 'WA260329-A1B2',
        'status': 'completed',
        'notify': True
    }
)
data = response.json()

Example Response

{
  "success": true,
  "message": "Order completed successfully",
  "order": {
    "order_number": "WA260329-A1B2",
    "status": "completed"
  }
}

OVO Integration

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

Langkah Setup

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

Cara Kerja Pencocokan

Step	Proses
1	Customer membayar ke nomor OVO Anda dengan nominal yang tepat (termasuk kode unik)
2	Sistem mengecek mutasi OVO setiap beberapa detik
3	Jika ditemukan transaksi masuk dengan nominal yang cocok, pembayaran otomatis dikonfirmasi
4	Callback dikirim ke URL yang Anda tentukan

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"
  }'

Penting: Pastikan customer mentransfer dengan nominal yang tepat termasuk kode unik agar pembayaran terdeteksi otomatis.

QRIS BAYAR GG Integration

QRIS BAYAR GG memungkinkan user memakai QRIS dinamis dengan mID merchant sendiri yang di-assign admin. Metode ini cocok untuk Payment Link, WhatsApp Store, Donasi, dan integrasi API yang membutuhkan QRIS per merchant dengan webhook otomatis.

Syarat Menggunakan QRIS BAYAR GG via API

Premium aktif: akun wajib memiliki langganan Premium aktif.
Admin grant: admin harus mengaktifkan QRIS BAYAR GG untuk user dan mengisi mID merchant.
API key provider tersedia: API key QRIS BAYAR GG / InterActive QRIS harus dikonfigurasi oleh admin.
Limit nominal: nominal transaksi tidak boleh melebihi max_amount dari endpoint /api/get-payment-methods.php.
Biaya pembukaan: aktivasi production QRIS BAYAR GG dikenakan biaya pembukaan Rp 100.000 dan membutuhkan data usaha/KYC merchant.

Alur Integrasi

User request akses QRIS BAYAR GG dari dashboard dan chat admin untuk approval production.
Admin mengaktifkan akses, mengisi mID merchant, dan mengatur limit nominal per transaksi.
Developer cek ketersediaan via GET /api/get-payment-methods.php.
Buat invoice via POST /api/create-payment.php dengan payment_method: "qris_bayar_gg".
Gunakan payment_url untuk checkout hosted page, atau render qris_dynamic_image_url / qris_string di aplikasi Anda.
Status paid diproses otomatis melalui webhook provider dan polling /api/check-payment.php.

Contoh Request dengan QRIS BAYAR GG

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": 75000,
    "description": "Pembayaran QRIS BAYAR GG",
    "customer_name": "Budi",
    "customer_phone": "6281234567890",
    "payment_method": "qris_bayar_gg",
    "callback_url": "https://example.com/payment-webhook",
    "redirect_url": "https://example.com/thank-you"
  }'

Response QRIS BAYAR GG

{
  "success": true,
  "data": {
    "invoice_id": "BAYAR-1778029840-86EFB7",
    "amount": 75000,
    "final_amount": 75000,
    "unique_code": 0,
    "payment_method": "qris_bayar_gg",
    "payment_method_label": "QRIS BAYAR GG",
    "status": "pending",
    "payment_url": "https://www.bayar.gg/pay?invoice=BAYAR-1778029840-86EFB7",
    "qris_string": "0002010102122676...",
    "qris_dynamic_image_url": "https://www.bayar.gg/qris-info/api/qr.php?text=000201...",
    "iqris_invoiceid": "36556065",
    "iqris_nmid": "ID1020012345678",
    "iqris_request_date": "2026-05-06 08:10:43"
  }
}

Info: QRIS BAYAR GG tidak memakai kode unik. final_amount adalah nominal pembayaran ditambah profit/fee persen yang diatur user (jika ada). QRIS yang dikembalikan sudah dinamis dan nominalnya tertanam.

Penting: Tombol Mark as Paid QRIS BAYAR GG tidak tersedia di panel user. Jika terjadi kebutuhan koreksi manual, proses hanya dilakukan oleh admin untuk menjaga audit webhook dan settlement.

BRI Merchant QRIS Integration

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

Pastikan langganan Anda aktif (trial atau berbayar)
Buka menu BRI QRIS Merchant di dashboard
Masukkan kredensial BRI API Anda (Host, Username, Password, MID, TID)
Test koneksi untuk memastikan API berfungsi
Upload gambar QRIS merchant Anda
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"
  }'

Info: Pembayaran via BRI Merchant QRIS tidak menambah saldo yang bisa di-withdraw karena dana langsung masuk ke rekening Anda.

Penting: Pastikan kredensial BRI API valid dan gambar QRIS sudah diupload sebelum menggunakan metode ini.

GoPay Merchant QRIS Integration

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

Pastikan langganan Anda aktif (trial atau berbayar)
Buka menu GoPay Merchant QRIS di dashboard
Capture token dari GoPay Merchant App menggunakan HTTP Inspector
Paste JSON token + device info di halaman koneksi
Upload gambar QRIS GoPay Merchant Anda
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"
}

Info: Pembayaran via GoPay Merchant QRIS tidak menambah saldo yang bisa di-withdraw karena dana langsung masuk ke akun GoPay Merchant Anda.

Penting: Token GoPay Merchant memiliki masa berlaku terbatas. Pastikan token masih valid dan gambar QRIS sudah diupload sebelum menggunakan metode ini. Perbarui token secara berkala.

Webhook 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",
  "payment_method": "qris_bayar_gg",
  "amount": 50000,
  "final_amount": 50000,
  "unique_code": 0,
  "paid_at": "2024-01-15 12:25:30",
  "paid_amount": 50000,
  "paid_reff_num": "QRIS-BGG-36556065",
  "paid_via": "qris_bayar_gg",
  "iqris_payment_customername": "BUDI",
  "iqris_payment_methodby": "BCA",
  "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

Header	Description
`Content-Type`	application/json
`X-Webhook-Event`	payment.paid
`X-Webhook-Signature`	HMAC SHA256 signature untuk verifikasi
`X-Webhook-Timestamp`	Unix timestamp saat callback dikirim
`X-Invoice-ID`	Invoice ID pembayaran

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:

Setting	Keterangan
`Default Callback URL`	URL default yang otomatis digunakan jika `callback_url` tidak disertakan saat create payment.
`Webhook Secret Key`	Secret key unik per user (`whsec_xxx`) untuk memverifikasi signature callback. Bisa di-regenerate kapan saja.
`Callback Logs`	Riwayat 20 callback terakhir beserta status HTTP response.

Penting: Signature menggunakan Webhook Secret Key Anda (bukan API Key). Dapatkan di Pengaturan → Webhook.

Payment Status

Status	Description
pending	Menunggu pembayaran
paid	Pembayaran berhasil
expired	Pembayaran expired (melebihi batas waktu)
cancelled	Pembayaran dibatalkan

Error Codes

HTTP Code	Description
`200`	Success
`400`	Bad Request — Parameter tidak valid
`401`	Unauthorized — API Key tidak valid
`404`	Not Found — Resource tidak ditemukan
`405`	Method Not Allowed
`429`	Too Many Requests — Rate limit exceeded
`500`	Internal Server Error