Download the PHP package firewalker/fio-client without Composer

FioClient PHP SDK

A PHP client for accessing the Fio Bank API, supporting retrieval of account statements and transactions in JSON, XML, or CSV format. The client provides raw responses as well as typed DTOs for easy consumption.

Installation

Install via Composer:

Requires PHP 8.3+.

Usage

Basic Setup

Fetch Transactions (Raw JSON)

Fetch Transactions as DTO

Fetch Last Transactions

Fetch Transactions Since a Specific ID

Set Last Transaction ID

Supported Formats

You can get responses in:

• JSON (default)
• XML
• CSV

Exceptions

• App\Exception\HttpException — HTTP response code >= 300.
• App\Exception\InvalidFormatException — invalid format passed to request.
• App\Exception\JsonException — invalid API response structure.
• \JsonException — native PHP JSON decoding errors.
• Psr\Http\Client\ClientExceptionInterface — HTTP client errors.

DTOs

The main DTO is AccountStatementDto, which contains:

• accountId
• accountNumber
• currency
• transactions — array of TransactionDto objects

Each TransactionDto contains details such as:

• transactionId
• date
• amount
• counterpartyAccount
• counterpartyName
• variableSymbol
• message
• type
• performedBy

Use DTOs when you want typed access to transaction data. Otherwise, raw JSON gives you the full API response as an array.

Example: Iterate Transactions

Notes

• All methods are PSR-18 / PSR-17 compatible, so any HTTP client implementing these standards works.
• DTO methods always return JSON-decoded data, even if the raw request was in XML or CSV, so JSON is recommended for DTOs.
• The client throws explicit exceptions for HTTP, invalid formats, and JSON errors.

License

MIT