Toplu ödeme yöntemi kapsamında ödeme başlatmak için bu servisi kullanabilirsiniz. Bu servis ile ödeme emirlerinizi Paywall'a gönderebilirsiniz. Ödemelerinizi tamamlayacak ve geri bildirim gönderilecek
Önemli: Toplu ödeme başlatma servisini kullanabilmeniz için Header alanında apikeypublic ve apiclientpublic parametrelerini göndermeniz gerekmektedir.
PaymentAPI Adresi
Storm modelindeki toplu ödeme servisine maksimum500adet işlem gönderebilirsin. Gönderdiğiniz toplu ödeme emri sonrasında tüm ödemeler sync olarak oluşturulur ve Id, UniqueCode vb ödeme bilgilerini API cevabı içerisinde alabilirsiniz.
Storm🍃 modelinde, 23:50 - 00:00 saatleri arasında gönderilen toplu ödeme talepleri, gece yarısından sonra işlenir. Bu bekleme süresi, finansal raporların tutarlılığını sağlamak amacıyla uygulanmaktadır.
Parametre
Tip
Zorunlu
Açıklama
apikeypublic
string
Evet
Üye işyeri panelinden temin etmiş olduğunuz Public Key.
apiclientpublic
string
Evet
Üye işyeri panelinden temin etmiş olduğunuz Public Client.
Servise gönderilecek örnek JSON ve örnek kodlar aşağıdaki gibidir.
{"PaymentDetail": {"Amount": 4.53,"MerchantUniqueCode":"{{$guid}}","CurrencyId": 1,"Installment": 2,"CallbackAddress":"https://webhook.site/fdd9d71c-4381-481f-abf4-2fba544f8a2d","ChannelId": 0,"TagId": 0,"ClientIP":"1.1.1.1","Half2D":false,"CallbackBodySplit":false,"CallbackBodyCompression":false },"CardMethod": 2,// 1: General card for all products | 2: Single card for each product// Eğer 1 gelirse aşağıdaki kart nesnesi"CardModel": 1,// 1: ECommerce | 2: Insurance"Payments": [ {"Customer": {"FullName":"FullName","Phone":"5336662211","Email":"[email protected]","Country":"Country","City":"City","Address":"Address","IdentityNumber":"IdentityNumber","TaxNumber":"TaxNumber" },"Product": {"ProductId":"1","ProductName":"12","ProductCategory":"1","ProductDescription":"denemr","ProductAmount": 1.51 },"Card": {"OwnerName":"Enes Tütüncü","Number":"5528790000000008","IdentityNumber":"","ExpireMonth":"12","ExpireYear":"2030","Cvv":"123" } } ]}
Toplu ödeme kapsamında alınacak olan ödemelerin yer aldığı liste şeklinde Json nesnesidir
Ana Dizin:PaymentDetail
Parametre
Tip
Zorunlu
Açıklama
Amount
string
Evet
Ödeme işleminde tahsil edilecek toplam tutardır.
MerchantUniqueCode
decimal
Evet
Üye işyerine özgü olarak tanımlanan benzersiz bir koddur.
CurrencyId
string
Evet
İşlemin gerçekleştirileceği para birimini ifade eder.
Para birimleri
Installement
integer
Evet
Müşterinin ödeme planında seçtiği taksit adedini gösterir.
CallbackAddress
string
Evet
İşlem tamamlandıktan sonra sistemin sonuç bilgisini ileteceği adrestir.
ClientIP
string
Evet
İşlem yapan kullanıcının IP adresini ifade eder.
Half2D
bool
Hayır
Ödemelerinizi özel bir çağrı ile finansallaştırabilmeniz için size destek olacak parametredir. Half2D parametresini true göndermeniz durumunda ödeme bitirme çağrısını siz yapana kadar ödemeniz bankada provizyonda kalacaktır.
CallbackBodySplit
bool
Hayır
Toplu ödeme işlemi bittiğinde gönderilen Post bildirimi, ilgili parametre true gönderildiği durumda, ödeme adedine bağlı olarak parçalı bir şekilde gönderilir.
Örnek: 500 ödeme için parametrenin true gönderilmesi durumda, sistem kendi yoğunluğuna göre bu ödemenin bildirimini 100, 100, 100, 100, 100 şekilde 5 parçada gönderebilir. Bu sadece işlemleri kendi tarafınızda parça parça işleyerek sisteminizi de yormamış olursunuz
CallbackBodyCompression
bool
Hayır
Ödeme isteğinin tamamlanması sonrasında gönderilen Post bildirimi, içerisinde barınan verilerden dolayı büyük bir gövdeye (body) sahip olabilir. Bu durumda CallbackBodyCompression parametresini true gönderirseniz, gönderilen Post bildirimleri GZip ile sıkıştırılarak gönderilir. Bu durumda ilgili GZip gövdeyi (body) kendi tarafınızda çözmeniz ve sonra işlemeniz gerekecektir.
Ana Dizin:Payments
Parametre
Tip
Zorunlu
Açıklama
Customer > FullName
string
Evet
Müşteri tam adı
Customer > Phone
string
Evet
Müşteri telefon numarası
Customer > Email
string
Evet
Müşteri e-posta adresi
Customer > Country
string
Evet
Müşteri ülkesi
Customer > City
string
Evet
Müşteri şehir bilgisi
Customer > Address
string
Hayır
Müşteri adres bilgisi
Customer > IdentityNumber
string
Hayır
Müşteri kimlik bilgisi
Customer > TaxNumber
string
Hayır
Müşteri vergi no bilgisi
Product > ProductId
string
Evet
Satışı gerçekleşen ürün kimlik bilgisi
Product > ProductName
string
Evet
Satışı gerçekleşen ürün adı
Product > ProductCategory
string
Evet
Satışı gerçekleşen ürünün kategori bilgisi
Product > ProductDescription
string
Hayır
Satışı gerçekleşen ürünün açıklama bilgisi
Product > ProductAmount
decimal
Evet
Satışı gerçekleşen ürünün tutar bilgisi
Not: Tüm ürünlerin tutar bilgilerinin toplamı ana tutara eşit olmalıdır
