Cutiezy • API Docs

Cek Mutasi QRIS & Bank Merchant

Inquiry otomatis transaksi masuk dari GoPay/GoBiz, BRI, Mandiri, ShopeePay, BCA, dan OVO.

⚡ Aturan Biaya Kuota API & Syarat Langganan

Syarat Paket Langganan: Akun Anda Wajib memiliki langganan aktif Paket P4 (Unlimited Bulanan) untuk menggunakan seluruh API Cek Mutasi QRIS. Akun gratis atau paket lain akan menerima response 403 PLAN_P4_REQUIRED.
Cek Mutasi SUKSES: Memotong 200 Kuota API (Hit Points) dari saldo kuota akun Anda bila pembayaran dengan nominal dan kriteria terkait berhasil ditemukan (status SUCCESS). Catatan: Yang dipotong adalah 200 kuota tembakan/hit API, BUKAN 200 rupiah / perak.
Cek Mutasi BELUM MASUK / PENDING: 0 Kuota API (GRATIS) terpotong (kuota Anda aman dan tidak berkurang sama sekali jika pelanggan belum bayar).
Pembuatan QRIS Dinamis: Memotong 1 Kuota API (Hit Point) per request pembuatan kode QRIS dinamis.

Utama

1. Cek Status Mutasi (Inquiry Pembayaran)

POST / GET

Panggil endpoint ini secara berkala (polling setiap 3-5 detik) dari website/bot Anda untuk mendeteksi apakah pembeli sudah membayar.

Method

POST / GET

URL Endpoint

https://api.cutiezy.id/api/mutasi/check

Headers Wajib:

X-API-Key: YOUR_API_KEY
Content-Type: application/json

Parameter Request (Body JSON atau Query URL):

Parameter	Tipe	Wajib	Keterangan
amount	number	Wajib	Nominal transaksi yang dicari (contoh: `50000`). Alias: `nominal`.
provider	string	Opsional	Pilihan: `gobiz`, `bri`, `mandiri`, `shopeepay`, `bca`, `ovo`, atau `all`. Default: `all`.
reference	string	Opsional	Nomor referensi atau order ID untuk verifikasi unik.
since_minutes	integer	Opsional	Rentang waktu pencarian dalam menit terakhir. Pilihan fleksibel contoh: `15` (15 mnt), `30` (30 mnt), `60` (1 jam), `180` (3 jam), `720` (12 jam), `1440` (24 jam / 1 hari), `4320` (3 hari), `10080` (7 hari). Default: `1440` menit. Alias: `range_minutes`.

Contoh Response Jika Pembayaran Ditemukan (SUCCESS):

{
  "success": true,
  "ok": true,
  "status": "SUCCESS",
  "message": "Mutasi pembayaran berhasil ditemukan dan berstatus SUCCESS.",
  "hit_points_deducted": 200,
  "data": {
    "provider": "bri",
    "reference": "20261006123456",
    "amount": 50000,
    "status": "SUCCESS",
    "customer": "ANDI PRATAMA",
    "channel": "QRIS",
    "occurred_at": "2026-10-06T09:12:00.000Z"
  }
}

Contoh Response Jika Belum Ada Pembayaran (0 Hit Point):

{
  "success": true,
  "ok": false,
  "status": "NOT_FOUND",
  "message": "Mutasi belum ditemukan atau pembayaran belum berhasil masuk.",
  "hit_points_deducted": 0,
  "data": null
}

Riwayat

2. Daftar Riwayat Transaksi Mutasi

GET

Mengambil daftar transaksi mutasi masuk terbaru dari akun merchant yang telah terhubung.

Method

GET

URL Endpoint

https://api.cutiezy.id/api/mutasi/list

Parameter Query (Opsional):

Parameter	Tipe	Wajib	Keterangan
provider	string	Opsional	Filter provider (contoh: `gobiz`, `bri`, atau `all`).
status	string	Opsional	Filter status transaksi: `SUCCESS`, `PENDING`, atau `all`.
q	string	Opsional	Kata kunci pencarian nama pelanggan atau referensi.

Kompatibilitas Checker

3. Integrasi via Format API Checker Standar

GET

Jika sistem Anda sudah terbiasa dengan pola endpoint checker Cutiezy (seperti /api/check/games, dll), Anda juga dapat menggunakan endpoint format checker berikut:

GET https://api.cutiezy.id/api/check/mutasi/mutasi-check?amount=50000&minutes=1440

GET https://api.cutiezy.id/api/check/mutasi?service=mutasi-check&amount=50000

Headers: X-API-Key: YOUR_API_KEY. Aturan billing sama persis: Wajib langganan Paket P4, Hanya memotong 200 Kuota API (Hit Points) saat SUCCESS, dan 0 kuota saat pending.

Contoh Implementasi Kode

cURL

curl -X POST "https://api.cutiezy.id/api/mutasi/check" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 50000, "provider": "all", "since_minutes": 1440}'

PHP (cURL)

<?php
$ch = curl_init('https://api.cutiezy.id/api/mutasi/check');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'amount' => 50000,
        'provider' => 'all',
        'since_minutes' => 1440, // Rentang pencarian dalam menit (default: 1440 / 24 jam)
    ]),
]);
$res = curl_exec($ch);
curl_close($ch);
$json = json_decode($res, true);

if ($json['ok'] && $json['status'] === 'SUCCESS') {
    // Transaksi lunas! Update order ke database Anda.
    echo "Pembayaran Berhasil! Dipotong: " . $json['hit_points_deducted'] . " HP";
} else {
    echo "Menunggu pembayaran...";
}

Node.js (Fetch)

const res = await fetch('https://api.cutiezy.id/api/mutasi/check', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ amount: 50000, provider: 'all' })
});
const data = await res.json();
if (data.ok && data.status === 'SUCCESS') {
  console.log('Pembayaran masuk!', data.data);
}