search
Test Panel 🧪Paywall 📟Servis Durumu 📊

1. Satış

Terminallerinize sync satış emri göndermek için bu servisi kullanabilirsiniz

POST {{Base Address}}/api/payment/sync/sale

Yukarıda verilmiş olan adrese istek atmanız yeterli olacaktır. Test ortamı ve Gerçek ortam için 'Base Address' istediğiniz gibi kullanabilirsiniz.

circle-info

Önemli: Sync Satış servisini kullanabilmeniz için 'Header' alanında 'apikeyprivate' ve 'apiclientprivate' parametrelerini göndermeniz gerekmektedir. PhysicalAPI Adresi

hashtag
Servise gönderilmesi gereken header bilgileri şu şekildedir:

Parametre
Tip
Zorunlu
Açıklama

apikeyprivate

string

Evet

Üye işyeri panelinden temin etmiş olduğunuz Private Key.

apiclientprivate

string

Evet

Üye işyeri panelinden temin etmiş olduğunuz Private Client.

Servise gönderilmesi gereken body bilgileri şu şekildedir:

{
    "TerminalId": "8ff33705-57c7-42dc-8341-a0053e7f3009",
    "SendNotificationDeviceDisconnected": false,
    // "TerminalTagCode": "testpos",
    "MerchantUniqueCode": "{{$guid}}",
    "DisplayCode": "Kişisel Bakım",
    "Amount": 22,
    "CurrencyId": 1,
    "Methods": [
        {
            "PaymentMethodId": 1
        }
    ],
    "CallbackAddress": "https://webhook.site/4768e8e7-12c9-4c3f-949c-c7a616e72acf",
    "SplitPaymentSupport": false,
    "Customer": {
        "Type": 1,
        "FirstName": "eda",
        "MiddleName": "seda",
        "LastName": "meda",
        "CompanyName": "",
        "TaxOfficeCode": "",
        "TaxNumber": "",
        "Phone": "",
        "Email": "",
        "Identity": "11111111110",
        "Country": "Türkiye",
        "City": "İstanbul",
        "District": "Mesela",
        "Neighborhood": "Öyle",
        "Address": "Tam sokağın ortası"
    },
    "Products": [
        {
            "Name": "Saç Tıraşı",
            "TaxGroupId": 10,
            "UnitCodeId": 1,
            "Amount": 22,
            "Quantity": 1,
            "PaymentMethodId": 2
        }
    ],
    "SkipPrintCustomer": false,
    "SkipPrintMerchant": false,
    "SkipPaymentOptionScreen": false,
    "ReceiptOptions": { // Opsiyonal
        "TopSupport": true,
        "Top": {
            "Text": "Üst başlık",
            "FontSize": 10
        },
        "BottomSupport": true,
        "Bottom": {
            "Text": "Alt başlık",
            "FontSize": 50
        }
    }
}
Parametre
Tip
Zorunlu
Uzunluk
Açıklama

string

Evet/Hayır

Guid

Terminalinizin kimlik (Id) bilgisiniz

bool

Hayır

-

Cihaz Paywall sunucularına bağlı değilse (kilitli modda) ödemeler push bildirimi olarak iletilsin mi?

string

Evet

25

Etiket kodu

Guid

Evet

-

Ödemenin sizin tarafınızdan oluşturulan takip numarası

bool

Hayır

-

Her ürün özelinde ödeme almak için kullanılır

decimal

Evet

-

Satış tutarı

string

Hayır

25

Ödemenin terminalde görüntülenmesi anında görülecek ödeme kodu

string

Evet

-

Bkz: Para Birimi

string

Hayır

150

Ödeme durumunu ilettiğimiz geri bildirim adresiniz Bkz: Örnek

Array<Method>

Hayır

-

Ödemenin hangi yöntemleri desteklemesini istediğinizi bu parametrelerle belirleyebilirsiniz

Customer

Hayır

-

Ödemenin gerçekleştirildiği müşterinin bilgileri

Array<Product>

Evet

-

Ürün bilgileri

bool

Hayır

-

Müşteri fişinin çıktı alma işlemi yapılmaz

bool

Hayır

-

Kurum fişinin çıktı alma işlemi yapılmaz

bool

Hayır

-

Ödeme anında kartlı işlem detay ekranı ekranda gösterilmez (Taksit vb)

ReceiptOptions

Hayır

-

Ödeme sonrasında çıkacak fiş için özel ayarlamalar

Yöntem Nesnesi <Method>

Parametre
Tip
Zorunlu
Uzunluk
Açıklama

int

Evet

-

Ödeme Yöntemleri

Yöntem Nesnesi <ReceiptOptions>

Parametre
Tip
Zorunlu
Uzunluk
Açıklama

bool

Evet

-

Fiş'in üst kısmına yazı konumlandırılacak mı?

string

Evet

150

Fiş'in üst kısmına yazılacak bilgi

int

Evet

2

Fiş'in üst kısmına yazılacak bilginin boyutu

bool

Evet

-

Fiş'in alt kısmına yazı konumlandırılacak mı?

string

Evet

150

Fiş'in alt kısmına yazılacak bilgi

int

Evet

2

Fiş'in alt kısmına yazılacak bilginin boyutu

Müşteri Nesnesi <Customer>

Parametre
Tip
Zorunlu
Uzunluk
Açıklama

int

Evet

-

Müşteri Tipleri Bkz: Tipleri

string

Evet/Hayır

50

Müşteri adı

string

Hayır

50

Müşteri 2. adı

string

Evet/Hayır

50

Müşteri soyadı

string

Evet/Hayır

175

Şirket ismi

string

Evet/Hayır

50

Şirket vergi daire kodu

string

Evet/Hayır

25

Şirket vergi numarası

string

Hayır

20

Telefon

string

Hayır

100

Eposta adresi

string

Evet/Hayır

20

Kimlik numarası

string

Hayır

50

Ülke

string

Hayır

100

Şehir

string

Hayır

100

Semt/Mahalle

string

Hayır

100

Sokak

string

Hayır

255

Açık adres

Ürün Nesnesi <Product>

Parametre
Tip
Zorunlu
Uzunluk
Açıklama

string

Evet

75

Ürün adı

int

Evet

-

Ürünün KDV dilimi Bkz: Vergi Grubu

int

Evet

-

Ürünün birim bilgisi Bkz: Birim Kodları

string

Evet

-

Bkz: Para Birimi

decimal

Evet

150

Ürün tutarı Not: Ürün tutarlarının toplamı satış tutarına eşit olmalıdır

int

Evet

-

Ürün adedi

Servisten dönen cevap:

Parametre
Tip
Açıklama

Result

object

Servisin detayındaki bilgileri döner

ErrorCode

int

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

Succeeded

bool

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

Failed

bool

True ya da false değeri döner. İşlem başarısız 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.

ClientMessage

string

Paywall hata kodlarının sabit değerlerini döner. Map'leme yapabilirsiniz

Parametre
Tip
Açıklama

Guid

Async ödemenin Paywall'daki kimlik bilgisidir. Saklanmalıdır

Guid

Async ödemenin son hareketinin kimlik bilgisidir

int

Async ödemenin son işlem tipi Bkz: Ödeme Tipi

int

Async ödemenin son durumu Bkz: Ödeme Durumu

PreviousSyncNext2. Satış Geri Çek

Last updated