# Get first page of transactions with default pagination
curl -X GET "{{host}}/api/v1/transactions" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

# Filter by currency ID with custom pagination
curl -X GET "{{host}}/api/v1/transactions?currency_id=1&limit=20&page=1" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

# Filter by transaction type (CREDIT only)
curl -X GET "{{host}}/api/v1/transactions?transaction_type=CREDIT" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

# Filter by status
curl -X GET "{{host}}/api/v1/transactions?status=COMPLETED&limit=50" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

# Filter by date range
curl -X GET "{{host}}/api/v1/transactions?start_date=2025-01-01T00:00:00Z&end_date=2025-01-31T23:59:59Z" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

# Filter by amount range
curl -X GET "{{host}}/api/v1/transactions?min_amount=100&max_amount=1000" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

# Sort by amount in ascending order
curl -X GET "{{host}}/api/v1/transactions?sort=%7B%22field%22%3A%22amount%22%2C%22direction%22%3A%22ASC%22%7D" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

<?php
function listTransactions($token, $filters = []) {
    $defaultFilters = [
        'page' => 1,
        'limit' => 50
    ];

    $params = array_merge($defaultFilters, $filters);

    // Handle sort parameter
    if (isset($params['sort']) && is_array($params['sort'])) {
        $params['sort'] = json_encode($params['sort']);
    }

    $queryString = http_build_query($params);
    $url = '{{host}}/api/v1/transactions?' . $queryString;

    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            'Authorization: Bearer ' . $token,
            'Accept: application/json'
        ],
        CURLOPT_HEADER => true
    ]);

    $response = curl_exec($ch);
    $headerSize = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
    $headers = substr($response, 0, $headerSize);
    $body = substr($response, $headerSize);
    curl_close($ch);

    // Parse pagination headers
    $pagination = [];
    if (preg_match('/X-Page: (\d+)/', $headers, $matches)) {
        $pagination['current_page'] = (int)$matches[1];
    }
    if (preg_match('/X-Total-Count: (\d+)/', $headers, $matches)) {
        $pagination['total_count'] = (int)$matches[1];
    }
    if (preg_match('/X-Total-Pages: (\d+)/', $headers, $matches)) {
        $pagination['total_pages'] = (int)$matches[1];
    }

    return [
        'transactions' => json_decode($body, true),
        'pagination' => $pagination
    ];
}

// Example: Get recent transactions
$result = listTransactions('YOUR_ACCESS_TOKEN', [
    'limit' => 20,
    'page' => 1
]);

foreach ($result['transactions'] as $txn) {
    echo "Transaction #{$txn['id']}: {$txn['amount']}\n";
    echo "  Type: {$txn['transaction_type']}\n";
    echo "  Status: {$txn['status']}\n";
    echo "  Date: {$txn['created_at']}\n\n";
}

// Display pagination info
echo "Page {$result['pagination']['current_page']} of {$result['pagination']['total_pages']}\n";
echo "Total transactions: {$result['pagination']['total_count']}\n";
?>

# Get specific transaction by ID
curl -X GET "{{host}}/api/v1/transactions/1003" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

<?php
function getTransaction($token, $transactionId) {
    $url = '{{host}}/api/v1/transactions/' . $transactionId;

    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            'Authorization: Bearer ' . $token,
            'Accept: application/json'
        ]
    ]);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($httpCode === 404) {
        throw new Exception("Transaction not found");
    }

    if ($httpCode !== 200) {
        throw new Exception("API Error: HTTP $httpCode");
    }

    return json_decode($response, true);
}

// Usage
try {
    $transaction = getTransaction('YOUR_ACCESS_TOKEN', 1003);

    echo "Transaction ID: {$transaction['id']}\n";
    echo "Amount: {$transaction['amount']}\n";
    echo "Type: {$transaction['transaction_type']}\n";
    echo "Status: {$transaction['status']}\n";

    // Display forex details if present
    if ($transaction['forex_rate']) {
        echo "Forex Rate: {$transaction['forex_rate']}\n";
        echo "Conversion Charges: {$transaction['conversion_charges']}\n";
        echo "From: {$transaction['source_currency']}\n";
        echo "To: {$transaction['destination_currency']}\n";
    }

} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}
?>

# Get all transactions for reconciliation
curl -X GET "{{host}}/api/v1/transactions?limit=1000&sort=%7B%22field%22%3A%22created_at%22%2C%22direction%22%3A%22ASC%22%7D" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

# Get all credit transactions
curl -X GET "{{host}}/api/v1/transactions?transaction_type=CREDIT" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

