Menyambung Telr
Untuk menggunakan sistem pembayaran Telr di MaviBot, anda perlu mendapatkan kelayakan stor daripada akaun Telr anda dan memasukkannya dalam tetapan sistem pembayaran.
Mendapatkan Kelayakan Stor
Tandatangani perjanjian dengan Telr dan dapatkan akses ke akaun peniaga anda.
Dalam Stores → Store details, salin nilai berikut:
| Medan Telr | Medan MaviBot |
|---|---|
| Store ID | ID Stor |
| Authentication key | Kunci Pengesahan |
Mengkonfigurasi Pemberitahuan Pembayaran
Buka Payment Page (atau Security) → Transaction advice dan nyatakan URL pemberitahuan berikut:
https://chatter.mavibot.ai/telr_callback/result
Pilih jenis transaksi yang anda ingin terima pemberitahuannya.
Di bahagian yang sama, salin Secret key. Kunci ini digunakan untuk mengesahkan tandatangan pemberitahuan.
Penting! Mengkonfigurasi Transaction advice adalah wajib. Tanpanya, MaviBot tidak akan menerima pemberitahuan pembayaran, dan tiada panggilan balik akan dihantar ke bot.
Menyambung Telr di MaviBot
Buka Payment Systems dalam tetapan projek anda, pilih Telr, dan isi medan berikut:
| Medan | Penerangan |
|---|---|
| Store ID | Pengecam berangka stor Telr anda. |
| Authentication Key | Digunakan untuk menjana pautan pembayaran. |
| Secret Key | Digunakan untuk mengesahkan tandatangan pemberitahuan pembayaran. Tanpanya, pemberitahuan pembayaran akan ditolak. |
| Test Mode | Membolehkan pembayaran ujian menggunakan kad ujian Telr tanpa mengenakan caj wang sebenar. Nyahaktifkan pilihan ini untuk menerima pembayaran sebenar. |
Setelah semua medan diisi, integrasi sedia untuk digunakan.
Menjana Pautan Pembayaran
Gunakan fungsi Kalkulator berikut:
get_telr_payment_url(amount, description, currency, product_name)
Parameter
| Parameter | Penerangan |
|---|---|
amount |
Jumlah pembayaran. Wajib. |
description |
Penerangan pembayaran. Pilihan. Panjang maksimum: 63 aksara. |
currency |
Kod mata wang tiga huruf (AED, SAR, USD, EUR, GBP, dan mata wang lain yang tersedia untuk akaun Telr anda). Pilihan. Lalai: AED. |
product_name |
Nama produk. Pilihan. |
Fungsi ini mengembalikan URL pembayaran.
Penting! Pautan pembayaran kekal sah untuk masa yang terhad. Hantar pautan kepada pelanggan sejurus selepas menjananya.
Contoh
Butang Pautan Pembayaran
Untuk menghantar butang pembayaran:
- Cipta butang dengan fungsi Pay.
- Pilih Telr sebagai sistem pembayaran.
- Nyatakan:
- Nama produk
- Jumlah pembayaran
- Mata wang
Panggilan Balik Pembayaran
Selepas pelanggan melengkapkan pembayaran, MaviBot secara automatik menerima panggilan balik.
Pembayaran Berjaya
Contoh:
SDJ91MTKTT_success 100
Di mana:
-
SDJ91MTKTT— 10 aksara pertama Kunci Pengesahan anda. -
100— jumlah pembayaran.
Pembayaran Gagal atau Dibatalkan
Contoh:
SDJ91MTKTT_fail 100
Pembayaran dalam Semakan Bank
Jika pembayaran dibenarkan tetapi ditahan oleh bank untuk pengesahan tambahan, tiada panggilan balik dihantar sehingga semakan selesai.
Setelah bank meluluskan atau menolak transaksi, Telr menghantar pemberitahuan, dan panggilan balik dihantar ke MaviBot secara automatik.
Pembolehubah Pelanggan Selepas Pembayaran Berjaya
| Pembolehubah | Penerangan |
|---|---|
telr_callback_data |
Maklumat pembayaran yang diterima daripada sistem pembayaran Telr. |
telr_payment_completed |
"True" jika pembayaran telah berjaya diproses. |
telr_tran_ref |
Rujukan transaksi Telr (tran_ref). |