Bepaid (ru)
Nasıl bağlanılır
bePaid ödeme sistemini bağlamak için Mağaza ID'sine, gizli anahtara ve genel anahtara ihtiyacınız olacak. Bunları aldıktan sonra MaviBot'taki ayarlara geçiyoruz.
MaviBot'ta "Tahsilat" bölümünü açıyoruz, bePaid'i seçiyoruz. Alınan verileri girmeniz gerekiyor.
Son alanın, kullanım ülkesine göre API barındırma anahtar olduğunu unutmayın: Belarus veya Rusya.
Ödeme bağlantısı nasıl oluşturulur
Ödeme bağlantısı oluşturmak için payment_sum değişkenine bir değer atamanız gerekir (örneğin 150 veya 100.55 (nokta ile!)). Bundan hemen sonra bepaid_pay_url değişkeni görünecektir. Bu değişkeni ekranda bir bağlantı olarak gösterebilir veya üzerinde "Öde" metni olan bir düğmeye yerleştirebilirsiniz.
Bağlantı şu şekildedir: https://checkout.bepaid.by/widget/hpp.html?token=a05eabd3f9368725efbc175614c7d469da08f198cc51916b07fb75e53f9a3e1a
Ayrıca payment_sum değişkenine değer atamadan önce ödeme ayarları için aşağıdaki isteğe bağlı değişkenler de belirtilebilir.
Varsayılan olarak Belarus rublesi ayarlıdır; başka bir para birimi gerekiyorsa currency değişkenine değer atanmalıdır
language
ödeme sayfasının dili
Varsayılan olarak - en.
İzin verilen değerler:
en - İngilizce
es - İspanyolca
tr - Türkçe
de - Almanca
it - İtalyanca
ru - Rusça
zh - Çince
fr - Fransızca
da - Danca
sv - İsveççe
no - Norveççe
fi - Fince
pl - Lehçe
ja - Japonca
uk - Ukraynaca
be - Belarusça
ka - Gürcüce
ro - Romence
payment_description
ödeme açıklaması
link_expired
ödeme bağlantısının geçerlilik süresi, gg.aa.yyyy formatında (örneğin 25.06.2025).
Varsayılan olarak ödeme 24 saat içinde yapılmalıdır
Ayrıca alanına da "Değişkenleri geçişte atama" şunu belirtebilirsiniz: link_expired = current_date + 2 (bağlantı 00:00'a kadar 2 gün geçerli olacak)
link_expired ayrıca tam saatli bir tarih, boşlukla ayrılmış şekilde gg.aa.yyyy ss:dd formatında da belirtilebilir (örneğin: 25.06.2025 12:23). Varsayılan olarak ödeme 24 saat içinde yapılmalıdır
Ayrıca standart değişkenler de kullanılabilir; örneğin bağlantı geçerlilik süresini 30 dakika olarak ayarlayalım:
time = current_time + 30
link_expired = "#{current_date} #{time}"
russian_host
mağazanın bePaid Rusya hostunda kayıtlı olduğunu gösteren işaret. Mağazanız bepaid.tech sitesinde kayıtlıysa, bu parametreyi 1 değeriyle belirtin
Host'u Belarus hostuna geçirmek gerekiyorsa, parametreyi '' değeriyle belirtin
test_payments
değişkeni test ödemeleri içindir; test ödemesi gerekiyorsa herhangi bir değerle ekleyin.
bepaid_attempts
ödeme yapma deneme sayısını belirtir; varsayılan olarak 1 deneme verilir.
сustomer_data
içeren bir dizi first_name, last_name ve email ödeyenin bilgileri. Bu veriler, makbuzu ödeyenin e-postasına göndermek için gereklidir ve ödeme sayfasında düzenlenebilir.
Parametre, anahtar-değer çiftlerinden oluşan json formatında bir liste olarak iletilmelidir
örneğin:
customer_data = ‘{“first_name”: “Vladimir”, “last_name”: “Popov”, “email”: “[email protected]” }’
bepaid_contract (koşullu zorunlu)
token ile ödeme amacı.
Beklenen değerler: "recurring" (belirlenen periyodiklikte düzenli ödemeler için) veya "card_on_file" (düzensiz ödemeler için, örneğin verilen hizmet için sonradan ödeme)
Ödeme tamamlandıktan sonra müşteriye şu değişken eklenecektir bepaid_callback_data, gerçekleştirilen işlem için ödeme sisteminin yanıt verilerini içeren. Alınan sözlükten gerekli veriler yöntem kullanılarak çıkarılabilir get.
Ödemeler nasıl test edilir
payment_sum değişkenini belirtmeden önce test ödemesi yapmak için test_payments değişkenine herhangi bir değer atamanız gerekir.
Botu canlı moda alırken bunu kaldırmayı unutmayın!
Test kartları:
4200000000000000 başarılı
4005550000000019 başarısız
Bir şey çalışmıyorsa, verileri resmi sitedeki verilerle karşılaştırın: https://docs.bepaid.by/ru/test-integration#test-card-number
Ödeme bağlantısı oluşturma örneği
100 Belarus rublesi tutarında bir ödeme bağlantısı oluşturalım (varsayılan para birimi)
Dikkat edin, önce ayarlar için ek değişkenleri, sonra payment_sum'u belirliyoruz. Değişkenler daha önce zincirde de ayarlanabilir, tek bir blokta olmak zorunda değildir; bu sadece bir örnektir.
Daha sonra gerekli yerde değişkeni gösteriyoruz bepaid_pay_url, içinde bağlantı bulunan
Abonelik yönetimi
Ödeme sistemi entegrasyonu, müşterileriniz için abonelikler oluşturma imkânı sunar.
MaviBot işlevselliğini kullanmaya başlamadan önce, bePaid kişisel hesabında bir abonelik planı oluşturun.
Kişisel hesapta “Planlar” ve “Abonelikler” menüsü görünmüyorsa, yöneticinizle iletişime geçin.
Abonelik oluşturma ve ödeme bağlantısı alma
şu fonksiyonu kullanın get_bepaid_subscription_url, buna plan_id parametresini ileterek, burada
plan_id
bePaid sistemindeki planın ID'sidir.
Sonuç olarak fonksiyon bir abonelik oluşturacak ve onun ödeme bağlantısını döndürecektir.
Bağlantıyı müşteriye gönderin ve ödemenin tamamlanmasını bekleyin.
Başarılı ödeme durumunda abonelik etkinleştirilir, anlaşmaya bepaid_subscription_id ve bepaid_subscription_status değişkenleri eklenir ve bot'a bir callback gelir (bkz. "Sonuç nasıl işlenir").
Abonelik bilgilerini alma
Müşterinin mevcut abonelik verilerini almak için get_bepaid_subscription_info fonksiyonunu çağırın ve subscription_id parametresini iletin (değer bepaid_subscription_id değişkeninden alınabilir).
Aboneliği iptal etme
Aboneliği iptal etmek için cancel_bepaid_subscription fonksiyonunu kullanın.
Bu fonksiyon yalnızca subscription_id parametresini alır (değer bepaid_subscription_id değişkeninden alınabilir).
Başarılı iptalde bepaid_subscription_status değişkeni “canceled” değerini alır ve bot'a bir callback gelir (bkz. bölüm "Sonuç nasıl işlenir").
Abonelik durumları
trial
Deneme süresine ait etkin veya iptal edilmiş abonelik.
active
Ödemesi zamanında yapılmış etkin abonelik.
failed
Başarısız abonelik. bePaid sıradaki ödemeyi gerçekleştiremedi.
error
bePaid ödemeyi gerçekleştirmeye çalışırken bir hata oluştu.
canceled
Abonelik iptal edildi ve artık geçerli değil.
Tekrarlayan ödemeler
BePaid kişisel hesabında bir plan oluşturmadan da abonelik sistemi kurabilirsiniz.
Bunun için müşteri kartı tokenine ihtiyacınız olacak.
Kart tokenini almak için müşteri, payment_sum üzerinden oluşturulan bağlantı ile başlangıç ödemesini yapmalıdır.
payment_sum değerini atamadan önce bepaid_contract değişkenini ayarlayın ve burada token ile gelecekteki ödemelerin amacını belirtin: düzenli ödemeler için “recurring” veya düzensiz ödemeler için (örneğin, verilen hizmet için sonradan ödeme) “card_on_file”.
“card_on_file” seçeneği tüm tahsilat sağlayıcıları tarafından desteklenmez. Bunu kullanmak istiyorsanız, hesap yöneticinizle iletişime geçin.
Başarılı ödemeden sonra anlaşmaya bepaid_client_card_token değişkeni eklenir ve içinde müşteri kartı tokeni saklanır. Bu token, müşterinin kartından onun katılımı olmadan para çekilmesini sağlar.
Ardından huniyi ayarlayın ve otomatik tahsilat için tarih veya koşul belirleyin ve gerekli parametreleri ileterek make_bepaid_token_payment hesaplayıcı fonksiyonunu çağırın.
Parametrelerin sıralaması:
amount -> currency -> description -> contract
Parametre açıklamaları:
amount (zorunlu)
ödeme tutarı, beklenen değer tam sayı veya ondalık sayı; örneğin 100 veya 100.5;
currency (zorunlu)
ödeme para birimi ISO-4217 formatında, örneğin “USD”
description (zorunlu)
çekim nedeninin açıklaması, örneğin, “İlgi kulübüne katılım için haftalık abonelik ücreti”;
contract (zorunlu)
token ile ödeme amacı. Beklenen değerler: “recurring” veya “card_on_file”.
contract değeri, başlangıç ödemesi bağlantısı oluşturulurken belirtilen değerle mutlaka eşleşmelidir!
Ödeme başarılı olursa, fonksiyon “bePaid tokenı ile başarılı tahsilat“ mesajını döndürür, başarılı ödeme hakkında bir callback alırsınız ve anlaşma değişkeni bepaid_token_payment_completed “True” değerini alır.
Ödeme başarısız olursa, fonksiyon başarısız ödeme nedenini belirten bir mesaj döndürür, bot'a “_fail” son ekli bir callback gelir ve anlaşma değişkeni bepaid_token_payment_completed “False” değerini alır.
Banka, ödemenin müşteri tarafından tamamlanmasını isteyebilir. Bu durumda fonksiyon, 3-D Secure kimlik doğrulamasını geçme isteği içeren bağlantıyı döndürür.
Sonuç nasıl işlenir
Müşterinin eylemlerine yanıt olarak bot'a, gizli anahtarın ilk 20 karakterinden ve işlem türü ile sonucuna bağlı bir son ekten oluşan callback'ler gelir.
Sistemde callback, kullanıcıdan gelen bir mesaj gibi görünür; ancak kullanıcının kendisi bunu görmez.
Ödemeler için
Aboneliğe ait olmayan bir ödeme sonucunda size şu mesajlardan biri gelir:
anahtarNumarası_success - başarılı ödeme durumunda;
anahtarNumarası_fail - başarısız ödeme durumunda;
Son ödemenin durumu ayrıca bepaid_payment_completed (müşteri katılımlı ödemeler için) ve bepaid_token_payment_completed (kart tokeni ile onaysız ödemeler için) değişkenleri üzerinden de izlenebilir
Abonelikler için
Aboneliğin ilk veya tekrar eden ödemede başarıyla etkinleştirilmesinden sonra bot'a şu mesaj gelir anahtarNumarası_success.
Abonelik iptal edilmişse, şunu alırsınız anahtarNumarası_canceled.
Abonelik ödemesi başarısız olursa, size şu mesaj gelir anahtarNumarası_fail.
Last updated