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

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

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

نام	نوع	اجباری	شرح
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	تاریخ و ساعت ایجاد تراکنش

نمونه کد Node.js

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

import { ZarinPal } from 'zarinpal-node-sdk';
const zarinpal = new ZarinPal({
  accessToken: 'your-access-token'
});
async function getTransactions() {
  try {
    const transactions = await zarinpal.transactions.list({
      terminalId: 'your-terminal-id',
      filter: 'PAID',
      limit: 10,
      offset: 0,
    });
    console.log('Transactions List:', transactions);
  } catch (error) {
    console.error('Error fetching transactions:', error);
  }
}
getTransactions();