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.
Masuk untuk Mendaftar Merchant
Silakan masuk ke akun MixToko Anda untuk mengajukan pendaftaran merchant dan mendapatkan API Key & Private Key integrasi.
Masuk SekarangPanduan Integrasi (Get Started)
Panduan resmi integrasi sistem pembayaran QRIS Dinamis, Hosted Checkout URL, Webhook IPN, dan API status.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:
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:
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.
/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)
// 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)
/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:
/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)
<?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'];
}
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);