1. Oluştur

Ortak ödeme sayfası oluşturma akışı, müşterilerinize ait kart bilgilerini kendi siteniz/uygulamanız üzerinden almak istemediğinizde tercih edebileceğiniz bir yöntemdir

Ortak Ödeme Sayfası Oluştur

POST {{BaseAddress}}/api/paywall/checkout/generate

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

Ortak ödeme sayfasına ExpireDateTime tanımlanmadığı durumda, ortak ödeme sayfaları varsayılan olarak 10 dakika süre boyunca geçerli olur

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

Parametre
Tip
Zorunlu
Açıklama

UniqueCode

string

Evet

Ödeme'nin sizin tarafınızdaki takip/sipariş/sepet kodu

Amount

decimal

Evet

Ürün/Hizmet tutarı

LanguageId

int

Hayır

CurrencyId

int

Evet

CallbackSupport

bool

Evet

Başarılı ödeme sonuçları bir adrese geribildirim olarak POST atılır

CallbackAddress

string

Hayır

Başarılı ödeme sonuçlarının geribildirim atılacağı adres

InstallmentSupport

bool

Evet

Taksit seçenekleri ekranda görünsün mü?

InstallmentDynamic

bool

Hayır

Taksit seçenekleri aktif sağlayıcılarınız arasındaki aktif taksitleriniz kullanılarak listelenebilir. Bu listeleme kullanıcının girdiği kart ailesi bağlı olarak yapılacaktır.

SuccessBackUrl

string

Evet

Başarılı ödeme sonucunda yönlendirilecek sayfa

FailBackUrl

string

Evet

Başarısız ödeme sonucunda yönlendirilecek sayfa

Force3D

bool

Evet

Ortak ödeme sayfasında kullanıcı "Güvenli Ödeme" için zorlansın mı?

ShowProduct

bool

Evet

Ödemeye konu olan ürünler ortak ödeme sayfasında listelensin mi?

ExpireDateTime

datetime

Hayır

Ortak ödeme sayfasının yaşam süresi. Sizin tarafınızdan da belirlenebilir, belirlenmediği taktirde 10 dakika olarak belirlenir

Products

List<Products>

Hayır

Ödemeye konu olan ürün bilgileri (İzin verilmesi durumunda ortak ödeme sayfasında listelenir)

Customer

Customer

Hayır

Ödemeye konu olan müşteri bilgileri (Ortak ödeme sayfasında görüntülenmez. Raporlamalarda kullanılır)

CardWallSupport

bool

Hayır

Ortak ödeme sayfasında kayıtlı kart desteğini aktif etmek için kullanabilirsiniz.

CardWallRelationalId1

string

Hayır

Kart'ın ilişkilendirilmesi istenen unique bilgi

CardWallRelationalId2

string

hayır

Kart'ın ilişkilendirilmesi istenen unique ikinci bilgi (listeleme anında tüm bilgiler gönderilmelidir)

CardWallRelationalId3

string

Hayır

Kart'ın ilişkilendirilmesi istenen unique üçüncü bilgi (listeleme anında tüm bilgiler gönderilmelidir)

PayWatchSupport

bool

Hayır

Ödemeler PayWatch ile izlensin mi? (Sadece 'Başladı' durumunda olanlar)

PayWatchMin

short

Evet (Koşullu)

PayWatch ödeme işleminin kaç dakika sonrasında çalışsın? Minimum: 5 | Maksimum: 20

PayWatchCallbackAddress

string

Hayır

Dolu gönderilmesi durumunda PayWatch'ın tespit ettiği ödemedeki değişiklik sonrasında belirtilen adrese geri bildirim atılır

Yukardaki parametreler içerisindeki Products:

Parametre
Tip
Zorunlu
Açıklama

ProductId

string

Hayır

Ürününüzün sisteminizdeki kimliği

ProductImage

string

Hayır

Ürününüzün görseline ait url

ProductName

string

Hayır

Ürününüzün adı

ProductCategory

string

Hayır

Ürününüzün kategorisi

ProductDescription

string

Hayır

Ürününüzün açıklaması

ProductAmount

decimal

Hayır

Ürününüzün tutarı

Yukardaki parametreler içerisindeki Customer:

Parametre
Tip
Zorunlu
Açıklama

FullName

string

Hayır

Müşteri ad/soyad

Phone

string

Hayır

Müşteri telefon numarası

Email

string

Hayır

Müşteri E-Posta

Country

string

Hayır

Ülke

City

string

Hayır

Şehir

Address

decimal

Hayır

Açık Adres

IdentityNumber

string

Hayır

Bireysel Müşteri

TaxNumber

string

Hayır

Kurumsal Müşteri

Servise gönderilecek örnek bir JSON dosyası şu şekildedir :

{
    "UniqueCode": "AFDKJAS343AGNGF43",
    "Amount": 21,
    "CurrencyId": 1,
    "CallbackSupport": false,
    "CallbackAddress": "",
    "InstallmentSupport": true,
    "SuccessBackUrl": "https://paywall.one/?success",
    "FailBackUrl": "https://paywall.one/?unsuccess",
    "Force3D": true,
    "ShowProduct": true,
    "Customer":{
        "FullName":"Enes Selman Tütüncü",
        "Phone":"5554443322",
        "Email":"enes@itspaywall.com",
        "Country":"Türkiye",
        "City":"İstanbul",
        "Address":"Beyoğlu Taksim",
        "IdentityNumber":"11111111111",
        "TaxNumber":""
    },
    "Products": [
        {
            "ProductId": "1",
            "ProductImage": "https://f-asc-l.mncdn.com/webfiles/banners/638109384852337077-4-4lu-768x768px.jpg?v=1675342011",
            "ProductName": "Test Product",
            "ProductCategory": "Category",
            "ProductDescription": "Description",
            "ProductAmount": 10.5
        },
        {
            "ProductId": "1",
            "ProductImage": "https://f-asc-l.mncdn.com/webfiles/banners/638109384852337077-4-4lu-768x768px.jpg?v=1675342011",
            "ProductName": "Test Product",
            "ProductCategory": "Category",
            "ProductDescription": "Description",
            "ProductAmount": 10.5
        }
    ],
    "CardWallSupport": false,
    "CardWallRelationalId1": "",
    "CardWallRelationalId2": "",
    "CardWallRelationalId3": "",
    "ExpireDateTime": null,
    "PayWatchSupport": true,
    "PayWatchMin": 5, // Minimum: 5 | Maksimum: 20
    "PayWatchCallbackAddress": "https://webhook.site/754358c8-22a5-41b7-a83d-9eade37c8b20"
}

Servisten dönen parametreler şu şekildedir:

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

string

Link parametresi altında ödeme linkini döner

{
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": {
        "Id": 13284456,
        "Guid": "a2319b22-b442-4b9d-bc87-b800be680761",
        "UniqueCode": "OAEASG54455565256792",
        "Amount": 25.0,
        "Link": "https://dev-checkout.itspaywall.com/checkout/?CheckoutId=a2319b22-b442-4b9d-bc87-b800be680761"
    }
}

Last updated