1. Ödeme Başlat

Parçalı ödeme işleminizi bu servis üzerinden başlatabilirsiniz. Tek sepet için çoklu kartla ödeme alabilirsiniz

Ödeme Başlat

POST {{Base Adres}}/api/paywall/payment/start/split

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

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": 600.00,
        "MerchantUniqueCode": "{{$guid}}",
        "CurrencyId": 1,
        "Installment": 1,
        "CallbackAddress": "https://webhook.site/6dbedd75-2e39-47cf-a389-4a2e4b1afdd4", // sadece rollback senaryosu için 
        "ClientIP": "1.1.1.1",
        "Half2D": false,
        "ProviderBased": false,
        "ProviderKey": "test",
        "TrackingCode": "tracking-code-1234567830",
        "PosBased": false,
        "PosId": 4712,
        "AutoRollback": false
    },
    "CardModel": 1, //Ecommerce Insurance
    "Payments": [
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "[email protected]",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 150
            },
            "Card": {
                "OwnerName": "Enes Tütüncü",
                "Number": "5528790000000008",
                "ExpireMonth": "12",
                "ExpireYear": "2026",
                "Cvv": "123"
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "[email protected]",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "OwnerName": "Melih Talu",
                "Number": "5528790000000008",
                "ExpireMonth": "12",
                "ExpireYear": "2030",
                "Cvv": "000"
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "[email protected]",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "OwnerName": "Melih Talu",
                "Number": "5528790000000008",
                "ExpireMonth": "12",
                "ExpireYear": "2030",
                "Cvv": "000"
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "[email protected]",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "OwnerName": "Melih Talu",
                "Number": "5528790000000008",
                "ExpireMonth": "12",
                "ExpireYear": "2030",
                "Cvv": "000"
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "[email protected]",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "OwnerName": "Melih Talu",
                "Number": "5528790000000008",
                "ExpireMonth": "12",
                "ExpireYear": "2030",
                "Cvv": "000"
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "[email protected]",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "OwnerName": "Melih Talu",
                "Number": "5528790000000008",
                "ExpireMonth": "12",
                "ExpireYear": "2030",
                "Cvv": "000"
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "[email protected]",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "OwnerName": "Melih Talu",
                "Number": "5528790000000008",
                "ExpireMonth": "12",
                "ExpireYear": "2030",
                "Cvv": "000"
            }
        }
    ]
}

C#

GO

Java

PHP

Python

Ruby

TypeScript

Curl

Kayıtlı Kart ile Gerçekleştirilen İşlem – JSON Formatı

JSON

{
    "PaymentDetail": {
        "Amount": 400.00,
        "MerchantUniqueCode": "{{$guid}}",
        "CurrencyId": 1,
        "Installment": 1,
        "CallbackAddress": "https://webhook.site/6dbedd75-2e39-47cf-a389-4a2e4b1afdd4", // sadece rollback senaryosu için 
        "ClientIP": "1.1.1.1",
        "Half2D": false,
        "ProviderBased": false,
        "ProviderKey": "test",
        "TrackingCode": "tracking-code-1234567830",
        "PosBased": false,
        "PosId": 4712,
        "AutoRollback": false
    },
    "CardModel": 1, //Ecommerce Insurance
    "Payments": [
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "[email protected]",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 150
            },
            "Card": {
                "UniqueCode": "6gjQkZvrZiYfghmyF2ZZiZVeCYeekubCzBcgEaOrpesMKzedwR8rHw=="
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "[email protected]",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "UniqueCode": "6gjQkZvrZiYfghmyF2ZZiZVeCYeekubCzBcgEaOrpesMKzedwR8rHw=="
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "[email protected]",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "UniqueCode": "6gjQkZvrZiYfghmyF2ZZiZVeCYeekubCzBcgEaOrpesMKzedwR8rHw=="
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "[email protected]",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "UniqueCode": "6gjQkZvrZiYfghmyF2ZZiZVeCYeekubCzBcgEaOrpesMKzedwR8rHw=="
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "[email protected]",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "UniqueCode": "6gjQkZvrZiYfghmyF2ZZiZVeCYeekubCzBcgEaOrpesMKzedwR8rHw=="
            }
        },
        {
            "Customer": {
                "FullName": "FullName",
                "Phone": "5336662211",
                "Email": "[email protected]",
                "Country": "Country",
                "City": "City",
                "Address": "Address",
                "IdentityNumber": "11111111111",
                "TaxNumber": "TaxNumber"
            },
            "Product": {
                "ProductId": "ProductId",
                "ProductName": "ProductName",
                "ProductCategory": "ProductCategory",
                "ProductDescription": "ProductDescription",
                "ProductAmount": 50
            },
            "Card": {
                "UniqueCode": "6gjQkZvrZiYfghmyF2ZZiZVeCYeekubCzBcgEaOrpesMKzedwR8rHw=="
            }
        }
    ]
}

Ana Dizin

Parametre	Tip	Zorunlu	Açıklama
PaymentDetail	PaymentDetail	Evet	Ödeme detaylarının konumlandırılacağı Json nesnesidir
CardModel	int	Evet	Ödeme alınacak kart yöntemidir Tipler
Payments	List<Payment>	Evet	Parçalı ö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.
ProviderBased	bool	Hayır	Ödemenizin hangi sağlayıcıdan geçmesi gerektiğine kendi tarafınızda karar verdiğinizde kullanılır
ProviderKey	string	Koşullu	Ödemenizin geçmesini istediğiniz sağlayıcı anahtarı
PosBased	bool	Hayır	Ödemenizin hangi sağlayıcıdan geçmesi gerektiğine kendi tarafınızda karar verdiğinizde kullanılır
PosId	int	Koşullu	Ödemenizin geçmesini istediğiniz sağlayıcının bağlantı kimlik numarasıdır. Paywall panelinden temin bağlı sağlayıcılar listesinde yer almaktadır
AutoRollback	bool	Hayır	Parçalı işlemlerden herhangi biri başarısız olursa, başarılı olanlar otomatik olarak geri alınsın mı?

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	json	Toplu ödeme işlemine ait detaylı bilgiler.

Servisten Dönen Cevap: Body

Parametre	Tip	Açıklama
SplitPaymentId	int	Parçalı ödeme kimlik bilgisi
MerchantUniqueCode	string	Parçalı ödeme başlatma anında sizin tarafınızdan verilen tekil takip numarası
Status	int	Parçalı ödeme durum bilgisi
Payments	List<Payment>	Parçalı ödeme kapsamında gerçekleşen her işlemin detay bilgisi

Örnek Kod:

JSON

{
    "ErrorCodeType": 1,
    "ErrorMessage": null,
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": {
        "SplitPaymentId": 238,
        "MerchantUniqueCode": "65451a10-7e26-4df7-9149-7d6d3d35de56",
        "Status": 5,
        "Payments": [
            {
                "PaymentId": 4045720,
                "UniqueCode": "90d0b03e-3ab8-418a-aedb-6d808437d43d",
                "MerchantUniqueCode": "0c4f61e1-4ee7-4ad3-868a-f7b3e0558434",
                "IsSuccessful": true,
                "StatusMessage": "Success",
                "Error": null
            },
            {
                "PaymentId": 4045721,
                "UniqueCode": "5db8b112-6554-48ab-b4f8-9e7b3f85393b",
                "MerchantUniqueCode": "6a3c7464-5f9d-4ef3-a8cb-66e17327d743",
                "IsSuccessful": false,
                "StatusMessage": "Failed",
                "Error": null
            }
        ]
    }
}