💳 Dokumentasi Payment Gateway Brainxiex

📌 Overview

Payment Gateway Brainxiex adalah sistem pembayaran menggunakan metode QRIS. Sistem ini memungkinkan aplikasi pihak ketiga untuk membuat transaksi pembayaran dan memantau statusnya.

✨ Fitur Utama

🌐 Base URL

Base URL untuk mengakses semua endpoint Payment Gateway Brainxiex:

Endpoint yang Tersedia:

🔑 Autentikasi

Semua endpoint Payment Gateway memerlukan API Key untuk autentikasi. API Key dapat disertakan melalui parameter apikey di request body atau query parameter.

Contoh Autentikasi:

{
  "apikey": "YOUR_API_KEY",
  "jumlah": 10000
}

Cara Mendapatkan API Key

API Key dapat diperoleh dengan mengunjungi Dashboard Brainxiex dan membuat API Key baru.

➕ Buat Transaksi

Endpoint ini digunakan untuk membuat transaksi pembayaran baru. Transaksi akan menghasilkan QR code yang dapat dipindai oleh user untuk melakukan pembayaran.

Request Parameters:

Contoh Request:

curl -X POST 'https://brainxiex.com/api/brainxiex/buat-transaksi' \
-H 'Content-Type: application/json' \
-d '{
  "apikey": "YOUR_API_KEY",
  "jumlah": 10000,
  "webhook": "https://your-app.com/webhook",
  "user": "username",
  "email": "[email protected]",
  "wa": "6281234567890"
}'

<?php
$data = array(
  "apikey" => "YOUR_API_KEY",
  "jumlah" => 10000,
  "webhook" => "https://your-app.com/webhook",
  "user" => "username",
  "email" => "[email protected]",
  "wa" => "6281234567890"
);

$options = array(
  "http" => array(
    "header" => "Content-Type: application/json\r\n",
    "method" => "POST",
    "content" => json_encode($data),
  ),
);

$context = stream_context_create($options);
$response = file_get_contents('https://brainxiex.com/api/brainxiex/buat-transaksi', false, $context);
echo $response;
?>

const data = {
  apikey: "YOUR_API_KEY",
  jumlah: 10000,
  webhook: "https://your-app.com/webhook",
  user: "username",
  email: "[email protected]",
  wa: "6281234567890"
};

fetch('https://brainxiex.com/api/brainxiex/buat-transaksi', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error('Error:', error));

const axios = require('axios');

const data = {
  apikey: "YOUR_API_KEY",
  jumlah: 10000,
  webhook: "https://your-app.com/webhook",
  user: "username",
  email: "[email protected]",
  wa: "6281234567890"
};

axios.post('https://brainxiex.com/api/brainxiex/buat-transaksi', data)
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error('Error:', error);
});

import requests
import json

url = "https://brainxiex.com/api/brainxiex/buat-transaksi"
headers = {
  "Content-Type": "application/json"
}
data = {
  "apikey": "YOUR_API_KEY",
  "jumlah": 10000,
  "webhook": "https://your-app.com/webhook",
  "user": "username",
  "email": "[email protected]",
  "wa": "6281234567890"
}

response = requests.post(url, headers=headers, data=json.dumps(data))
print(response.json())

Response Success:

{
  "ok": true,
  "id": "abc123xyz",
  "status": "pending",
  "nominal": 10250,
  "biaya_admin": 50,
  "biaya_transaksi": 250,
  "total": 10000,
  "qris_string": "00020101021226580016ID.CO.QRIS.WWW01189360052002100000000000303UMI51440014ID.CO.QRIS.WWW0215ID102002000000000303UMI5204581253033605802ID5910Barqah_Xiex6007Jakarta6105101106304A3B2",
  "qris_image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
  "date": 1731234567890,
  "expired": 1731238167890,
  "webhook": "https://your-app.com/webhook",
  "user": "username",
  "email": "[email protected]",
  "wa": "6281234567890"
}

Response Fields:

Response Error:

{
  "ok": false,
  "error": "apikey salah"
}

🔍 Cek Transaksi

Endpoint ini digunakan untuk mengecek status transaksi berdasarkan ID transaksi.

Request Parameters:

Contoh Request:

curl -X GET 'https://brainxiex.com/api/brainxiex/cek-transaksi?id=abc123xyz'

<?php
$id = "abc123xyz";
$response = file_get_contents("https://brainxiex.com/api/brainxiex/cek-transaksi?id=$id");
echo $response;
?>

const id = "abc123xyz";

fetch(`https://brainxiex.com/api/brainxiex/cek-transaksi?id=${id}`)
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error('Error:', error));

import requests

id = "abc123xyz"
url = f"https://brainxiex.com/api/brainxiex/cek-transaksi?id={id}"

response = requests.get(url)
print(response.json())

Response Success (Pending):

{
  "ok": true,
  "id": "abc123xyz",
  "status": "pending",
  "nominal": 10250,
  "biaya_admin": 50,
  "biaya_transaksi": 250,
  "total": 10000,
  "qris_string": "...",
  "qris_image": "data:image/png;base64,...",
  "date": 1731234567890,
  "expired": 1731238167890
}

Response Success (Sukses):

{
  "ok": true,
  "id": "abc123xyz",
  "status": "sukses",
  "nominal": 10250,
  "biaya_admin": 50,
  "biaya_transaksi": 250,
  "total": 10000,
  "qris_string": "...",
  "qris_image": "data:image/png;base64,...",
  "date": 1731234567890,
  "expired": 1731238167890
}

Response Success (Expired):

