Beranda / MixToko Pay - Payment Gateway
MixToko Gateway Engine

Payment Gateway QRIS Dinamis & Merchant API

Terima pembayaran otomatis menggunakan QRIS dari seluruh aplikasi bank & e-wallet di Indonesia. Hubungkan website, aplikasi, atau bot Anda secara mandiri melalui REST API yang cepat, aman, dan tanpa pihak ketiga.

Buka Dokumentasi REST API Dompet Saldo & Kliring

Masuk untuk Mendaftar Merchant

Silakan masuk ke akun MixToko Anda untuk mengajukan pendaftaran merchant dan mendapatkan API Key & Private Key integrasi.

Masuk Sekarang
MixToko Pay REST API v2

Panduan Integrasi (Get Started)

Panduan resmi integrasi sistem pembayaran QRIS Dinamis, Hosted Checkout URL, Webhook IPN, dan API status.
FsPay & Pakasir Compatible Halaman Docs Lengkap
Lompat Cepat: A. Persiapan • B. Integrasi Via URL • C. Integrasi Via API • D. Metode Pembayaran • E. Cek Status • F. Simulasi Testing • G. Webhook IPN • H. Contoh Kode SDK

A. Persiapan (Setup & Kredensial API)

Untuk menghubungkan website atau aplikasi Anda ke MixToko Pay, Anda memerlukan 3 identitas utama berikut yang dapat disalin langsung dari panel merchant di atas:

1. Merchant Code (Kode Toko)
MTK001
2. API Key (Header x-api-key)
mtk_live_xxxxxxxxxxxxxxxx
3. Private Key (HMAC Secret)
pk_live_xxxxxxxxxxxxxxxx
Pembuatan Tanda Tangan Digital (x-signature):
Setiap request POST wajib menyertakan header x-signature yang dihitung dari raw body JSON menggunakan Private Key Anda dengan algoritma HMAC-SHA256:
// Contoh PHP:
$rawJsonBody = json_encode(['amount' => 50000, 'order_id' => 'INV-001']);
$signature = hash_hmac('sha256', $rawJsonBody, $merchant['private_key']);

// Header yang Dikirim:
// Content-Type: application/json
// x-api-key: mtk_live_xxxxxxxx 
// x-signature: [hasil_hash_hmac_sha256]

B. Integrasi Via URL (Hosted Checkout)

Untuk mengarahkan pelanggan Anda langsung ke halaman pembayaran instan tanpa perlu repot mengelola string QRIS sendiri di aplikasi Anda, cukup gunakan URL Hosted Checkout:

URL FORMAT https://mixtoko.net/pay/gateway/{ref_id}?redirect={redirect_url}
  • ref_id: ID referensi transaksi unik (contoh: TRX8A9F1B2C) yang dihasilkan oleh endpoint POST /api/v1/pg/checkout.
  • redirect: (Opsional) URL tujuan untuk mengarahkan pembeli kembali ke website toko Anda setelah pembayaran lunas.
// Contoh Penggunaan Nyata:
https://mixtoko.net/pay/gateway/TRX8A9F1B2C?redirect=https://tokoanda.com/invoices/INV-001

C. Integrasi Via API (Direct Dynamic QRIS)

Integrasi Headless API mengembalikan URL gambar QRIS, string QRIS baku, nominal akhir, dan masa berlaku agar Anda dapat menampilkan QR code secara langsung di aplikasi Anda.

POST https://mixtoko.net/api/v1/pg/create-qris (Alias: /api/v1/create-qris)
// cURL Command Siap Pakai:
curl -X POST "https://mixtoko.net/api/v1/pg/create-qris"   -H "Content-Type: application/json"   -H "x-api-key: mtk_live_xxxxxxxx"   -d '{
    "amount": 25000,
    "order_id": "INV-20261027-002",
    "expiry_minutes": 30,
    "callback_url": "https://tokoanda.com/api/callback"
  }'

// Response JSON (200 OK):
{
  "success": true,
  "merchant_code": "MTK001",
  "data": {
    "ref_id": "TRX9A4B1C2D",
    "order_id": "INV-20261027-002",
    "amount": 25000,
    "fee": 175,
    "total": 25175,
    "fee_bearer": "buyer",
    "qr_image": "https://mixtoko.net/api/v1/pg/qr-image/TRX9A4B1C2D",
    "qris_url": "https://mixtoko.net/qr/TRX9A4B1C2D",
    "checkout_url": "https://mixtoko.net/pay/gateway/TRX9A4B1C2D",
    "expires_at": "2026-10-27T14:30:00+07:00"
  }
}

D. Pilihan Metode Pembayaran (Payment Channels)

