MaviBot'da Clip'i kullanmak için, Clip hesabınızda bir çift kimlik bilgisi oluşturmanız ve bunları ödeme sistemi ayarlarına girmeniz gerekir.
Clip, Meksika merkezli bir ödeme hizmetidir.
Kimlik Bilgilerini Alma
Clip ile bir anlaşma imzalayın ve Clip hesabınızdaki Geliştirici Panosu'na (Developer Dashboard) erişim sağlayın.
Kimlik bilgileri bölümünde Crear credencial (Kimlik bilgisi oluştur) seçeneğine tıklayın, bir ad girin ve oluşturmayı onaylayın.
Aşağıdaki kimlik bilgilerini kopyalayın:
- API anahtarı
- Clave secreta (Gizli anahtar)
Önemli! Gizli anahtar, yalnızca kimlik bilgileri oluşturulduktan hemen sonra bir kez görüntülenir. Güvenli bir yerde saklayın. Clip hesabınızda tekrar görüntüleyemezsiniz. Kaybederseniz, yeni bir kimlik bilgisi çifti oluşturmanız gerekir.
Kimlik bilgileri, canlı ve test ortamları için ayrı ayrı oluşturulur. Hesap başına en fazla 6 uygulama oluşturabilirsiniz.
Entegrasyon testleri için bir test kimlik bilgisi çifti oluşturun. Gerçek ödemeleri kabul etmek için canlı kimlik bilgilerini kullanın.
Clip hesabınızda bir ödeme bildirimi URL'si yapılandırmanız gerekmez. MaviBot, her ödeme oluşturulduğunda bildirim URL'sini otomatik olarak gönderir.
Clip'i Bağlama
Tahsilat (Acquiring) sekmesinde Clip'i seçin ve aşağıdakileri girin:
| Alan | Açıklama |
|---|---|
| API anahtarı | Uygulama tanımlayıcısı. |
| Gizli anahtar (Clave secreta) | Uygulama gizli anahtarı. |
Bağlantı artık tamamlanmıştır.
Ödeme Bağlantısı Oluşturma
Aşağıdaki Hesap Makinesi işlevini kullanın:
get_clip_payment_url(amount, description, currency, customer_email, customer_phone, full_name, product_name, language)
Parametreler
| Parametre | Açıklama |
|---|---|
amount |
Ödeme tutarı. Zorunlu. Ana para birimi cinsinden minimum tutar 1'dir. Tutarı 10055 değil, 100.55 olarak belirtin. |
description |
Ödeme açıklaması. İsteğe bağlı. Maksimum uzunluk: 250 karakter. Müşteri, bunu ödeme sayfasında ve makbuzda görebilir. |
currency |
Üç harfli para birimi kodu (MXN ve Clip hesabınız için kullanılabilen diğer para birimleri). İsteğe bağlı. Varsayılan: MXN. |
customer_email |
Müşterinin e-posta adresi. İsteğe bağlı. Ödeme formuna otomatik olarak eklenir. |
customer_phone |
Müşterinin telefon numarası. İsteğe bağlı. Ödeme formuna otomatik olarak eklenir. |
full_name |
Müşterinin adı. İsteğe bağlı. Ödeme formuna otomatik olarak eklenir. |
product_name |
Ürün adı. İsteğe bağlı. |
language |
Ödeme sayfası dili: İspanyolca için es (varsayılan) veya İngilizce için en. |
İşlev bir ödeme URL'si döndürür.
Ödeme Bağlantısı Butonu
Müşteriye bir ödeme butonu göndermek için:
- Öde (Pay) işlevine sahip bir buton oluşturun.
- Ödeme sistemi olarak Clip'i seçin.
- Ürün adını, tutarı ve para birimini belirtin.
- Gerekirse, müşterinin adını, e-posta adresini ve telefon numarasını içeren değişkenleri belirtin.
Ödeme Geri Bildirimleri
Müşteri ödeme bağlantısını takip edip ödemeyi tamamladıktan sonra MaviBot bir geri bildirim alır.
Başarılı Ödeme
Örnek:
SDJ91MTKTT_success 100.55
Burada:
-
SDJ91MTKTT— API anahtarınızın ilk 10 karakteri. -
100.55— ödeme tutarı.
Başarısız Ödeme
Ödeme başarısız olursa, aşağıdaki geri bildirim gönderilir:
SDJ91MTKTT_fail 100.55
Önemli! Başarısız ödeme geri bildirimi, yalnızca ödeme bağlantısı kalıcı olarak kapatıldıktan sonra gönderilir: 5 başarısız ödeme denemesinden sonra veya bağlantının süresi dolduğunda.
Müşterinin kullanılabilir ödeme denemeleri olduğu sürece bağlantı aktif kalır ve başarısız ödeme geri bildirimi gönderilmez.
Başarılı Ödeme Sonrası Müşteri Değişkenleri
| Değişken | Açıklama |
|---|---|
clip_callback_data |
Clip ödeme sisteminden alınan ödeme bilgileri. |
clip_payment_completed |
Ödeme başarıyla işlendiyse "True". |
clip_payment_request_id |
Clip'teki ödeme bağlantısı tanımlayıcısı. |
clip_receipt_no |
Clip makbuz numarası. |