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.

Dosya 📁 modelinde, Form-Data ile veriler alınmaktadı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 Form-Data parametreleri aşağıdaki gibidir.

Parametre	Tip	Zorunlu	Açıklama
FileFormat	short	Evet	Ödeme bilgilerini içeren dosyanın tipi Bkz: Dosya Desenleri
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
Installment	int	Evet	Taksit bilgisi
CallbackAddress	string	Evet	Ödemenin sonucunun bildirilereceği adres
Half2D	bool	Evet	Ö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	İstek içerisinde gönderilmediği durumda otomatik olarak oluşturulur

Servisten dönen cevap:

Parametre	Tip	Açıklama
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:

JSON

{
    "ErrorCodeType": 1,
    "ErrorMessage": null,
    "ErrorCode": 0,
    "Result": true,
    "Message": "File-based bulk payment created and enqueued",
    "Body": {
        "BulkPaymentId": 3467,
        "MerchantUniqueCode": "bc110eb7-1c52-40e2-ae91-705d00cdbe8a",
        "ProcessedRecords": 0,
        "TotalRecords": 10,
        "IsEnqueued": true,
        "Message": "File-based bulk payment created and enqueued for processing"
    }
}