HGS Bakiye ve Hareket Sorgula

Bu API müşterinin yetkili olduğu ürünün bakiye ve hareket bilgilerini getirmektedir. Sorgu sonucunda sayfa başına maksimum 1000 kayıt gelmektedir. Başlangıç ve bitiş tarih aralığı maksimum 1 yıl olmalıdır.

API Bilgileri

URL

/FPSInquireBalanceTransaction

Metot

POST

Versiyon

1.0

Scope

payment

Yetkilendirme Yöntemi

Authorization Code
B2B Credentials


Girdi Bilgileri

Alan Adı Format Açıklama Zorunlu/Opsiyonel

PassProductID

Integer Geçiş ürün tanım id Zorunlu

StartDate

yyyy-MM-dd Başlangıç tarihi Zorunlu

EndDate

yyyy-MM-dd Bitiş tarihi Zorunlu

PageNumber

Integer Sayfa numarası
Her bir sayfa maksimum 1000 kayıt içerecektir. Varsayılan değer 0’dır.
Opsiyonel

TransactionStatusCode

Integer Hareket durum kodu
0: Tümü, 1: Başarılı, 2: Hatalı
Opsiyonel


Çıktı Bilgileri

List< BalanceTransactionInfo >

Alan Adı Format Açıklama

ProductNumber

Integer Ürün numarası

ProductType

Integer Ürün türü
1: HGS, 2: OGS

NumberPlate

String Plaka numarası

AccountCardNumber

String Hesap/Maskeli kart numarası

AccountType

Integer Hesap türü
1: Hesap, 2: Kart

TransactionAmount

Decimal İşlem tutarı

NewBalance

Decimal Bakiye

TransactionId

Integer İşlem id

TransactionType

Integer İşlem tipi

TransactionTypeDescription

String İşlem tipi açıklaması

Description

String Detaylı işlem açıklaması

CurrencyCode

String Döviz kodu

TransactionStatusCode

Integer Hareket durum kodu

TransactionDate

yyyy-MM-ddTHH24:mm:ss İşlem tarihi


Mesaj Kodları

Mesaj Kodu Açıklama

ACBH000025

Başlangıç tarihi formatı hatalıdır.

ACBH000026

Bitiş tarihi formatı hatalıdır.

ACBH000100

Başlangıç tarihi bitiş tarihinden büyük olamaz.

ACBH000134

Tarih aralığı maksimum 1 yıl olmalıdır.

ACBH000137

İşlem yapmak istediğiniz ürün oturumdaki müşteri numarasına ait değildir.

ACBH000154

Hareket bulunamadı.

ACBH000174

İlgili işlem bireysel müşteri numarası ile yapılamaz.

ACBH000247

İşlem durum kodu alanına geçersiz değer girildi.

ACBH000248

Başlangıç tarihi boş olamaz.

ACBH000249

Bitiş tarihi boş olamaz.

Örnek

İstek:

{
  "TransactionStatusCode": 1,
    "StartDate":"2018-02-14",
    "EndDate" : "2018-02-15",
    "PageNumber" : 0,
    "PassProductID":141003
}

Cevap:

{
    "Header": {
        "StatusCode": "APIGW000000",
        "StatusDescription": "Completed",
        "ObjectID": "10477f97-a763-450e-b2ef-a2743b49ec72"
    },
    "Data": {
        "BalanceTransactionInfo": {
            "NumberPlate": "00AAA00",
            "TransactionType": 10,
            "Description": "HGS Müşteri No: 43210, HGS Etiket No: 1106504486, Plaka No:00AAA00,  Satış Ücreti: 15,00, İlk Yükleme Tutarı:50,00, HGS Satış ve İlk Dolum Tahsilatı",
            "AccountCardNumber": "5421********1604",
            "ProductType": 1,
            "ProductNumber": 1106504486,
            "AccountType": 1,
            "TransactionId": 2018000000649002,
            "TransactionAmount": 50,
            "CurrencyCode": "TL",
            "NewBalance": 50,
            "TransactionTypeDescription": "Satış İşlemi",
            "TransactionStatusCode": 1,
            "TransactionDate": "2018-02-14T16:25:46"
        }
    }
}