2. Tsunami 🌊

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

Ödeme Başlat (Tsunami)

POST {{Base Adres}}/api/paywall/payment/bulk/big/startdirect

Önemli: Toplu ödeme başlatma servisini kullanabilmeniz için Header alanında apikeypublic ve apiclientpublic parametrelerini göndermeniz gerekmektedir. PaymentAPI Adresi

Tsunami modelindeki toplu ödeme servisine maksimum 50.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.

Tsunami 🌊 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.

Tsunami 🌊 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.

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.

JSON

{
    "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"
            }
        }
    ]
}

C#

GO

Java

PHP

Python

Ruby

TypeScript

Curl

Ana Dizin

Parametre	Tip	Zorunlu	Açıklama
PaymentDetail	json	Evet	Ödeme detaylarının konumlandırılacağı Json nesnesidir
CardMethod	int	Evet	Ödemeler için kullanılacak kart yöntemi. Bu parametreye bağlı olarak her ödeme tek bir karttan veya her ödeme kendine özel karttan gerçekleşir Tipler
CardModel	int	Evet	Ödeme alınacak kart yöntemidir Tipler
Payments	List<Payment>	Evet	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: 50.000 ödeme için parametrenin true gönderilmesi durumda, sistem kendi yoğunluğuna göre bu ödemenin bildirimini 10.000, 10.000, 10.000, 10.000, 10.000 ş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
Card > OwnerName	string	Koşullu	Kart sahibi adı
Card > Number	string	Koşullu	Kart numarası
Card > IdentityNumber	string	Koşullu	Kart sahibi kimlik bilgisi
Card > CardNoFirst	string	Koşullu	Kartın ilk 8 hanesi
Card > CardNoLast	string	Koşullu	Kartın son 4 hanesi
Card > ExpireMonth	string	Koşullu	Kartın son kullanım ay bilgisi
Card > ExpireYear	string	Koşullu	Kartın son kullanım yıl bilgisi
Card > Cvv	string	Koşullu	Kartın CVV bilgisi

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": "Bulk payment created and enqueued",
    "Body": {
        "BulkPaymentId": 2682,
        "BatchSize": 1000,
        "BatchCount": 5,
        "ProcessedBatchCount": 5,
        "NotProcessedBatchCount": 0,
        "MerchantUniqueCode": "8c404c4a-7bd0-4835-96fc-cc285804c522"
    }
}