لیست تراکنش‌ها

متد لیست تراکنش‌ها به شما این امکان را می‌دهد که تمامی تراکنش‌های مربوط به یک ترمینال خاص را دریافت کنید. این متد می‌تواند برای مشاهده وضعیت تراکنش‌ها و فیلتر کردن آن‌ها استفاده شود.

پارامترهای ورودی

نام	نوع	اجباری	شرح
terminal_id	String	بله	شناسه ترمینال درگاه مورد نظر
filter	String	خیر	فیلتر بر اساس وضعیت تراکنش‌ها (اختیاری): PAID، VERIFIED، TRASH، ACTIVE، REFUNDED
offset	Integer	خیر	شروع ردیف‌های بازگشتی (اختیاری)
limit	Integer	خیر	تعداد ردیف‌های بازگشتی (اختیاری)

اطلاعات خروجی

در صورت موفقیت، اطلاعات زیر از API دریافت می‌شود:

نام	نوع	شرح
id	String	شناسه تراکنش
status	String	وضعیت تراکنش (مثلاً PAID، FAILED)
amount	Integer	مبلغ تراکنش به ریال
description	String	توضیحات مربوط به تراکنش
created_at	String	تاریخ و ساعت ایجاد تراکنش

نمونه کد Python

در ادامه نمونه‌ای از پیاده‌سازی متد لیست تراکنش‌ها در Python آمده است:

from zarinpal import ZarinPal
from utils.Config import Config
def get_transactions():
    try:
        config = Config(
            access_token= "Your Token",
        )
        zarinpal = ZarinPal(config)
        transactions = zarinpal.transactions.list({
            "terminal_id": "Your terminal ID",
            "filter": "PAID",  
            "limit": 10,  
            "offset": 0,
        })
        print("Transactions List:", transactions)
    except Exception as e:
        print("Error fetching transactions:", e)
if __name__ == "__main__":
    get_transactions()