Dalam bisnis online, terutama saat menjual produk digital seperti source code, lisensi software, akun premium, maupun layanan SaaS, kecepatan proses transaksi adalah faktor penentu utama. Pembeli di era sekarang tidak lagi ingin menunggu konfirmasi mutasi rekening manual dari admin.
Untuk menjawab kebutuhan tersebut, MixToko menghadirkan layanan MixToko Pay Payment Gateway—sebuah infrastruktur pembayaran digital otomatis yang memungkinkan setiap pemilik website dan software developer menerima pembayaran QRIS Dinamis All Payment (BCA, Livin Mandiri, BRImo, BNI, ShopeePay, DANA, OVO, GoPay) secara instan, aman, dan dengan biaya kompetitif (flat 0.7%).
Mengapa Memilih MixToko Pay Gateway?
Banyak payment gateway tradisional memerlukan proses verifikasi legalitas perusahaan (PT/CV) yang rumit dan memakan waktu berminggu-minggu. MixToko Pay dirancang khusus untuk mempermudah developer dan pelaku UMKM:
- Aktivasi Cepat: Cukup daftarkan toko Anda di menu Portal Gateway untuk mendapatkan API Key dan Private Key.
- QRIS Dinamis All Payment: Setiap pesanan dibuatkan kode QR unik dengan nominal presisi. Pembeli membayar sesuai tagihan dan sistem langsung mengenali pelunasan dalam hitungan detik.
- Instant Webhook IPN: Begitu dana diterima, server MixToko langsung menembakkan notifikasi HTTP POST ke endpoint backend Anda secara realtime.
- Simulator Sandbox untuk Testing: Developer dapat menguji seluruh alur transaksi dan webhook tanpa harus mentransfer uang sungguhan menggunakan API simulasi.
1. Persiapan Setup & Kredensial API
Sebelum menulis kode integrasi, pastikan toko Anda telah disetujui di portal merchant. Anda akan memiliki 3 identitas kunci:
- Merchant Code: Kode toko unik Anda (contoh:
MTK001). - API Key (
x-api-key): Kunci publik yang dikirimkan pada header setiap request API untuk mengenali akun Anda. - Private Key: Kunci rahasia HMAC-SHA256 untuk membuat dan memverifikasi tanda tangan digital (signature). Kunci ini tidak boleh diekspos ke publik atau frontend JavaScript.
Setiap request POST ke MixToko Pay wajib menyertakan header
x-signature yang dihitung dari raw JSON body menggunakan Private Key Anda. Tujuannya adalah memastikan data transaksi tidak dimanipulasi di tengah jalan (Anti-Tampering).
2. Mode Integrasi: Pilih Sesuai Kebutuhan Anda
MixToko Pay menyediakan 2 metode integrasi yang sangat fleksibel:
A. Mode Hosted Checkout (Redirect URL)
Cocok jika Anda ingin solusi serba cepat tanpa perlu membuat tampilan halaman pembayaran sendiri. Cukup kirim detail pesanan ke MixToko Pay:
POST https://mixtoko.net/api/v1/pg/checkout
Headers:
Content-Type: application/json
x-api-key: [API_KEY_ANDA]
x-signature: [HASIL_HMAC_SHA256]
Body:
{
"amount": 50000,
"order_id": "INV-20261028-001",
"expiry_minutes": 30
}
MixToko akan merespons dengan checkout_url, contoh: https://mixtoko.net/pay/gateway/TRX12345?redirect=https://tokoanda.com/sukses. Cukup redirect pembeli ke URL tersebut. Halaman checkout telah dilengkapi countdown timer, auto-checking status, dan tombol unduh QR.
B. Mode Headless Direct API (Tampilkan QR Sendiri)
Bila Anda mengembangkan aplikasi mobile (Android/iOS) atau ingin menampilkan QRIS langsung di modal pop-up website Anda:
POST https://mixtoko.net/api/v1/pg/create-qris
Headers:
Content-Type: application/json
x-api-key: [API_KEY_ANDA]
Body:
{
"amount": 25000,
"order_id": "INV-20261028-002",
"expiry_minutes": 30,
"callback_url": "https://website-anda.com/api/payment-webhook"
}
Server akan mengembalikan string baku QRIS (qris_string) dan tautan gambar resmi (qr_image) yang bisa langsung dirender di tag <img src="..."> aplikasi Anda.
3. Menerima Webhook Notifikasi Pembayaran (IPN)
Ketika pembayaran selesai, server MixToko akan mengirimkan HTTP POST ke callback_url toko Anda. Berikut contoh handler aman menggunakan PHP Native:
<?php
// file: webhook_handler.php
header('Content-Type: application/json');
$privateKey = 'pk_live_xxxxxxxxxxxxxxxxxxxxxxxx';
// 1. Ambil raw payload dan signature header
$rawBody = file_get_contents('php://input');
$signatureHeader = $_SERVER['HTTP_X_CALLBACK_SIGNATURE'] ?? '';
// 2. Verifikasi tanda tangan digital HMAC SHA256
$expectedSignature = hash_hmac('sha256', $rawBody, $privateKey);
if (!hash_equals($expectedSignature, $signatureHeader)) {
http_response_code(403);
echo json_encode(['error' => 'Invalid signature']);
exit;
}
// 3. Proses data pesanan
$data = json_decode($rawBody, true);
if (($data['status'] ?? '') === 'success') {
$orderId = $data['order_id'];
$amount = $data['amount'];
// Aktifkan lisensi produk / kirim file unduhan ke pembeli di sini!
}
// 4. Kirim respon HTTP 200 OK ke MixToko
http_response_code(200);
echo json_encode(['status' => 'ok']);
exit;
4. Kliring Dana & Penarikan Saldo (/saldo)
Dana dari setiap transaksi yang sukses akan masuk ke pending_balance Anda selama 24 jam untuk perlindungan keamanan sengketa. Setelah 24 jam, dana otomatis berpindah ke saldo utama (available balance) dan dapat ditarik kapan saja melalui menu Saldo Dompet ke rekening bank maupun dompet digital dengan biaya admin flat Rp 4.000.
Dengan mengintegrasikan MixToko Pay, Anda tidak hanya mempermudah pembeli bertransaksi dalam hitungan detik, tetapi juga menghemat waktu administrasi pencatatan manual sehingga Anda bisa fokus mengembangkan produk digital terbaik Anda.
