İşlem Listeleme

Postapos tarafında firmaya ait çekilen kartların işlem detayını almaya yarayan servistir. İşlem listesi sayesinde çekilen kart bilgilerini detaylı bir şekilde alabilirsiniz.

Bu servisi kullanabilmeniz için API Key bilgisine sahip olmanız gerekiyor. API Key bilgisi için "Nasıl Erişirim ?" Sayfasını kontrol ediniz.

Servis URL Adresi :

https://api.postapos.com/paymentList

Tarih Aralığı Sınırlaması: Sistem üzerinde sorgulama yaparken, başlangıç tarihi (b_date) ve bitiş tarihi (d_date) arasındaki süre en fazla 30 gün olabilir. Bu sınırlama, veri bütünlüğünü korumak ve performansı optimize etmek amacıyla uygulanmaktadır.

Status Durumu ve Sonuçları: Eğer status değeri false olarak gelirse, sistem tüm işlemleri (başarılı, başarısız, iptal edilen ve iade edilen) listeleyecektir. Bu durumda, aşağıdaki durum kodlarına göre filtreleme yapılabilir:

• Başarılı İşlemler : 2

• Başarısız İşlemler : 3

• İptal Edilen İşlemler : 4

• İade Edilen İşlemler : 5

Bu durum kodları, işlemlerin durumunu net bir şekilde sınıflandırmak ve raporlamak için kullanılmaktadır.

Servis Paremetreleri

Adı	Tip	Zorunlu	Açıklama
b_date	date	Evet	Başlangıç Tarihi Format (YYYY/MM/DD)
d_date	date	Evet	Bitiş Tarihi Format (YYYY/MM/DD)
status	int	Evet	İşlem durumu
sub_dealers_id	int	false	Sadece bir müşteriye ait verileri listelemek için bayi id'sini iletin

Dönüş Paremetreleri

Adı	Tip	Açıklama
id	int	İşleme ait ID Numarası
status	int	İşlem Durumu
payment_date	datetime	İşlem Tarihi
due_date	date	Vade Tarihi
process_no	string	İşlem Numarası
customer_id	int	Müşteri ID Numarası
customer_code	string	Müşteri Özel Kodu
ent_code	string	Muhasebe Cari Kodu Özel
ozel_code_1	string	Müşteri Özel Alan Kodu 1
ozel_code_2	string	Müşteri Özel Alan Kodu 2
company	string	Müşteri Firma Adı
pos_id	string	Kullanılan Pos ID Numarası
pos	string	Kullanılan Pos
card_bank_name	string	Kartın Bankası
card_brand	string	Kartın Markası
card_type	string	Kartın Tipi
card_bin	int	Karta Ait Bin Numarası
card_number	string	Maskelenmiş Kart Numarası
card_name	string	Kart Sahibi Adı Soyadı
money_unit	string	Kullanılan Para Birimi
money_name	string	Kullanılan Para Birimi Adı
money_rate	decimal	Döviz Kuru
money_rate_price	decimal	Döviz Kuru Para Birimi
installment	int	Taksit Sayısı (1 - Tek Çekim)
net_price	decimal	Girilen İşlem Tutarı
commission	decimal	Banka Komisyon Oranı
commission_price	decimal	Banka Komisyon Kesinti Tutarı
total_price	decimal	Karttan Çekilen Net Tutar
net_total_price	decimal	Hesaba Geçecek Net Tutar
description	string	Kullanıcı Açıklama/Not

Request

array(
  'b_date' => '2024-10-01',
  'd_date' => '2024-10-02',
  'status' => '2-3',
  'sub_dealers_id' => false
);

Response

{
    "status":200,
    "info":{
        "total":23
    },
"result":
    {
        "id":69,
        "status":2,
        "payment_date":"2024-10-02 00:00:00",
        "due_date":"2024-10-05",
        "process_no":"X24101053458",
        "customer_id":"1916",
        "customer_code":"BY00001",
        "ent_code":"CHR00050",
        "ozel_code_1":null,
        "ozel_code_2":null,
        "company":"FİNERPO YAZILIM VE DANIŞMANLIK A.Ş.",
        "pos_id":"1",
        "pos":"Garanti Pos",
        "card_bank_name":"T. VAKIFLAR BANKASI T.A.O.",
        "card_brand":"MasterCard",
        "card_type":"Credit Card",
        "card_bin":547244,
        "card_number":"547244******8006",
        "card_name":"ELİF KAYA",
        "money_unit":"TRY",
        "money_name":"TÜRK LİRASI",
        "money_rate":null,
        "money_rate_price":null,
        "installment":1,
        "net_price":"2420.02",
        "commission":"2.90",
        "commission_price":"72.28",
        "total_price":"2492.30",
        "net_total_price":"2420.02",
        "description":null
    }
}