Bepaid
Nasıl Bağlanılır
Bağlanmak için bePaid ödeme sistemine, bir Mağaza Kimliği, gizli anahtarve genel anahtargerekecektir. Bu kimlik bilgilerini aldıktan sonra, içindeki ayarlara geçin Salebot.
bunu elde etmek için Mağaza Kimliği, gizli anahtarve genel anahtar, lütfen baPaid teknik desteğiyle iletişime geçin.
İçinde MaviBot, "Ödeme sistemi" bölümünü açın ve bePaidseçin. Ardından aldığınız kimlik bilgilerini girin.
Lütfen dikkat: son alan, kullanım ülkesine bağlı olarak API barındırmasını seçen bir anahtardır: Belarus veya Rusya.
Ödeme Bağlantısı Nasıl Oluşturulur
Bir ödeme bağlantısı oluşturmak için, şu değişkene bir değer atamanız gerekir: payment_sum değişkeni (örneğin: 150 veya 100.55 — ondalık ayırıcı olarak nokta kullanın).
Bir kez payment_sum değişkeni ayarlandıktan sonra, bepaid_pay_url değişkeni otomatik olarak görünecektir. Bu değişkeni ekranda bir bağlantı olarak gösterebilir veya metni "Öde".
olan bir düğmeye yerleştirebilirsiniz. Ödeme bağlantısı şöyle görünecektir:
ayıklamadan önce payment_sum değişkenini, ödemeyi özelleştirmek için aşağıdaki isteğe bağlı değişkenleri de tanımlayabilirsiniz.
Varsayılan olarak para birimi Beyaz Rus rublesiolarak ayarlanır. Farklı bir para birimi kullanmanız gerekiyorsa, currency değişkenine bir değer atayın.
currency
ISO 4217 formatında ödeme para birimi
Örneğin: USD
language
Ödeme sayfası dili Varsayılan: 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 – Rumence
payment_description
Ödeme Açıklaması
link_expired
Ödeme Bağlantısı Son Kullanma Süresi Son kullanma tarihini şu formatta ayarlayın gg.aa.yyyy (örneğin: 25.06.2025). Varsayılan olarak, ödeme şu süre içinde tamamlanmalıdır: 24 saat.
ayrıca "Yönlendirmede Değişkenleri Ata" alanını kullanarak şunları ayarlayabilirsiniz:
link_expired = current_date + 2— bağlantı 2 gün boyunca 00:00'a kadar geçerli olacaktır.Ayrıca tam son kullanma tarihini ve saatini şu formatta belirtebilirsiniz gg.aa.yyyy ss:dd (örneğin: 25.06.2025 12:23). Varsayılan olarak, ödeme şu süre içinde tamamlanmalıdır: 24 saat.
Standart değişkenler de kullanılabilir. Örneğin, bağlantı geçerliliğini 30 dakikaolarak ayarlamak için: time = current_time + 30 link_expired = "#{current_date} #{time}"
russian_host
Rusya'daki bePaid Host'ta Kayıtlı Mağaza Göstergesi Bu parametreyi 1 olarak ayarlayın, eğer mağazanız bepaid.tech.
üzerine kayıtlıysa. Host'u Belarus'a geçirmek gerekiyorsa, bu parametreyi "" (boş değer) olarak ayarlayın.
test_payments
Bu değişken test ödemeleriiçin kullanılır. Bir test ödemesi yapmak için, onu herhangi bir değerle ekleyin.
bepaid_attempts
şunu belirtir: ödeme denemesi sayısıVarsayılan olarak, 1 deneme izin verilir.
сustomer_data
Ödeyen kişinin şu bilgilerini içeren bir dizi: first_name, last_nameve email. Bu veri, makbuzun ödeyen kişinin e-postasına gönderilmesi için gereklidir ve ödeme sayfasında düzenlenebilir.
Parametre şu biçimde iletilmelidir: JSON formatında anahtar-değer çiftleri listesi. Örneğin: customer_data = ‘{“first_name”: “Sam”, “last_name”: “Smith”, “email”: “[email protected]” }’
bepaid_contract (koşullu olarak gerekli)
Token ile Ödeme Amacı
Beklenen değerler:
“recurring” – belirli bir sıklıkta yapılan düzenli ödemeler için
“card_on_file” – tek seferlik veya düzensiz ödemeler için, örneğin bir hizmet için ödeme sonrası
Ödeme tamamlandıktan sonra, bepaid_callback_data değişkeni müşteri için eklenecektir. Bu değişken, tamamlanan işlem için ödeme sisteminin yanıtını içerir. Gerekli verileri bu sözlükten get yöntemini kullanarak çıkarabilirsiniz.
Ödemeler Nasıl Test Edilir
Bir test ödemesi yapmak için, payment_sum değişkenini ayarlamadan önce, test_payments değişkenini herhangi bir değerle ayarlayın. Botu canlı modda!
Test kartları:
4200000000000000 — başarılı
4005550000000019 — başarısız
Bir şey çalışmazsa, verilerinizi resmi belgelerle karşılaştırın: https://docs.bepaid.by/ru/test-integration#test-card-number
Ödeme Bağlantısı Oluşturma Örneği
İçin bir ödeme bağlantısı oluşturalım 100 Belarus rublesi (varsayılan para birimi).
Not: önce yapılandırma için ek değişkenleri ayarlayın, ardından payment_sumdeğişkenini ayarlayın. Değişkenler iş akışında daha önce de ayarlanabilir, mutlaka aynı blokta olmak zorunda değildir — bu sadece bir örnektir.
Son olarak, istenen konumda bepaid_pay_url değişkenini gösterin; bu değişken oluşturulan ödeme bağlantısını içerir.
Abonelik Yönetimi
Ödeme sistemi entegrasyonu, müşterileriniz için abonelik oluşturmanıza olanak tanır.
Bu işlevselliği kullanmadan önce Salebot, abonelik planı oluşturun bePaid hesabınızda.
Eğer “Planlar” ve “Abonelikler” menüleri hesabınızda görünmüyorsa, lütfen yöneticinizle iletişime geçin.
Abonelik Oluşturma ve Ödeme Bağlantısı Üretme
şunu kullanın: get_bepaid_subscription_url fonksiyonu, şu parametreyi ileterek: plan_id parametresi, burada…
plan_id
plan_id şunun kimliğidir: bePaid sistemdeki plan.
Sonuç olarak, fonksiyon bir abonelik oluşturacak ve bir ödeme bağlantısı döndürecektir.
Bağlantıyı müşteriye gönderin ve ödemenin tamamlanmasını bekleyin.
Ödeme başarılı olduktan sonra, abonelik etkinleştirilecektir. İşlemde şu değerler yer alacaktır: bepaid_subscription_id ve bepaid_subscription_status değişkenleri ve bot'a bir geri çağrı gönderilecektir (bkz. “Sonucun Nasıl İşleneceği” bölümü).
Abonelik Bilgilerini Alma
Bir müşteri için mevcut abonelik ayrıntılarını almak için şunu çağırın: get_bepaid_subscription_info fonksiyonunu kullanın ve şu parametreyi iletin: subscription_id parametresi (değer şuradan alınabilir: bepaid_subscription_id değişkeni).
Aboneliği İptal Etme
Bir aboneliği iptal etmek için şunu kullanın: cancel_bepaid_subscription işlevini kullanın.
Bu fonksiyon tek bir parametre alır: subscription_id (değer şuradan alınabilir: bepaid_subscription_id değişkeni).
İptal başarıyla gerçekleştirildiğinde, bepaid_subscription_status değişkeni şu değere ayarlanacaktır: “canceled”, ve bot'a bir geri çağrı gönderilecektir (bkz. “Sonucun Nasıl İşleneceği” bölümü).
Abonelik Durumları
trial
Aktif veya iptal edilmiş deneme süresi aboneliği.
active
Aktif abonelik, ödeme zamanında yapıldı.
failed
Başarısız abonelik. bePaid sonraki ödemeyi işleyemedi.
error
Sırasında bir hata oluştu bePaid ödeme işlemeye çalışıyordu.
canceled
Abonelik canceled iptal edildi ve artık aktif değil.
Tekrarlayan Ödemeler
Ayrıca bir abonelik sistemi kurabilirsiniz plan oluşturmadan içinde bePaid hesabınızda.
Bunun için müşterinin kart tokenına.
ihtiyacınız olacaktır. Kart tokenını almak için, müşteri payment_sum.
ayıklamadan önce payment_sum değerini kullanarak oluşturulan bir bağlantı ile başlangıç ödemesi yapmalıdır, şunu ayarlayın: bepaid_contract değişkeni, token ile gelecekteki ödemelerin amacını belirtmek için:
“recurring” – belirli bir sıklıkta yapılan düzenli ödemeler için
“card_on_file” – tek seferlik veya düzensiz ödemeler için, örneğin bir hizmet için ödeme sonrası
Düğmenin “card_on_file” seçeneği tüm alıcılar tarafından desteklenmez. Kullanmak istiyorsanız, lütfen hesap yöneticinizle iletişime geçin.
Başarılı bir ödemeden sonra, bepaid_client_card_token değişkeni işleme eklenecek ve müşterinin kart tokenını saklayacaktır. Bu token, müşterinin kartından ücret almanıza olanak tanır müşterinin müdahalesi olmadan.
Sonra huninizi kurun ve otomatik tahsilat için bir tarih veya koşul belirtin, ardından şunu çağırın: make_bepaid_token_payment fonksiyonu, gerekli parametreleri ileterek.
Parametre sırası: amount → currency → description → contract
Parametre Açıklamaları
amount (gerekli)
Ödeme tutarı – beklenen değer bir tam sayıdır veya ondalıklı sayıdır, örneğin: 100 veya 100.5.
currency (gerekli)
Ödeme para birimi şu formatta: ISO 4217 örneğin: “USD”.
description (gerekli)
Tahsilat açıklaması, örneğin: “Hobi kulübüne katılım için haftalık abonelik ödemesi”.
contract (gerekli)
Token ile ödeme amacı. Beklenen değerler: “recurring” veya “card_on_file”.
Düğmenin contract değeri birebir eşleşmelidir ilk ödeme bağlantısı oluşturulurken belirtilen değerle!
Ödeme başarılı olursa, fonksiyon şu mesajı döndürür: “bePaid tokenı ile başarılı tahsilat”, başarılı ödeme için bir geri çağrı alırsınız ve işlem değişkeni bepaid_token_payment_completed şu değere ayarlanacaktır: “True”.
Ödeme başarısız olursa, fonksiyon başarısızlığın nedenini belirten bir mesaj döndürür, sonuna “_fail” eklenmiş bir geri çağrı bot'a gönderilir ve işlem değişkeni bepaid_token_payment_completed şu değere ayarlanacaktır: “False”.
Banka, müşterinin ödemeyi tamamlamasını isteyebilir. Bu durumda, fonksiyon müşteriyi 3-D Secure kimlik doğrulamasından.
geçmeye yönlendiren bir bağlantı döndürür
Sonucun Nasıl İşleneceği Bot, müşteri eylemlerine yanıt olarak, gizli anahtarın ilk 20 karakteri
ve işlem türüne ve sonucuna bağlı bir sonek içeren geri çağrılar alacaktır. görmez.
Ödemeler İçin
ödemeler için aboneliklerle ilgili olmayan, aşağıdaki mesajlardan birini alırsınız:
keyNumber_success – başarılı bir ödeme için
keyNumber_fail – başarısız bir ödeme için
Son ödemenin durumunu şu değişkenleri kullanarak da takip edebilirsiniz:
bepaid_payment_completed – müşteriyle ilgili ödemeler için
bepaid_token_payment_completed – için kart tokenına dayalı otomatik ödemeler
Abonelikler İçin
Bir abonelik başarıyla etkinleştirildikten sonra, ilk veya tekrarlayan ödeme olsun, bot şu mesajı alacaktır keyNumber_success.
Abonelik iptal edilirse, şu mesajı alırsınız keyNumber_canceled.
Başarısız bir abonelik ödemesi durumunda, mesaj keyNumber_fail gönderilecektir.
Last updated