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.

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

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:

Json

{
    "TerminalId": "38e895c3-1a9a-4b73-8816-8557d1d031d6",
    // "TerminalTagCode": "",
    "MerchantUniqueCode": "{{$guid}}",
    "DisplayCode": "Kişisel Bakım",
    "Amount": 22,
    "CurrencyId": 1,
    "Methods": [
        {
            "PaymentMethodId": 1
        },
        {
            "PaymentMethodId": 2
        }
    ],
    "CallbackAddress": "https://webhook.site/276d912e-090e-461a-aad5-5f137ab03cf4",
    "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
        }
    ]
}

Parametre	Tip	Zorunlu	Uzunluk	Açıklama
	string	Evet/Hayır	Guid	Terminalinizin kimlik (Id) bilgisiniz
	string	Evet	25	Etiket kodu
	Guid	Evet	-	Ödemenin sizin tarafınızdan oluşturulan takip numarası
	decimal	Evet	-	Satış tutarı
	string	Hayır	25	Ödemenin terminalde görüntülenmesi anında görülecek ödeme kodu
	string	Evet	-
	string	Hayır	150
	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

Yöntem Nesnesi <Method>

Parametre	Tip	Zorunlu	Uzunluk	Açıklama
	int	Evet	-

Müşteri Nesnesi <Customer>

Parametre	Tip	Zorunlu	Uzunluk	Açıklama
	int	Evet	-	Müşteri 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	-
	int	Evet	-
	string	Evet	-
	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

Json

{
    "Result": {
        "PaymentRequestId": "1eb856a8-1d41-49ab-8994-ecee2880d62c",
        "PaymentRequestActivityId": "2015c508-4029-4f6b-b7e2-4bf34a213c41",
        "PaymentRequestActivityTypeId": 1,
        "PaymentStatus": 4
    },
    "Failed": false,
    "Message": null,
    "ClientMessage": null,
    "Succeeded": true
}

Parametre	Tip	Açıklama
	Guid	Async ödemenin PayWall'daki kimlik bilgisidir. Saklanmalıdır
	Guid	Async ödemenin son hareketinin kimlik bilgisidir
	int
	int