Menghubungkan Stripe

Menerima pembayaran online melalui Stripe: kartu, Apple Pay, Google Pay.

1. Ringkasan#

Stripe — platform pembayaran global. Di direktori Cenaly, Stripe tersedia untuk dihubungkan di 46 negara. Integrasi Cenaly + Stripe memungkinkan Anda:

• 💳 Menerima pembayaran dengan kartu (Visa, Mastercard, AmEx)
• 📱 Apple Pay / Google Pay — pembayaran sekali sentuh
• 💰 Menerima pencairan ke rekening bank Anda
• 🔄 Memproses pengembalian dana dari panel admin
• 💵 Tip — tamu menambahkan tip saat membayar
• 📊 Laporan — analitik keuangan lengkap

2. Persyaratan#

• ✅ Akun Cenaly (pembayaran online tersedia di semua paket, termasuk yang gratis)
• ✅ Akun Stripe (pendaftaran gratis di stripe.com)
• ✅ Rekening bank untuk pencairan (dalam mata uang negara Anda)
• ✅ Dokumen untuk verifikasi (paspor / ID, dokumen perusahaan)

Negara yang didukung#

Stripe ditawarkan untuk dihubungkan di 46 negara:

3. Membuat akun Stripe#

Langkah 1. Pendaftaran#

1. Buka stripe.com → Start now
2. Masukkan email dan buat kata sandi
3. Konfirmasi email

Langkah 2. Verifikasi bisnis#

Stripe akan meminta:

Verifikasi biasanya memakan waktu 1–3 hari kerja.

Langkah 3. Dapatkan kunci API#

1. Di dasbor Stripe: Developers → API keys
2. Salin:
   • Publishable key (pk_live_...)
   • Secret key (sk_live_...)

4. Menghubungkan ke Cenaly#

Yang dihubungkan adalah akun Stripe milik Anda sendiri: uang tamu langsung masuk ke saldo Stripe Anda, Cenaly tidak menahannya.

Buka Toko aplikasi → kategori "Keuangan" → kartu Stripe → "Konfigurasi" — blok koneksi akan terbuka sebagai modal langsung di toko. Jalur yang biasa juga berfungsi: Cabang → kartu cabang → tab "Pembayaran" (bagian "Pembayaran tamu"), tombol "Hubungkan" pada kartu Stripe.

Wizard koneksi (disarankan)#

Wizard langkah demi langkah (≈10 menit) memandu Anda melalui seluruh proses, menunjukkan ke mana harus menekan di dasbor Stripe:

1. Pilih mode — uji atau produksi. Mode di Stripe dan tombol "Uji / Produksi" di Cenaly harus sama.
2. Salin kunci — Developers → API keys: Secret key (sk_test_… / sk_live_…) wajib, Publishable key (pk_…) — opsional.
3. Tambahkan webhook — Developers → Webhooks → Add endpoint, lalu di kolom Endpoint URL tempelkan alamat webhook Cenaly yang diberikan wizard dengan tombol "Salin". Tanpa webhook, Stripe tidak akan memberi tahu bahwa pesanan sudah dibayar, dan pesanan bisa tetap berstatus "menunggu".
4. Pilih event — di blok "Select events" wajib tambahkan checkout.session.completed (inilah yang mengonfirmasi pembayaran pesanan), dan untuk metode pembayaran tertunda — juga checkout.session.async_payment_succeeded dan checkout.session.async_payment_failed. Lalu tekan "Add endpoint". Tanpa event ini, webhook dibuat tetapi tidak akan memberi tahu tentang pembayaran.
5. Salin Webhook signing secret (whsec_…) — kolom opsional, tetapi dengan ini verifikasi tanda tangan notifikasi diaktifkan.
6. Hubungkan — nilai yang dimasukkan dikirim ke backend yang aman.

Formulir singkat#

Jika Anda sudah tahu di mana letak setiap hal di Stripe, buka formulir koneksi inline dan isi kolom yang sama: Secret key, Webhook signing secret (opsional), Publishable key (opsional) plus tombol mode.

5. Pengaturan metode pembayaran#

Kartu bank#

Aktif secara otomatis saat Stripe terhubung:

• Visa / Mastercard — semua negara
• American Express — sebagian besar negara
• Diners Club / Discover — terpilih

Apple Pay dan Google Pay#

Tidak ada tombol khusus di Cenaly untuk keduanya: pembayaran dilakukan di halaman hosted Stripe Checkout, sehingga dompet digital diaktifkan di sisi Stripe.

• Google Pay — langsung berfungsi setelah Stripe terhubung (Android, Chrome).
• Apple Pay — Stripe mengharuskan konfirmasi domain: Settings → Payment methods → Apple Pay → Add new domain. Setelah verifikasi, tombol akan muncul di iOS/Safari.

Metode lain#

Melalui Stripe Dashboard Anda dapat mengaktifkan:

Aktifkan metode yang diinginkan di Stripe Dashboard → Settings → Payment methods.

6. Tip#

Pengaturan#

1. Cabang → kartu cabang → tab "Umum" → tombol "Tip".
2. Cara kerjanya:

Bagaimana tamu melihatnya#

Saat pembayaran setelah memilih hidangan:

Pesanan Anda: 45₾

Tambahkan tip?
[ 10% (4.50₾) ] [ 15% (6.75₾) ] [ 20% (9.00₾) ] [ Jumlah lain ]
[ Tanpa tip ]

TOTAL: 49.50₾   [Bayar →]

