Migrate from Casaku

Panduan migrasi dari Casaku ke Qrisy. Keyword: lebih cepat, lebih murah, lebih reliable.

Why Migrate?

Migration Steps

1. Daftar Qrisy

Buat akun di qrisy.id/login. Free tier: 5 merchant, 100 transaksi.

2. Upload Ulang QRIS Statis

Dashboard → QRIS Merchant → Tambah. Paste QRIS string yang sama dari Casaku. Qrisy auto-parse merchant name & city.

3. Generate API Key

Dashboard → API Keys → Generate. Ganti casaku_key di codebase Anda dengan qs_live_xxx.

4. Update Code

Ganti Casaku SDK dengan Qrisy SDK:

Node.js

// Before (Casaku)
import Casaku from 'casaku';
const casaku = new Casaku({ apiKey: 'casaku_xxx' });
const trx = await casaku.createTransaction({ /* ... */ });

// After (Qrisy)
import { Qrisy } from '@qrisy/node';
const qrisy = new Qrisy({ licenseKey: 'qs_live_xxx' });
const trx = await qrisy.generateQRISv2({ /* ... */ });

Python

# Before
from casaku import Casaku
casaku = Casaku(api_key="casaku_xxx")

# After
from qrisy import Qrisy
qrisy = Qrisy(license_key="qs_live_xxx")

PHP

// Before
$casaku = new Casaku('casaku_xxx');

// After
$qrisy = new Qrisy(licenseKey: 'qs_live_xxx');

5. Update Webhook Handler

Qrisy webhook payload mirip Casaku, tapi dengan fields tambahan:

6. Update Webhook URL

Dashboard Qrisy → Webhook → Tambah Endpoint. Masukkan URL handler Anda. Pilih events: paid, cancel, expired.

7. Install Qrisy Listener

Uninstall Casaku app. Install Qrisy Listener dari Play Store. Login dengan akun Qrisy. Grant Notification Listener permission.

8. Test End-to-End

1. Generate QR via API/dashboard
2. Scan & bayar dengan e-wallet
3. Verifikasi: webhook diterima <3 detik
4. Verifikasi: dashboard update real-time

Parallel Run (Optional)

Untuk migrasi aman, jalankan Casaku + Qrisy paralel selama 1-2 minggu:

1. Setup Qrisy dengan merchant yang sama
2. Webhook Qrisy ke endpoint berbeda (/webhook/qrisy vs /webhook/casaku)
3. Compare transaksi: pastikan kedua sistem detect sama
4. Bila konsisten, switch traffic ke Qrisy

FAQ Migration

Apakah QRIS statis saya perlu diganti?

Tidak. QRIS statis dari e-wallet Anda tetap valid. Cukup upload ulang ke Qrisy.

Apakah VIP Casaku bisa dipindah?

Tidak. VIP Casaku dan Qrisy terpisah. Qrisy free tier cukup untuk testing, lalu upgrade VIP Qrisy.

Apakah HP listener perlu device berbeda?

Tidak. Bisa install Qrisy Listener di HP yang sama. Uninstall Casaku app terlebih dahulu untuk hindari konflik notification listener.