[ACL-69] Merchant account transactions

[stefandanaita]

This pull request introduces support for retrieving merchant account transactions, including new transaction types, interfaces, and related constants. It also updates the documentation and configuration files to reflect these changes. Below is a breakdown of the most important changes:

New Features and Enhancements:

• Merchant Account Transactions API:

  • Added a getTransactions method to the MerchantAccount class to retrieve transactions within a specified date range. This method utilizes the MerchantAccountTransactionRetrievedInterface and the entityFactory to handle transaction data. (src/Entities/MerchantAccount/MerchantAccount.php)
  • Introduced various concrete transaction classes, including MerchantAccountPayment, MerchantAccountRefund, MerchantAccountPayout, MerchantAccountExecutedPayout, and MerchantAccountPendingPayout. These classes define specific transaction types and their associated fields. [1] [2] [3] [4] [5]

• Constants for Transactions:

  • Added MerchantAccountTransactionTypes and MerchantAccountPayoutStatuses constants to define transaction type and payout status values. (src/Constants/MerchantAccountTransactionTypes.php, src/Constants/MerchantAccountPayoutStatuses.php) [1] [2]

Configuration Updates:

• Dependency Bindings:

  • Added bindings for new transaction-related interfaces to their respective entity implementations in config/bindings.php.

• Discriminators for Polymorphism:

  • Updated config/discriminations.php to include discriminators for transaction types and payout statuses, enabling polymorphic behavior for transaction entities.

Documentation:

• README Update:

  • Added an example for retrieving a merchant account's list of transactions in the README.md file. This example demonstrates the usage of the new getTransactions method.

• Changelog Update:

  • Documented the addition of merchant account transaction retrieval support in the CHANGELOG.md file under version 3.1.1.