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.

{
    "PaymentDetail": {
        "Amount": 200.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",
        "PosBased": false,
        "PosId": 4712,
        "AutoRollback": false // İşlemlerden herhangi biri başarısız olursa, başarılı olanlar geri çekilsin mi?
    },
    "CardModel": 1, // 1: Ecommerce | 2: 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": "Card Owner 1",
                "Number": "5528790000000007", // CardModel 1 için
                "ExpireMonth": "12", // CardModel 1 için
                "ExpireYear": "2026", // CardModel 1 için
                "Cvv": "000", // CardModel 1 için
                "CardNoFirst": "", // CardModel 2 için
                "CardNoLast": "", // CardModel 2 için
                "IdentityNumber": "" // CardModel 2 için
            }
        },
        {
            "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": "Card Owner 2",
                "Number": "5528790000000008", // CardModel 1 için
                "ExpireMonth": "12", // CardModel 1 için
                "ExpireYear": "2027", // CardModel 1 için
                "Cvv": "000", // CardModel 1 için
                "CardNoFirst": "", // CardModel 2 için
                "CardNoLast": "", // CardModel 2 için
                "IdentityNumber": "" // CardModel 2 için
            }
        }
    ]
}

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:

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

Last updated