{
  "ok": true,
  "id": "abc123xyz",
  "status": "expired",
  "nominal": 10250,
  "biaya_admin": 50,
  "biaya_transaksi": 250,
  "total": 10000,
  "qris_string": "...",
  "qris_image": "data:image/png;base64,...",
  "date": 1731234567890,
  "expired": 1731238167890
}

Status Transaksi:

• pending: Transaksi menunggu pembayaran
• sukses: Transaksi berhasil dibayar
• expired: Transaksi kadaluarsa (10 menit)

Response Error:

{
  "ok": false,
  "error": "data tidak ada"
}

🔔 Webhook

Webhook digunakan untuk menerima notifikasi otomatis ketika pembayaran berhasil. Sistem akan mengirim POST request ke URL webhook yang Anda set saat membuat transaksi.

Webhook Payload:

Sistem akan mengirim data berikut ke webhook URL Anda saat pembayaran berhasil:

{
  "ok": true,
  "id": "abc123xyz",
  "status": "sukses",
  "nominal": 10250,
  "biaya_admin": 50,
  "biaya_transaksi": 250,
  "total": 10000,
  "qris_string": "...",
  "qris_image": "data:image/png;base64,...",
  "date": 1731234567890,
  "expired": 1731238167890,
  "webhook": "https://your-app.com/webhook",
  "user": "username",
  "email": "[email protected]",
  "wa": "6281234567890"
}

Implementasi Webhook (Node.js):

const express = require('express');
const app = express();

app.use(express.json());

app.post('/webhook', (req, res) => {
  const { id, status, nominal, user, email } = req.body;

  // Validasi data
  if (!id || !status) {
    return res.status(400).json({ error: 'Invalid payload' });
  }

  // Cek status pembayaran
  if (status === 'sukses') {
    console.log(`Pembayaran sukses: ${id}, Amount: ${nominal}`);

    // Update database, kirim notifikasi, dll
    // Contoh: tambahkan saldo user
    if (user && email) {
      // Verifikasi dan tambahkan saldo
    }
  }

  // Response ke server
  res.status(200).json({ success: true });
});

app.listen(3000, () => {
  console.log('Webhook server running on port 3000');
});

🔄 Payment Flow

Berikut adalah alur lengkap pembayaran menggunakan Payment Gateway Brainxiex:

const response = await fetch('https://brainxiex.com/api/brainxiex/buat-transaksi', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apikey: 'YOUR_API_KEY',
    jumlah: 10000,
    webhook: 'https://your-app.com/webhook',
    user: 'username',
    email: '[email protected]'
  })
});
const transaction = await response.json();

<img src="${transaction.qris_image}" alt="QRIS Payment" />

// Polling setiap 5 detik
const interval = setInterval(async () => {
  const response = await fetch(`https://brainxiex.com/api/brainxiex/cek-transaksi?id=${transaction.id}`);
  const status = await response.json();

  if (status.status === 'sukses') {
    clearInterval(interval);
    console.log('Pembayaran berhasil!');
    // Proses pembayaran sukses
  } else if (status.status === 'expired') {
    clearInterval(interval);
    console.log('Transaksi kadaluarsa');
    // Handle expired
  }
}, 5000);

💰 Biaya

Berikut adalah rincian biaya yang dikenakan untuk setiap transaksi:

Minimal Transaksi:

Minimal nominal transaksi adalah Rp 10.000.

💻 Examples

Contoh Implementasi Lengkap (JavaScript):

class BrainxiexPayment {
  constructor(apikey) {
    this.apikey = apikey;
    this.baseUrl = 'https://brainxiex.com/api/brainxiex';
  }

  // Buat transaksi baru
  async createTransaction(options) {
    const { jumlah, webhook, user, email, wa, prefix } = options;

    const response = await fetch(`${this.baseUrl}/buat-transaksi`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        apikey: this.apikey,
        jumlah,
        webhook,
        user,
        email,
        wa,
        prefix
      })
    });

    return await response.json();
  }

  // Cek status transaksi
  async checkTransaction(id) {
    const response = await fetch(`${this.baseUrl}/cek-transaksi?id=${id}`);
    return await response.json();
  }

  // Polling status sampai sukses atau expired
  async waitForPayment(id, options = {}) {
    const { interval = 5000, maxAttempts = 120 } = options;
    let attempts = 0;

    return new Promise((resolve, reject) => {
      const poll = setInterval(async () => {
        attempts++;

        if (attempts > maxAttempts) {
          clearInterval(poll);
          reject(new Error('Payment timeout'));
          return;
        }

        const status = await this.checkTransaction(id);

        if (status.status === 'sukses') {
          clearInterval(poll);
          resolve(status);
        } else if (status.status === 'expired') {
          clearInterval(poll);
          reject(new Error('Transaction expired'));
        }
      }, interval);
    });
  }
}

// Penggunaan
const payment = new BrainxiexPayment('YOUR_API_KEY');

// Buat transaksi
const transaction = await payment.createTransaction({
  jumlah: 10000,
  webhook: 'https://your-app.com/webhook',
  user: 'username',
  email: '[email protected]'
});

if (transaction.ok) {
  console.log('Transaksi dibuat:', transaction.id);
  console.log('QR Code:', transaction.qris_image);

  // Tampilkan QR code ke user...

  // Tunggu pembayaran (opsional)
  try {
    const result = await payment.waitForPayment(transaction.id);
    console.log('Pembayaran berhasil!', result);
  } catch (error) {
    console.error('Error:', error.message);
  }
} else {
  console.error('Gagal membuat transaksi:', transaction.error);
}

⚠️ Error Handling

Common Errors:

Best Practices:

• Selalu validasi response sebelum memproses data
• Gunakan try-catch untuk menangani error network
• Implementasi retry logic untuk request yang gagal
• Simpan log transaksi untuk debugging
• Set timeout yang wajar untuk polling status