QRIS Dinamis

Alur penggunaan

1. User login ke web dan upload QRIS statis pada menu QRIS Dinamis.
2. Sistem membaca QR dan menyimpan payload QRIS sebagai sumber default user.
3. Integrator memanggil endpoint API di bawah hanya dengan nominal transaksi.
4. Sistem menghasilkan payload QRIS dinamis dan PNG sementara. Gambar akan dibersihkan otomatis sesuai masa retensi.

Endpoint

https://api.cutiezy.id/api/qris/create

Autentikasi

Gunakan API key akun. IP pemanggil juga harus terdaftar pada slot IP yang aktif.

X-API-Key: czw_xxxxxxxxxxxxxxxxx
Accept: application/json

API key juga didukung melalui Authorization: Bearer ... atau fallback apikey, tetapi header X-API-Key direkomendasikan.

Body request

Body dapat dikirim sebagai JSON atau form-urlencoded.

Contoh cURL

curl -X POST "https://api.cutiezy.id/api/qris/create" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"amount":25000}'

Contoh PHP

<?php
$endpoint = 'https://api.cutiezy.id/api/qris/create';
$apiKey = 'YOUR_API_KEY';

$ch = curl_init($endpoint);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: ' . $apiKey,
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['amount' => 25000]),
]);

$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

Contoh JavaScript

const response = await fetch('https://api.cutiezy.id/api/qris/create', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ amount: 25000 })
});

const data = await response.json();

Response sukses · HTTP 201

{
  "success": true,
  "ok": true,
  "message": "QRIS dinamis berhasil dibuat.",
  "data": {
    "id": 123,
    "source_id": 7,
    "amount": 25000,
    "qris_string": "000201010212...6304ABCD",
    "image_url": "https://example.com/public/generated/qris/20260902/qris_xxx.png",
    "expires_at": "2026-09-03 10:00:00"
  }
}

Kode error