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:
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 | - | 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 |
Yöntem Nesnesi <Method>
Parametre | Tip | Zorunlu | Uzunluk | Açıklama |
---|---|---|---|---|
int | Evet | - | Ödeme Yöntemleri |
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 | - | Ü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çılama |
---|---|---|
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 |
Last updated