# Get transactions for a specific wallet
curl -X GET "{{host}}/api/v1/transactions?wallet_id=101" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

# Get transactions in a specific currency
curl -X GET "{{host}}/api/v1/transactions?currency_id=1" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

<?php
class TransactionClient {
    private $baseUrl;
    private $token;

    public function __construct($baseUrl, $token) {
        $this->baseUrl = $baseUrl;
        $this->token = $token;
    }

    /**
     * List transactions with filtering
     */
    public function listTransactions($filters = [], $limit = 50, $page = 1) {
        $params = [
            'limit' => $limit,
            'page' => $page
        ];

        // Merge additional filters
        $params = array_merge($params, $filters);

        $queryString = http_build_query($params);
        $url = $this->baseUrl . '/api/v1/transactions?' . $queryString;

        $ch = curl_init($url);
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER => [
                'Authorization: Bearer ' . $this->token,
                'Accept: application/json'
            ]
        ]);

        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);

        if ($httpCode !== 200) {
            throw new Exception("API Error: HTTP $httpCode");
        }

        return json_decode($response, true);
    }

    /**
     * Get transaction by ID
     */
    public function getTransaction($transactionId) {
        $url = $this->baseUrl . '/api/v1/transactions/' . $transactionId;

        $ch = curl_init($url);
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER => [
                'Authorization: Bearer ' . $this->token,
                'Accept: application/json'
            ]
        ]);

        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);

        if ($httpCode === 404) {
            return null;
        }

        if ($httpCode !== 200) {
            throw new Exception("API Error: HTTP $httpCode");
        }

        return json_decode($response, true);
    }

    /**
     * Calculate total credits
     */
    public function getTotalCredits($filters = []) {
        $filters['transaction_type'] = 'CREDIT';
        $transactions = $this->listTransactions($filters, 10000);

        $total = 0;
        foreach ($transactions as $txn) {
            $total += $txn['amount'];
        }

        return $total;
    }

    /**
     * Calculate total debits
     */
    public function getTotalDebits($filters = []) {
        $filters['transaction_type'] = 'DEBIT';
        $transactions = $this->listTransactions($filters, 10000);

        $total = 0;
        foreach ($transactions as $txn) {
            $total += abs($txn['amount']);
        }

        return $total;
    }

    /**
     * Get transaction summary
     */
    public function getTransactionSummary($filters = []) {
        $transactions = $this->listTransactions($filters, 10000);

        $summary = [
            'total_transactions' => count($transactions),
            'total_credits' => 0,
            'total_debits' => 0,
            'net_amount' => 0,
            'pending_count' => 0,
            'completed_count' => 0,
            'failed_count' => 0
        ];

        foreach ($transactions as $txn) {
            if ($txn['transaction_type'] === 'CREDIT') {
                $summary['total_credits'] += $txn['amount'];
            } else {
                $summary['total_debits'] += abs($txn['amount']);
            }

            $summary['net_amount'] += $txn['amount'];

            switch ($txn['status']) {
                case 'PENDING':
                    $summary['pending_count']++;
                    break;
                case 'COMPLETED':
                    $summary['completed_count']++;
                    break;
                case 'FAILED':
                    $summary['failed_count']++;
                    break;
            }
        }

        return $summary;
    }
}

// Usage example
$client = new TransactionClient('{{host}}', 'YOUR_ACCESS_TOKEN');

try {
    // Get all transactions for currency ID 1
    $usdTransactions = $client->listTransactions(['currency_id' => 1]);
    echo "Total transactions: " . count($usdTransactions) . "\n";

    // Get credit transactions only
    $creditTransactions = $client->listTransactions(['transaction_type' => 'CREDIT'], 100);
    echo "Credit transactions: " . count($creditTransactions) . "\n";

    // Get transactions for a specific wallet
    $walletTransactions = $client->listTransactions(['wallet_id' => 101], 50);
    echo "Wallet #101 transactions: " . count($walletTransactions) . "\n";

    // Get specific transaction
    $transaction = $client->getTransaction(1003);
    if ($transaction) {
        echo "Transaction Amount: {$transaction['amount']}\n";
    }

    // Get transaction summary
    $summary = $client->getTransactionSummary(['currency_id' => 1]);
    echo "Total Credits: {$summary['total_credits']}\n";
    echo "Total Debits: {$summary['total_debits']}\n";
    echo "Net Amount: {$summary['net_amount']}\n";
    echo "Completed: {$summary['completed_count']}\n";

} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}
?>