Laporan tip#

Bagian Keuangan:

• tab "Ikhtisar" — total tip untuk periode dengan perbandingan periode sebelumnya;
• tab "Penjualan" — tip berdasarkan pelayan.

7. Pencairan ke rekening Anda#

Bagaimana Stripe mencairkan dana#

Tamu membayar → Stripe menahan → Setelah T+2 hari → Dana di rekening Anda

Pengaturan jadwal#

Di Stripe Dashboard → Settings → Payouts:

• Harian (disarankan)
• Mingguan (hari tertentu dalam seminggu)
• Bulanan

8. Biaya Stripe#

9. Pengembalian dana#

Pengembalian dana melalui Stripe diluncurkan dari dua tempat — tergantung bagaimana pesanan dilayani.

Pengembalian dana toko online (RMA)#

1. Bagian Pengembalian → kartu permintaan.
2. Pilih mode pengembalian: ke metode pembayaran asal (Stripe), kartu hadiah (store credit), atau penukaran.
3. Tandai item (pengembalian penuh atau sebagian) dan putuskan apakah barang dikembalikan ke gudang.
4. Dana dikirim langsung dari halaman; ke kartu tamu biasanya tiba dalam 5–10 hari kerja.

Pengembalian dana di kasir#

Di POS pengembalian diproses berdasarkan struk — penuh atau sebagian, tersedia juga penukaran dengan penjualan ulang. Perubahan kas harus dalam keadaan terbuka.

Di kartu pesanan pada bagian Pesanan terlihat lencana pengembalian yang telah diproses dengan tautan ke permintaan.

10. Keamanan#

PCI DSS#

• Cenaly tidak menyimpan data kartu — semuanya diproses oleh Stripe
• Stripe tersertifikasi sebagai PCI Level 1 (tingkat tertinggi)
• Data kartu dienkripsi dan ditokenisasi

3D Secure#

• Verifikasi 3D Secure otomatis untuk kartu EU (SCA/PSD2)
• Mengurangi penipuan dan chargeback
• Untuk tamu: konfirmasi di aplikasi bank

Radar (perlindungan dari penipuan)#

Stripe Radar secara otomatis memblokir transaksi mencurigakan:

• Pola pembelian tidak biasa
• Kartu dari daftar hitam
• Anomali geolokasi

11. Pengujian#

Sebelum mengaktifkan di produksi, uji terlebih dahulu:

Kartu uji Stripe#

CVV: 3 digit apa saja. Tanggal: masa depan apa saja. ZIP: apa saja.

Cara menguji#

1. Saat menghubungkan, pilih tombol "Mode uji" (setiap penyedia punya tombolnya sendiri).
2. Gunakan kunci uji (pk_test_..., sk_test_...) — dan webhook yang dibuat dalam mode uji Stripe yang sama.
3. Buat pesanan uji → bayar dengan kartu uji.
4. Periksa status pesanan di bagian Pesanan — harus menjadi "Dibayar".
5. Setelah semuanya berfungsi — hubungkan ulang penyedia dengan kunci produksi dalam mode "Produksi".

12. Penyedia alternatif#

Untuk negara tanpa Stripe atau sebagai pelengkap — sudah siap diintegrasikan:

94 penyedia lainnya (Adyen, PayTR, ЮKassa, LiqPay, Mercado Pago, Razorpay, dll.) sudah ada dalam daftar, tetapi ditampilkan abu-abu — integrasi masih dalam pengujian. Ikhtisar lengkap — di bagian Pembayaran.

Menghubungkan penyedia mana pun: Toko Aplikasi → kategori "Keuangan" → kartu penyedia → "Konfigurasi", atau melalui jalur biasa Cabang → kartu cabang → tab "Pembayaran".

13. Pertanyaan umum#

Kapan saya menerima uang?#

Dalam 2 hari kerja setelah pembayaran (T+2). Pembayaran pertama bisa memakan waktu 7–14 hari (selama Stripe memverifikasi akun).

Tamu ingin membayar tunai — bagaimana?#

Metode "tunai" dan "kartu saat penerimaan" selalu tersedia dan tidak memerlukan penyedia pembayaran — tamu memilihnya di checkout, dan kasir melakukan penyelesaian. Stripe tidak digunakan; struk dicetak di kasir jika Anda terhubung dengan perangkat fiskal (lihat Fiskalisasi).

Bisakah menghubungkan Stripe dan BOG iPay sekaligus?#

Ya. Di tab "Pembayaran" Anda dapat mengaktifkan beberapa penyedia sekaligus — di checkout tamu akan melihat satu tombol untuk masing-masing, berlabel nama penyedia.

Stripe memblokir akun — apa yang harus dilakukan?#

1. Periksa email — Stripe mengirimkan alasannya
2. Biasanya diperlukan verifikasi tambahan
3. Hubungi Stripe Support: support.stripe.com
4. Selama pemblokiran, Anda dapat menggunakan penyedia alternatif

Bagaimana meminimalkan komisi?#

• Dorong pembayaran dengan kartu EU (1,5% bukan 2,9%)
• Gunakan SEPA untuk jumlah besar (0,35€ tetap)
• Dengan volume besar (>100K€/bulan) — minta paket individual dari Stripe

14. Dukungan#

• Stripe: support.stripe.com
• Cenaly: support@cenaly.com → subjek "Stripe / Pembayaran"
• Stripe Status: status.stripe.com (pemeriksaan ketersediaan)