GET https://mixtoko.net/api/v1/pg/channels
// Response (200 OK):
{
  "success": true,
  "channels": [
    {
      "id": "qris",
      "name": "QRIS Dinamis (All Bank & E-Wallet)",
      "type": "qris",
      "enabled": true,
      "fee_percent": 0.70,
      "currencies": ["IDR"]
    }
  ]
}

E. Cek Status Transaksi (Transaction Status)

POST https://mixtoko.net/api/v1/pg/status (Alias: /api/v1/status)
// Request cURL:
curl -X POST "https://mixtoko.net/api/v1/pg/status"   -H "Content-Type: application/json"   -H "x-api-key: mtk_live_xxxxxxxx"   -d '{"ref_id": "TRX9A4B1C2D"}'

// Response (200 OK):
{
  "success": true,
  "paid": true,
  "data": {
    "ref_id": "TRX9A4B1C2D",
    "order_id": "INV-20261027-002",
    "amount": 25000,
    "fee": 175,
    "total": 25175,
    "net_amount": 25000,
    "status": "success",
    "is_paid": true,
    "paid_at": "2026-10-27 14:05:12"
  }
}

F. Simulasi Pembayaran / Testing Webhook (Payment Simulation)

Gunakan API simulasi ini saat pengujian di staging/development untuk memicu pembayaran lunas secara instan dan menembakkan Webhook IPN tanpa perlu transfer sungguhan:

POST https://mixtoko.net/api/v1/pg/settle (Alias: /api/paymentsimulation)
// Request cURL:
curl -X POST "https://mixtoko.net/api/v1/pg/settle"   -H "Content-Type: application/json"   -H "x-api-key: mtk_live_xxxxxxxx"   -d '{"ref_id": "TRX9A4B1C2D"}'

G. Webhook Instant Payment Notification (IPN)

Saat pembayaran QRIS lunas, server MixToko Pay secara instan mengirimkan HTTP POST dengan header X-Callback-Signature = hash_hmac('sha256', raw_json, private_key).

// Webhook Payload Diterima:
{
  "event": "payment.success",
  "ref_id": "TRX9A4B1C2D",
  "order_id": "INV-20261027-002",
  "amount": 25000,
  "fee": 175,
  "total": 25175,
  "net_amount": 25000,
  "status": "success",
  "paid_at": "2026-10-27 14:05:12"
}

// Handler Webhook di Server Merchant (PHP):
<?php
$rawBody = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_CALLBACK_SIGNATURE'] ?? '';
$privateKey = 'pk_live_xxxxxxxx';

if (hash_equals(hash_hmac('sha256', $rawBody, $privateKey), $signature)) {
    $data = json_decode($rawBody, true);
    if (($data['status'] ?? '') === 'success') {
        // Update database pesanan Anda menjadi lunas
    }
    http_response_code(200);
    echo json_encode(['status' => 'ok']);
} else {
    http_response_code(403);
    echo json_encode(['error' => 'Invalid signature']);
}

H. Contoh Kode Integrasi Lengkap (Multi-Bahasa)

1. PHP Native (cURL)
<?php
$apiKey     = 'mtk_live_xxxxxxxx';
$privateKey = 'pk_live_xxxxxxxx';

$payload = [
    'amount'         => 50000,
    'order_id'       => 'INV-' . time(),
    'expiry_minutes' => 30,
    'callback_url'   => 'https://website-anda.com/webhook'
];
$jsonBody  = json_encode($payload);
$signature = hash_hmac('sha256', $jsonBody, $privateKey);

$ch = curl_init('https://mixtoko.net/api/v1/pg/create-qris');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $jsonBody,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'x-api-key: ' . $apiKey,
        'x-signature: ' . $signature
    ]
]);

$res = json_decode(curl_exec($ch), true);
curl_close($ch);

if (!empty($res['success'])) {
    echo "QR Image: " . $res['data']['qr_image'];
}
2. Node.js (Fetch)
const crypto = require('crypto');

const apiKey = 'mtk_live_xxxxxxxx';
const privateKey = 'pk_live_xxxxxxxx';

const payload = { amount: 50000, order_id: `INV-${Date.now()}` };
const rawBody = JSON.stringify(payload);
const signature = crypto.createHmac('sha256', privateKey).update(rawBody).digest('hex');

fetch('https://mixtoko.net/api/v1/pg/create-qris', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': apiKey,
    'x-signature': signature
  },
  body: rawBody
}).then(r => r.json()).then(console.log);
Ada pertanyaan belanja? Tanya AI yuk!
Asisten MixToko
Online • Respons otomatis
Halo! Saya Asisten MixToko yang didukung AI.

Saya bisa bantu kamu:
• Cari produk & cek rekomendasi
• Cara beli & metode pembayaran
• Garansi, refund, & komplain
• Cek status pesanan
• Tanya seputar layanan mixtoko.net

Silakan ketik pertanyaanmu di bawah atau pilih topik cepat: