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:

ParametreTipZorunluAçı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": "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
        }
    ]
}
ParametreTipZorunluUzunlukAçıklama
TerminalId

string

Evet/Hayır

Guid

Terminalinizin kimlik (Id) bilgisiniz

TerminalTagCode

string

Evet

25

Etiket kodu

MerchantUniqueCode

Guid

Evet

-

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

Amount

decimal

Evet

-

Satış tutarı

DisplayCode

string

Hayır

25

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

CurrencyId

string

Evet

-

Bkz: Para Birimi

CallbackAddress

string

Hayır

150

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

Methods

Array<Method>

Hayır

-

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

Customer

Customer

Hayır

-

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

Products

Array<Product>

Evet

-

Ürün bilgileri

Yöntem Nesnesi <Method>

ParametreTipZorunluUzunlukAçıklama
PaymentMethodId

int

Evet

-

Ödeme Yöntemleri

Müşteri Nesnesi <Customer>

ParametreTipZorunluUzunlukAçıklama
Type

int

Evet

-

Müşteri Tipleri

FirstName

string

Evet/Hayır

50

Müşteri adı

MiddleName

string

Hayır

50

Müşteri 2. adı

LastName

string

Evet/Hayır

50

Müşteri soyadı

CompanyName

string

Evet/Hayır

175

Şirket ismi

TaxOfficeCode

string

Evet/Hayır

50

Şirket vergi daire kodu

TaxNumber

string

Evet/Hayır

25

Şirket vergi numarası

Phone

string

Hayır

20

Telefon

Email

string

Hayır

100

Eposta adresi

Identity

string

Evet/Hayır

20

Kimlik numarası

Country

string

Hayır

50

Ülke

City

string

Hayır

100

Şehir

District

string

Hayır

100

Semt/Mahalle

Neighborhood

string

Hayır

100

Sokak

Address

string

Hayır

255

Açık adres

Ürün Nesnesi <Product>

ParametreTipZorunluUzunlukAçıklama
Name

string

Evet

75

Ürün adı

TaxGroupId

int

Evet

-

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

UnitCodeId

int

Evet

-

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

CurrencyId

string

Evet

-

Bkz: Para Birimi

Amount

decimal

Evet

150

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

Quantity

int

Evet

-

Ürün adedi

Servisten dönen cevap:

ParametreTipAçı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

{
    "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
}
ParametreTipAçıklama
PaymentRequestId

Guid

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

PaymentRequestActivityId

Guid

Async ödemenin son hareketinin kimlik bilgisidir

PaymentRequestActivityTypeId

int

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

PaymentStatus

int

Async ödemenin son durumu Bkz: Ödeme Durumu

Last updated