Panduan Payment Gateway

Bot mendukung pembayaran QRIS melalui Tokopay, Pakasir, Qrispy, dan PayZaan. Kredensial bisa diatur dari web panel, sedangkan pemilihan metode pembayaran bisa diatur dari Store Config bot.

Akses pengaturan di web panel

1. Buka web panel.
2. Masuk ke Settings.
3. Pilih tab Payment Gateway.
4. Isi kredensial provider yang digunakan.
5. Klik Simpan Payment Config.

Field Tokopay

Isi:

• Merchant ID
• API Key
• Base URL

Default Base URL: https://api.tokopay.id

Field Pakasir

Isi:

• Project
• Merchant ID jika masih dipakai sebagai fallback project
• API Key
• Base URL

Default Base URL: https://app.pakasir.com

Field Qrispy

Isi:

• API Token
• API Key jika masih dipakai sebagai fallback token
• Base URL

Default Base URL: https://api.qrispy.id

Field PayZaan

Isi:

• Merchant ID
• Secret Key
• Payment Method, default QRIS2
• Biaya Gateway Ditanggung
• Base URL

Default Base URL: https://pay.zannstore.com

Pilihan biaya gateway:

• User: fee ditambahkan ke total bayar user.
• Merchant: fee dipotong dari total saldo yang diterima merchant.

Memilih provider QRIS

Ada dua sumber pilihan provider:

• .env melalui QRIS_PROVIDER
• Store Config di bot atau panel

Jika QRIS_PROVIDER di .env diisi dengan provider valid, pilihan dari .env akan mengunci provider. Untuk memakai pilihan dari Store Config, kosongkan QRIS_PROVIDER.

Provider yang valid:

• tokopay
• pakasir
• qrispy
• payzaan

Mengaktifkan metode pembayaran

1. Ketik /admin.
2. Masuk ke Store Config.
3. Buka Metode Pembayaran.
4. Aktifkan atau nonaktifkan Saldo dan QRIS sesuai kebutuhan.
5. Pilih provider QRIS jika provider tidak dikunci oleh .env.

Cara kerja transaksi QRIS

Saat user membayar order atau deposit:

1. Bot membuat invoice QRIS ke provider aktif.
2. Bot menampilkan QRIS dan total bayar.
3. Bot mengecek status pembayaran secara berkala.
4. Jika sukses, order diproses atau saldo deposit ditambahkan.
5. Jika expired, failed, atau dibatalkan, status transaksi diperbarui.

Pembatalan ke gateway tersedia untuk Pakasir, Qrispy, dan PayZaan. Tokopay tidak memiliki proses cancel khusus di helper bot ini.

Catatan keamanan

• Jangan kirim API key, secret key, token, atau merchant credential ke user.
• Setelah mengganti credential, lakukan test transaksi kecil yang terkontrol.
• Jika provider tidak siap, bot akan menampilkan field konfigurasi yang masih kurang.