Dalam cerita ini
Where: Pengaturan → Pembaca & keuangan → Sambungan → Pembayaran
Buka halaman ini: admin.<your-site>/settings/connections/payments (ganti <your-site> dengan alamat situs Anda)
Sebelum Mulai
- Hubungkan Razorpay, Stripe, atau PayPal terlebih dahulu. Lihat Pembayaran.
- Anda harus menjadi pemilik situs.
Langkah-langkah
Stripe dan PayPal: Jika memungkinkan, Keynate akan otomatis mengatur pesan pembayaran di akun Anda. Kartu akan menampilkan "Pesan pembayaran sudah diatur di Stripe untuk Anda." Jika tidak bisa otomatis, akan muncul tulisan "Satu langkah lagi" dan tombol Finish setup. Ikuti langkah-langkah di bawah ini.
Razorpay: proses ini tidak bisa otomatis. Kartu Razorpay memiliki panduan 3 langkah dengan pengecekan langsung: Menunggu pesan pertama dari Razorpay… akan berubah menjadi Kami telah menerima pesan pertama dari Razorpay. setelah pembayaran pertama Anda berhasil, baik uji coba maupun asli. Tekan Check now untuk memeriksa ulang. Lihat Hubungkan Razorpay.
Langkah-langkah untuk gateway apa pun:
- Buka Settings → Readers & money → Connections → Payments.
- Pada kartu gateway Anda, cari kotak Webhook.
- Tekan Buka webhook (nama tombol sesuai dengan gateway Anda). Dasbor gateway akan terbuka di tab baru.
- Di gateway tersebut, tekan Add.
- Kembali ke Keynate, tekan Copy di samping Webhook URL lalu tempel di gateway.
- Centang event yang tertera pada kotak Keynate.
- Razorpay: tekan Copy pada kode rahasia lalu tempel sebagai secret. Gunakan kode rahasia yang berbeda untuk mode uji coba dan live.
- Simpan di gateway.
- Stripe dan PayPal menampilkan sebuah kode setelah disimpan. Stripe menyebutnya signing secret dan diawali dengan
whsec_. PayPal menyebutnya Webhook ID. Salin kodenya dan tempel di kotak yang sesuai di Keynate. - Tekan Test connection.
Perlu Diketahui
- Mode uji coba dan mode live masing-masing memerlukan webhook tersendiri.
- Jika kode rahasia hilang, buat webhook baru di gateway dan tempel kode barunya.
Kendala Umum
- "Tempel webhook secret yang Anda masukkan di Razorpay." Kotak di Keynate masih kosong. Tempel secret yang sama dengan yang Anda buat di Razorpay.
- "Gunakan webhook secret yang berbeda untuk uji coba dan live." Buat kode rahasia baru untuk mode kedua.
- "Tempel signing secret webhook. Kode ini diawali dengan whsec_." Salin kodenya dari Stripe setelah menambahkan endpoint.
- "Tempel Webhook ID (hanya huruf dan angka)." Salin ID dari daftar Webhook di aplikasi PayPal Anda.
- Razorpay masih bertuliskan "Menunggu pesan pertama dari Razorpay…". Lakukan pembayaran uji coba nominal kecil. Pesan akan masuk setelah pembayaran pertama selesai. Lalu tekan Check now.
- Pesanan tetap belum lunas padahal pembaca sudah membayar. Webhook belum dipasang atau keliru. Setiap malam Keynate juga mencocokkan pesanan Anda dengan data gateway dan memperbaiki status yang terlewat.
Pertanyaan
Pertanyaan umum
Apakah ini sama dengan API key?
Bukan. API key berguna agar Keynate bisa menghubungi gateway. Webhook berguna agar gateway bisa menghubungi Keynate.
Apakah saya butuh webhook terpisah untuk uji coba dan live?
Ya. Mode uji coba dan mode live masing-masing memerlukan webhook tersendiri.
Bagaimana jika kode rahasianya hilang?
Buat webhook baru di gateway, lalu tempel kode barunya di Keynate.
Bagaimana jika status pesanan tetap belum lunas padahal pembaca sudah membayar?
Webhook belum dipasang atau keliru. Setiap malam Keynate juga mencocokkan pesanan Anda dengan data gateway dan memperbaiki status yang terlewat.