2. Direkt Ödeme (Non-Secure)

Direct Ödeme (Non-Secure)

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

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

ParametreTipZorunluAçı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önderilmesi gereken parametreler şu şekildedir :

ParametreTipZorunluAçıklama

Amount

decimal

Evet

Ödeme sepet tutarı.

MerchantUniqueCode

string

Evet

Ödeme başlatma için gönderilen istek içerisindeki MerchantUniqueCode ile aynı değer olmalıdır. Bu kod sizin tarafınızdan işleme ait verilen tekil değerdir. İptal/İade/Ödeme Sorgulama işlemlerinin hepsinde bir ödemeyi tekilleştirmeniz ve takip etmeniz için kullanılmaktadır. Uzunluk: 250 karakter

CurrencyId

int

Evet

Para birimi.

Installment

int

Evet

Taksit bilgisi, tek çekim için 1 gönderilmelidir.

ClientIP

string

Evet

İşlemi gerçekleştiren tarafın IP bilgisi. Müşteri/Kullanıcı/Üye vb. Uzunluk: 15 karakter

OwnerName

string

Evet

Ödemenin alınacağı kart sahibinin adı soyadı. Uzunluk: 60 karakter

Number

string

Evet

Ödemenin alınacağı kart numarası. Uzunluk: 20 karakter

ExpireMonth

string

Evet

Ödemenin alınacağı kartın son kullanma tarihi ayı.

ExpireYear

string

Evet

Ödemenin alınacağı kartın son kullanma tarihi yılı.

Cvv

string

Evet

Ödemenin alınacağı kartın güvenlik kodu.

UniqueCode

string

Evet

Sağlayıcı tarafında saklanmış olan kart bilgisine karşılık gelen değer (X firmasında saklanmış Y kartının kimliği)

FullName

string

Evet

Üye işyeri tarafındaki alıcıya ait ad

Phone

string

Evet

Üye işyeri tarafındaki alıcıya ait GSM numarası.

Email

string

Evet

İşyeri tarafındaki alıcıya ait e-posta bilgisi.

Country

string

Evet

Üye işyeri tarafındaki alıcıya ait ülke bilgisi.

City

string

Evet

Üye işyeri tarafındaki alıcıya ait şehir bilgisi.

Address

string

Evet

Üye işyeri tarafındaki alıcıya ait kayıt adresi.

IdentityNumber

string

Evet

Üye işyeri tarafındaki alıcıya ait kimlik (TCKN) numarası.

TaxNumber

string

Evet

Üye işyeri tarafındaki alıcıya ait vergi kimlik numarası.

ProductId

string

Evet

Ürün Id.

ProductName

string

Evet

Ürün adı.

ProductCategory

string

Evet

Ürün kategorisi.

ProductDescription

string

Evet

Ürün açıklama

ProductAmount

decimal

Evet

Ürün fiyat bilgisi

DiscountOwnerType

int

Evet

Ürüne indirim uygulayan taraf Bkz: İndirim Sahibi Tipleri

DiscountType

int

Evet

Ürüne uygulanan indirim tipi Bkz: İndirim Tipleri

DiscountValue

decimal

Evet

Ürüne uygulanan indirim değer. Eğer Type 1 ve değer 10 ise 10(TL/USD/EURO) uygular ancak Type 2 ise %10 uygular

CargoType

int

Evet

Ürüne ait kargo tipi Bkz: Kargo Tipleri

CargoCurrencyId

int

Evet

Kargo maliyetinin para birimi

CargoCost

decimal

Evet

Kargo maliyeti

MemberId

int

Evet/Hayır

MarketPlace modeli için zorunludur. Alt üye işyerinin PayWall sistemindeki MemberId bilgisiyle doldurulmalıdır

ChannelId

int

Evet

WEB, MOBILE, API gibi isteklerin hangi kanaldan alındığını raporlayabilmeniz için sizlere yardımcı olur. Bu parametreyi boş ve/veya 0 göndermeniz durumunda PayWall paneli üzerinden (Belirtilmemiş) olarak raporlayacaksınız.

TagId

int

Evet

