3. Dosya 📁
Toplu ödeme yöntemi kapsamında, ödemelerin bilgilerini içeren dosya ile ödeme başlatmak için bu servisi kullanabilirsiniz.
Ödeme Başlat (Dosya)
POST {{Base Adres}}/api/paywall/payment/bulk/file/startdirect
Önemli: Toplu ödeme başlatma servisini kullanabilmeniz için Header alanında apikeypublic ve apiclientpublic parametrelerini göndermeniz gerekmektedir. PaymentAPI Adresi
Dosya modelindeki toplu ödeme servisine maksimum 150.000 adet işlem gönderebilirsin. Gönderdiğiniz toplu ödeme emri sonrasında sadece BulkPaymentId bilgisi API cevabı içerisinde verilmektedir. Ardından tüm işlemler Paywall kuyruk mekanizması tarafından işlenir.
Dosya 📁 modeli, yüksek verilerle işlem yapabilmek için tasarlanmıştır. Bu sebeple gönderilen isteklerde GZip ve Brotli ile sıkıştırma kullanmanızı şiddetle öneririz. Bu sayede network'de dolaşan verileri sıkıştırılmış olacak ve bekleme süreleri 90% olaranında azalacaktır.
Dosya 📁 modelinde, 23:00 - 00:00 saatleri arasında gönderilen toplu ödeme talepleri, gece yarısından sonra saat 02:00 itibarıyla işlenir. Bu bekleme süresi, finansal raporların tutarlılığını korumak amacıyla uygulanmaktadır. </> Örnek Kod
Dosya 📁 modelinde, Form-Data ile veriler alınmaktadır.
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 Form-Data parametreleri aşağıdaki gibidir.
File
File
Evet
Ödeme bilgilerini içeren dosya
FilePattern
short
Evet
Ödeme bilgilerini içeren dosyanın desenini belli eden parametredir. Bu parametreyle dosya içeriğini Paywall'un tanıması sağlanır Bkz: Dosya Desenleri
CurrencyId
int
Evet
Para birimi
Not: Gönderilmesi durumunda, tüm ödemeler gönderilen para birimi değeriyle işlenir. Gönderilmedi durumda varsayılan olarak TRY kullanılır.
Installment
int
Hayır
Taksit bilgisi
Not: Gönderilmesi durumunda, tüm ödemeler gönderilen taksit değeriyle işlenir. Gönderilmediği durumda varsayılan olarak Peşin işlem yapılır.
CallbackAddress
string
Hayır
Ödemenin sonucunun bildirilereceği adres
Not: CallbackAddress bilgisi iletilmesi durumunda, dosya ile başlatılan toplu ödemelerin geri bildirimleri de dosya ile iletilmektedir. Bu nedenle, ilgili adres dışardan form-data ile File adında cevap dosyasını alacak şekilde tasarlanmalıdır.
Bkz: İletilen Dosya
Half2D
bool
Hayır
Ödemenin ön provizyon ile alınıp alınmayacağı belirtilir
Amount
decimal
Hayır
Belirtilmediği durumda, dosya içerisindeki verilerle hesaplanır
MerchantUniqueCode
string
Hayır
Toplu ödeme birincil takip kodu. Not: İstek içerisinde gönderilmediği durumda otomatik olarak oluşturulur
TrackingCode
string
Hayır
Toplu ödeme ikincil takip kodu. Not: İstek içerisinde gönderilmediği durumda otomatik olarak oluşturulur
CallbackBodyCompression
bool
Hayır
İlgili parametrenin true gönderilmesi durumunda CallbackAddress parametresinde yer alan adrese, geri bildirim sıkıştırılarak iletilmektedir
Servisten dönen cevap:
ErrorCode
int
Hata kodu. İşlem başarılı ise '0' değerini döner.
Result
bool
İşlem başarılı ise true, hatalı ise false döner.
Message
string
İşlemle ilgili bilgi veya hata mesajını içerir.
Body
nesne
Toplu ödeme işlemine ait detaylı bilgiler.
Örnek Kod:
Dosya ile gerçekleştirilen toplu ödemelerin cevapları da dosya olarak iletilir. Cevap dosyasına Paywall panelinden her zaman erişebilirsiniz. Buna ek olarak ilgili dosya, toplu ödeme başlatma anında CallbackAddress iletmeniz durumunda ilgili adrese de gönderilir
Last updated