Menghubungkan payment gateway

Untuk menerima pembayaran, Anda menghubungkan akun payment gateway sendiri. Ayosel mendukung beberapa penyedia. Pilih salah satu yang sudah Anda miliki atau daftar baru, lalu masukkan kredensialnya ke dashboard.

Pengaturan payment gateway bisa diubah oleh akun Admin dan Super Admin, selama langganan toko aktif. Kalau langganan belum aktif, tombol simpan dan aktivasi tidak bisa diklik.

Penyedia yang didukung

Kategori Pembayaran IDR (QRIS) hanya boleh satu gateway aktif dalam satu waktu. Gateway yang aktif itulah yang melayani checkout Rupiah pembeli:

• autogopay.site (tampil sebagai AutoGoPay di dashboard) — butuh API Key. Satu akun mendukung dua merchant QRIS (GoPay dan ShopeePay) yang bisa Anda pilih langsung di dashboard tanpa API Key tambahan. Lihat panduan lengkap menghubungkan autogopay.site.
• Pakasir — butuh Project Slug dan API Key. Lihat panduan lengkap menghubungkan Pakasir.
• Tripay — butuh Merchant Code, API Key, dan Private Key.

Kategori Pembayaran Crypto (USDT) bersifat opsional dan berjalan terpisah dari QRIS, jadi satu gateway QRIS dan satu gateway crypto boleh aktif bersamaan. Pilihannya: Binance Pay, NOWPayments, dan Binance Pay Individual. Di antara gateway crypto, hanya satu yang bisa aktif pada satu waktu.

Kenali halaman Payment Gateway

Buka menu Payment Gateway di grup Integrasi pada sidebar. Halaman utamanya menampilkan ringkasan Checkout Rupiah, Checkout USDT, dan Kredensial lengkap, lalu dua panel: Pembayaran IDR (QRIS) dan Pembayaran Crypto (USDT). Panel Cara mengaktifkan di sebelahnya mencentang langkah yang sudah selesai.

Klik tombol di bawah panel (Atur gateway QRIS atau Kelola QRIS; untuk crypto Atur gateway crypto atau Kelola crypto) untuk masuk ke halaman kategori. Anda juga bisa langsung mengklik nama gateway di daftar. Halaman kategori terbagi dua: daftar gateway di kiri, dan formulir gateway yang sedang dipilih di kanan.

Setiap gateway punya badge status: Belum lengkap (kredensial belum terisi), Siap (kredensial lengkap, belum dipakai), dan Aktif (sedang melayani checkout). Gateway crypto punya status tambahan Nonaktif.

1. Ambil kredensial dari penyedia

Masuk ke dashboard penyedia yang Anda pilih, lalu buka bagian API atau integrasi. Salin nilai yang dibutuhkan (lihat daftar di atas sesuai penyedia Anda).

2. Masukkan ke Ayosel (QRIS)

1. Di halaman Payment Gateway, buka Pembayaran IDR (QRIS).
2. Pilih penyedia Anda dari daftar Gateway QRIS, lalu tempel kredensial ke kolom yang sesuai.
3. Klik Simpan (atau tekan Ctrl+S). Hanya kolom yang Anda ubah yang dikirim, dan tombol ini baru aktif setelah ada perubahan. Kalau salah ketik, klik Batal.
4. Setelah kredensial lengkap, kartu status di bagian atas formulir berubah menjadi Siap diaktifkan. Klik Set Aktif untuk menjadikannya gateway yang melayani checkout.

Selama kredensial belum lengkap, kartu status menampilkan Kredensial belum lengkap dan tombol Set Aktif belum tersedia. Mau berhenti menerima pembayaran Rupiah? Klik Nonaktifkan pada gateway yang aktif, lalu konfirmasi dengan Ya, nonaktifkan.

3. Pasang Webhook URL

Agar pembayaran terkonfirmasi otomatis, penyedia perlu mengirim notifikasi balik ke Ayosel. Di bagian bawah formulir gateway ada baris Webhook URL (untuk Tripay bernama Callback URL). Klik Salin, lalu tempel ke pengaturan webhook di dashboard penyedia Anda.

Tanpa webhook yang benar, pembayaran mungkin tidak otomatis tercatat meskipun pembeli sudah membayar. Pastikan URL tertempel persis.

Khusus crypto: nyalakan dan jadikan aktif

Gateway crypto punya satu langkah lebih banyak karena ada toggle Nyalakan gateway:

1. Di halaman Pembayaran Crypto (USDT), pilih gateway dari daftar Gateway crypto.
2. Nyalakan Nyalakan gateway, isi kredensialnya, lalu klik Simpan. Kredensial crypto tidak pernah ditampilkan ulang setelah disimpan. Yang sudah terisi diberi tanda Tersimpan, dan Anda cukup mengisi kolomnya lagi kalau ingin menggantinya.
3. Klik Jadikan aktif crypto pada kartu status. Opsi bayar USDT baru muncul di checkout setelah satu gateway crypto aktif.

Kolom Minimum USDT bersifat opsional. Kalau kosong, nominal minimum order crypto memakai bawaan 0.5 USDT. Untuk Binance Pay Individual tidak ada webhook karena pembayarannya dicek berkala dari riwayat akun. Setelah menyimpan kredensial, klik Test koneksi untuk memastikan koneksi ke Binance berhasil.

Khusus autogopay.site: pilih merchant GoPay atau ShopeePay

Formulir AutoGoPay punya pilihan Merchant Aktif: GoPay Merchant atau ShopeePay Merchant. Dua merchant ini memakai API Key dan Webhook URL yang sama. Mengganti pilihan cukup dengan memilih merchant lain lalu klik Simpan, tanpa memasukkan kredensial baru.

Kalau memilih ShopeePay, baris Koneksi ShopeePay muncul dengan tombol Cek koneksi untuk memastikan token ShopeePay Anda masih tersambung. Token ini bisa expired sewaktu-waktu di sisi autogopay.site, terlepas dari API Key Anda yang tetap valid. Kalau hasilnya menunjukkan token expired, sambungkan ulang lewat dashboard autogopay.site, bukan di form Ayosel.

4. Uji transaksi

Lakukan satu pembelian uji dengan nominal kecil. Setelah membayar via QRIS, status pesanan seharusnya berubah menjadi lunas secara otomatis dalam beberapa saat.

Masalah umum

• Banner “Checkout Rupiah nonaktif”: belum ada gateway QRIS yang aktif, sehingga pembeli belum bisa membayar. Pilih gateway yang kredensialnya lengkap, lalu klik Set Aktif.
• Tombol Simpan atau Set Aktif tidak bisa diklik: langganan belum aktif, atau belum ada perubahan yang perlu disimpan.
• Opsi bayar USDT tidak muncul di checkout: belum ada gateway crypto yang dijadikan aktif. Pastikan toggle menyala, sudah disimpan, lalu klik Jadikan aktif crypto.
• Konfigurasi terlihat belum berubah: klik Muat ulang di kanan atas halaman kategori (QRIS atau crypto) untuk memuat ulang konfigurasi gateway dari server.

Belum mengaktifkan bot? Lihat panduan menghubungkan bot Telegram.