Ödemelerinize özel etiketler oluşturabilir, bu etiketlerle faturalandırma ve raporlama ekranlarında etikete özel analizler yapabilirsiniz. Örnek: XApp-Mobile, YApp-Web. Bu etiketleri üye işyeri paneli üzerinden yapabilirsiniz.

MemberCustomCommission

bool

Hayır

Pazaryeri modelinde çalışan üye işyerlerinin, alt üye işyerlerine uyguladığı komisyon ürün bazında değişiklik gösterirse ve bu komisyon ürüne uygulanmak istenirse. Bu parametreyi TRUE gönderebilirsiniz

MemberCommission

decimal

Hayır

"MemberCustomCommission" bu parametreye bağlı olarak, ürüne uygulamak istediğiniz komisyon değerini % bazında verebilirsiniz

Servise gönderilecek örnek JSON ve örnek kodlar aşağıdaki gibidir.

{
    "PaymentDetail": {
        "Amount": 1.00,
        "MerchantUniqueCode": "22123222256226225",
        "CurrencyId": 1,
        "MerchantSuccessBackUrl": "https://www.google.com.tr/search?q=basarili",
        "MerchantFailBackUrl": "https://www.google.com.tr/search?q=basarisiz",
        "Installement": 1,
        "ChannelId": 0,
        "TagId": 0,
        "MarketPlace": {
            "BasketAmount": 1.00 // Pazaryeri ödemelerinde,
            // toplam (indirimsiz ham tutarlarla) ürünlerin yani toplam
            // sepet tutarı
        }
    },
    "Card":{
        "OwnerName":"Iyzico Kartı",
        "Number":"5528790000000008",
        "ExpireMonth":"12",
        "ExpireYear":"2030",
        "Cvv":"123",
        "UniqueCode":"",
        "CardSave": { // Ödeme'nin başarılı tamamlanması sonrasında kart kaydedilir
            "RelationalId1": "userid19283746", // Kart'ın ilişkilendirileceği değer - Zorunlu
            "RelationalId2": "", // Kart'ın ilişkilendirileceği değer - Opsiyonel
            "RelationalId3": "", // Kart'ın ilişkilendirileceği değer - Opsiyonel
            "Save": true
        }
    },
    "Customer":{
        "FullName":"FullName",
        "Phone":"5336662211",
        "Email":"enes@xcompany.com",
        "Country":"Country",
        "City":"City",
        "Address":"Address",
        "IdentityNumber":"IdentityNumber",
        "TaxNumber":"TaxNumber"
    },
    "Products":[{
        "ProductId": "ProductId",
        "ProductName": "ProductName",
        "ProductCategory": "ProductCategory",
        "ProductDescription": "ProductDescription",
        "ProductAmount": 1.0,
        "MemberId": 1881, // Sadece MarketPlace modelinde kullanılır
        "DiscountOwnerType": 0,
        "DiscountType": 0,
        "DiscountValue": 0,
        "CargoType": 0,
        "CargoCurrencyId": 0,
        "CargoCost": 0,
        "MemberCustomCommission": false,
        "MemberCommission": 1.1, // Yüzde değeri alır ve yukardaki değer TRUE ise bu değer çalışır
        "MemberEarningCalculated": true, // Üye hakedişini kendi tarafınızda hesapladığınızda TRUE
        "MemberEarning": 12 // MemberEarningCalculated true ise üyenin alacağı/gönderilecek tutar
    }]
}

Servisten dönen cevap:

ParametreTipAçıklama

ErrorCode

int

Hata kodu. İşlem başarılı ise '0' değerini döner.

Result

bool

True ya da false değeri döner. İşlem başarılı iste 'true' değerini döner.

Message

string

İşlem hatalıysa, bu hataya dair belirtilen mesajdır, locale parametresine göre dil desteği sunar.

Body

nesne

İşlem hatalıysa, bu hataya dair belirtilen kodudur.

{
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": {
        "Payment": {
            "PaymentId": 1644541, // Ödeme kimliği
            "ActivityId": 3202555, // Ödeme'nin son hareket kimliği
            "UniqueCode": "46b7ee44-6039-4cbe-bd27-c2a56df8684c", // Ödeme'ye ait PayWall kodu
            "MerchantUniqueKey": "eaaswdee322aass" // Sizin ödeme'ye atadığınız tekil kod
        }
    }
}

Last updated