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	Ortak ödeme sayfasının dil ayarını kullanıcı segmentinize göre değiştirebilirsiniz. Bkz: Dil Seçenekleri
CurrencyId	int	Evet	Para birimi https://paywall.gitbook.io/tr/sistem-verileri/para-birimleri
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 :

JSON

{
    "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":"[e-mail]",
        "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

JSON

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