Documentation 3.0 - Transaction history and invalidate payments

Author: tymajiri

doc/get-transactions-history.md

@@ -1,6 +1,8 @@
 # Get transaction history
 
-To get transaction just simply call:
+Use the `getAccountTransactionHistory` method to retrieve the transaction history for a specific account within a given date range.
+
+## Example: Retrieve Transactions
 
 ```php
 /** @var \ThePay\ApiClient\TheClient $thePayClient */
@@ -10,20 +12,28 @@ $filter = new \ThePay\ApiClient\Filter\TransactionFilter('TP32111146804895511653
 $transactionPaginatedCollection = $thePayClient->getAccountTransactionHistory($filter);
 ```
 
-The first parameter of method **getAccountTransactionHistory** is filter object `\ThePay\ApiClient\Filter\TransactionFilter()`. All filter parameters are described in [Apiary](https://thepay.docs.apiary.io/#reference/0/merchant-level-resources/get-account-transaction-history).
+**Parameters:**
+- `$filter` - An instance of `\ThePay\ApiClient\Filter\TransactionFilter()`. (See online API documentation for all available filter options.)
+- `$page` *(optional)* — Page number.
+- `$limit` *(optional)* — Number of records per page.
 
-Second and third parameter are used for pagination, where second is page number and third is number of records per page. Parameters are not required.
+**Returns:**
 
-You will get object `ThePay\ApiClient\Model\Collection\TransactionCollection`, which contains collection of transactions, current page number, number of records per page and helper methods.
+A `ThePay\ApiClient\Model\Collection\TransactionCollection` object containing:
+- A collection of transactions
+- Current page number
+- Number of records per page
+- Includes helper methods such as `hasNextPage()` and `getPage()`
 
-You can print all records by this call:
+**Example: Iterate through all transactions**
 
 ```php
 /** @var \ThePay\ApiClient\TheClient $thePayClient */
 $from = new DateTime('2021-03-01');
 $to = new DateTime('2021-03-31');
 $filter = new \ThePay\ApiClient\Filter\TransactionFilter('TP3211114680489551165349', $from, $to);
 $page = 1;
+
 do {
     $collection = $thePayClient->getAccountTransactionHistory($filter, $page);
 

doc/invalidate-payment.md

@@ -1,20 +1,32 @@
 # Invalidate payment
 
-To cancel (invalidate) already created payment.
+Use the `invalidatePayment` method to cancel an already created payment.
+
+A payment can only be invalidated if it has not yet been completed.
+
+## Example: Invalidate a Payment
 
 ```php
 $thePayClient->invalidatePayment('49096fe3-872d-3cbe-b908-2806ae2d7c79');
 ```
 
-The only parameter of method **invalidatePayment** is a payment UID and the payment has to belong to the project which is configured in TheConfig.
+**Parameters:**
+- `$uid` - The unique identifier (UID) of the payment.
 
-Method will return void if request was successful, otherwise it throws exception (For example if you are trying to invalidate payment that was already paid). Before invalidating payment is better to check its state:
+The payment must belong to the project configured in `TheConfig`
 
+**Returns:**
+- `void` if the request was successful.
+- Throws an exception if the payment cannot be invalidated (for example, if it was already paid).
+
+**Best Practice: Check Payment State Before Invalidating**
 
 ```php
-$payment = $thePayClient->getPayment('49096fe3-872d-3cbe-b908-2806ae2d7c79');
+$paymentUid = '49096fe3-872d-3cbe-b908-2806ae2d7c79';
+$payment = $thePayClient->getPayment($paymentUid);
+
 if ($payment->getState() === PaymentState::WAITING_FOR_PAYMENT) {
-    $thePayClient->invalidatePayment('49096fe3-872d-3cbe-b908-2806ae2d7c79');
+    $thePayClient->invalidatePayment($paymentUid);
 } else {
     // payment can not be invalidated
 }