Telr Bağlantısı
MaviBot'ta Telr ödeme sistemini kullanmak için, Telr hesabınızdan mağaza kimlik bilgilerinizi almanız ve bunları ödeme sistemi ayarlarına girmeniz gerekir.
Mağaza Kimlik Bilgilerini Alma
Telr ile bir anlaşma imzalayın ve tüccar hesabınıza erişim sağlayın.
Mağazalar → Mağaza detayları bölümünde aşağıdaki değerleri kopyalayın:
| Telr Alanı | MaviBot Alanı |
|---|---|
| Mağaza Kimliği | Mağaza Kimliği |
| Kimlik Doğrulama Anahtarı | Kimlik Doğrulama Anahtarı |
Ödeme Bildirimlerini Yapılandırma
Ödeme Sayfası (veya Güvenlik) → İşlem bildirimi bölümünü açın ve aşağıdaki bildirim URL'sini belirtin:
https://chatter.mavibot.ai/telr_callback/result
Bildirim almak istediğiniz işlem türlerini seçin.
Aynı bölümde Gizli anahtarı kopyalayın. Bu anahtar, bildirim imzalarını doğrulamak için kullanılır.
Önemli! İşlem bildirimi yapılandırması zorunludur. Bu olmadan MaviBot ödeme bildirimleri alamaz ve bot'a geri bildirim gönderilmez.
MaviBot'ta Telr Bağlantısı
Proje ayarlarınızda Ödeme Sistemleri bölümünü açın, Telr'i seçin ve aşağıdaki alanları doldurun:
| Alan | Açıklama |
|---|---|
| Mağaza Kimliği | Telr mağazanızın sayısal tanımlayıcısı. |
| Kimlik Doğrulama Anahtarı | Ödeme bağlantıları oluşturmak için kullanılır. |
| Gizli Anahtar | Ödeme bildirim imzalarını doğrulamak için kullanılır. Bu olmadan ödeme bildirimleri reddedilir. |
| Test Modu | Gerçek fonları çekmeden Telr test kartlarını kullanarak test ödemelerini etkinleştirir. Gerçek ödemeleri kabul etmek için bu seçeneği devre dışı bırakın. |
Tüm alanlar tamamlandığında entegrasyon kullanıma hazırdır.
Ödeme Bağlantısı Oluşturma
Aşağıdaki Hesap Makinesi işlevini kullanın:
get_telr_payment_url(amount, description, currency, product_name)
Parametreler
| Parametre | Açıklama |
|---|---|
amount |
Ödeme tutarı. Zorunlu. |
description |
Ödeme açıklaması. İsteğe bağlı. Maksimum uzunluk: 63 karakter. |
currency |
Üç harfli para birimi kodu (AED, SAR, USD, EUR, GBP ve Telr hesabınız için kullanılabilen diğer para birimleri). İsteğe bağlı. Varsayılan: AED. |
product_name |
Ürün adı. İsteğe bağlı. |
İşlev bir ödeme URL'si döndürür.
Önemli! Ödeme bağlantıları sınırlı bir süre için geçerlidir. Bağlantıyı oluşturduktan hemen sonra müşteriye gönderin.
Örnek
Ödeme Bağlantı Düğmesi
Ödeme düğmesi göndermek için:
- Öde işlevine sahip bir düğme oluşturun.
- Ödeme sistemi olarak Telr'i seçin.
- Şunları belirtin:
- Ürün adı
- Ödeme tutarı
- Para birimi
Ödeme Geri Bildirimleri
Müşteri ödemeyi tamamladıktan sonra MaviBot otomatik olarak bir geri bildirim alır.
Başarılı Ödeme
Örnek:
SDJ91MTKTT_success 100
Burada:
-
SDJ91MTKTT— Kimlik Doğrulama Anahtarınızın ilk 10 karakteri. -
100— ödeme tutarı.
Başarısız veya İptal Edilen Ödeme
Örnek:
SDJ91MTKTT_fail 100
Banka İncelemesindeki Ödeme
Bir ödeme yetkilendirilmiş ancak ek doğrulama için banka tarafından beklemeye alınmışsa, inceleme tamamlanana kadar geri bildirim gönderilmez.
Banka işlemi onayladığında veya reddettiğinde, Telr bir bildirim gönderir ve geri bildirim otomatik olarak MaviBot'a iletilir.
Başarılı Ödeme Sonrası Müşteri Değişkenleri
| Değişken | Açıklama |
|---|---|
telr_callback_data |
Telr ödeme sisteminden alınan ödeme bilgileri. |
telr_payment_completed |
Ödeme başarıyla işlenmişse "True". |
telr_tran_ref |
Telr işlem referansı (tran_ref). |