Setup payment di site anda

Untuk site di mana visitor anda bayar anda terus (cth: pre-order, deposit booking, sale eCommerce-style). Berbeza dari /pricing — itu untuk anda bayar kami.

1.Provider yang disokong

Aranis sokong dua payment provider Malaysia secara penuh. Pilih salah satu (atau pasang kedua-dua dan switch di Brief mengikut projek).

✓ Sokongan penuh
ToyyibPay

FPX, kad kredit/debit, e-Wallet (Touch 'n Go, Boost, GrabPay). Mudah daftar — verifikasi SSM dalam 24-48 jam. Sandbox tersedia untuk testing tanpa transaksi sebenar.

✓ Sokongan penuh
Bayarcash

FPX, kad, DuitNow QR, Boost. Dashboard moden dengan support multi-portal (good untuk yang handle beberapa brand). Sandbox console berasingan untuk testing.

💡 Aranis tidak ambil cut dari payment visitor anda. 100% masuk ke akaun provider anda. Aranis dapat pendapatan dari subscription anda kepada kami sahaja.

2.Setup ToyyibPay

  1. Daftar akaun ToyyibPay: pergi ke toyyibpay.com (live) atau dev.toyyibpay.com (sandbox untuk testing). Sign up dengan email + nombor telefon.
  2. Verify bisnes: Upload dokumen SSM (Suruhanjaya Syarikat Malaysia) — borang registration, IC pemilik. Approval biasanya ambil 24-48 jam.
  3. Dapatkan User Secret Key: Dashboard → Account Settings (kanan atas) → seksyen API Keys → copy User Secret Key.
  4. Cipta Category: Menu Category (sidebar) → Create New Category. Beri nama (cth: "Aranis Sites"). Salin Category Code dari senarai category yang baru dibuat.
  5. Paste di Aranis: Pergi ke /account/settings → Payment providers → ToyyibPay → paste User Secret Key + Category Code → pilih environment (Live/Dev) → klik Connect. Key di-encrypt server-side sebelum disimpan.
  6. Pilih provider di Brief: Editor → Brief accordion Payment → pilih ToyyibPay → set price + item name.
  7. Test di sandbox: publish site dengan environment Dev, klik CTA dari preview → bawa anda ke ToyyibPay sandbox. Guna test cards yang diberikan dalam ToyyibPay docs.
  8. Go live: Tukar environment ke Live di /account/settings selepas verify semua bekerja.
User Secret Key adalah rahsia mutlak. Jangan kongsi dengan sesiapa. Kalau anda suspect ia leaked, regenerate di dashboard ToyyibPay segera.

3.Setup Bayarcash

  1. Daftar akaun Bayarcash: pergi ke console.bayar.cash (live) atau console.bayarcash-sandbox.com (sandbox untuk testing).
  2. Setup portal baru: selepas login, cipta sebuah Portal (entiti bisnes anda di Bayarcash). Lengkapkan info perniagaan + verifikasi.
  3. Dapatkan PAT (Personal Access Token): Console → Developers → Personal Access Tokens → Create new PAT. Salin PAT serta-merta — token akan ditunjuk SEKALI SAHAJA, simpan dalam password manager.
  4. Dapatkan Portal Key: Pergi ke menu Portals → buka portal yang anda mahu guna → salin Portal Key.
  5. Paste di Aranis: /account/settings → Payment providers → Bayarcash → paste PAT + Portal Key → pilih environment (Live/Sandbox) → klik Connect. Kedua-dua field di-encrypt sebelum disimpan.
  6. Pilih provider di Brief: Editor → Brief accordion Payment → pilih Bayarcash → set price + item name.
  7. Test di sandbox: publish dengan environment Sandbox, klik CTA → bawa visitor ke Bayarcash sandbox checkout. Lihat Bayarcash API docs untuk test scenarios.
  8. Go live: Tukar environment ke Live di /account/settings selepas verify checkout end-to-end.
PAT ditunjuk sekali sahaja oleh Bayarcash console. Kalau hilang sebelum sempat simpan, anda mesti generate yang baru + paste semula di Aranis.

4.Apa berlaku bila visitor bayar?

  1. Visitor klik butang CTA (cth: "Beli RM 49").
  2. Modal payment dengan logo provider muncul.
  3. Visitor proceed ke laman pembayaran provider (FPX bank / kad / e-Wallet).
  4. Selepas bayar, redirect ke /pay/return — page thank-you Aranis dengan butang lanjut ke WhatsApp anda (kalau ada).
  5. Provider hantar webhook ke /api/pay/webhook → kami verify signature + log payment dalam database anda.
  6. Anda boleh lihat payment di /account/analytics → tab Payments.
💡 Verifikasi signature webhook dibuat server-side. Tiada cara untuk visitor "menipu" payment success — kalau row dalam database menunjukkan paid, payment betul-betul masuk ke akaun provider anda.

5.Provider lain — tidak lama lagi

Aranis ada catalogue untuk provider lain (CHIP, BillPlz, SenangPay, Stripe), tapi adapter tidak aktif buat masa ini. Field input akan kelihatan disabled dengan badge Tidak lama lagi di /account/settings.

Kalau anda sangat memerlukan salah satu provider tersebut, email hello@aranis.site — kami prioritise mengikut demand pengguna.