Add credit memo transaction allocations

src/Client.php

@@ -47,6 +47,7 @@
  * @method Services\CustomerService customers()
  * @method Services\InvoiceItemService invoiceItems()
  * @method Services\CreditMemoInvoiceAllocationService creditMemoInvoiceAllocations()
+ * @method Services\CreditMemoTransactionAllocationService creditMemoTransactionAllocations()
  * @method Services\InvoiceService invoices()
  * @method Services\CreditMemoService creditMemos()
  * @method Services\PaymentCardService paymentCards()
@@ -115,6 +116,7 @@ final class Client
         'customers' => Services\CustomerService::class,
         'invoiceItems' => Services\InvoiceItemService::class,
         'creditMemoInvoiceAllocations' => Services\CreditMemoInvoiceAllocationService::class,
+        'creditMemoTransactionAllocations' => Services\CreditMemoTransactionAllocationService::class,
         'invoices' => Services\InvoiceService::class,
         'creditMemos' => Services\CreditMemoService::class,
         'paymentCards' => Services\PaymentCardService::class,

src/Entities/Schema.php

@@ -366,6 +366,12 @@ public function __construct()
             'credit-memos/{creditMemoId}' => function (array $content) {
                 return new CreditMemo($content);
             },
+            'credit-memos/{creditMemoId}/transaction-allocations' => function (array $content) {
+                return new Collection(new CreditMemoTransactionAllocation(), $content);
+            },
+            'credit-memos/{creditMemoId}/transaction-allocations/{transactionId}' => function (array $content) {
+                return new CreditMemoTransactionAllocation($content);
+            },
         ];
     }
 

src/Services/CreditMemoTransactionAllocationService.php

@@ -0,0 +1,102 @@
+<?php
+/**
+ * This source file is proprietary and part of Rebilly.
+ *
+ * (c) Rebilly SRL
+ *     Rebilly Ltd.
+ *     Rebilly Inc.
+ *
+ * @see https://www.rebilly.com
+ */
+
+namespace Rebilly\Services;
+
+use ArrayObject;
+use JsonSerializable;
+use Rebilly\Entities\CreditMemoTransactionAllocation;
+use Rebilly\Http\Exception\DataValidationException;
+use Rebilly\Http\Exception\NotFoundException;
+use Rebilly\Paginator;
+use Rebilly\Rest\Collection;
+use Rebilly\Rest\Service;
+
+/**
+ * Class CreditMemoTransactionAllocationService.
+ */
+final class CreditMemoTransactionAllocationService extends Service
+{
+    /**
+     * @param string $creditMemoId
+     * @param array|ArrayObject $params
+     *
+     * @return CreditMemoTransactionAllocation[][]|Collection[]|Paginator
+     */
+    public function paginator($creditMemoId, $params = [])
+    {
+        return new Paginator(
+            $this->client(),
+            'credit-memos/{creditMemoId}/transaction-allocations',
+            ['creditMemoId' => $creditMemoId] + (array) $params
+        );
+    }
+
+    /**
+     * @param string $creditMemoId
+     * @param array|ArrayObject $params
+     *
+     * @return CreditMemoTransactionAllocation[]|Collection
+     */
+    public function search($creditMemoId, $params = [])
+    {
+        return $this->client()->get(
+            'credit-memos/{creditMemoId}/transaction-allocations',
+            ['creditMemoId' => $creditMemoId] + (array) $params
+        );
+    }
+
+    /**
+     * @param string $creditMemoId
+     * @param string $transactionId
+     *
+     * @return CreditMemoTransactionAllocation
+     *@throws NotFoundException if resource does not exist
+     *
+     */
+    public function load($creditMemoId, $transactionId)
+    {
+        return $this->client()->get(
+            'credit-memos/{creditMemoId}/transaction-allocations/{transactionId}',
+            ['transactionId' => $transactionId, 'creditMemoId' => $creditMemoId]
+        );
+    }
+
+    /**
+     * @param string $creditMemoId
+     * @param string $transactionId
+     * @param array|JsonSerializable|CreditMemoTransactionAllocation $data
+     *
+     * @return CreditMemoTransactionAllocation
+     * @throws DataValidationException if input data is not valid
+     *
+     */
+    public function update($creditMemoId, $transactionId, $data)
+    {
+        return $this->client()->put(
+            $data,
+            'credit-memos/{creditMemoId}/transaction-allocations/{transactionId}',
+            ['transactionId' => $transactionId, 'creditMemoId' => $creditMemoId]
+        );
+    }
+
+    /**
+     * @param string $creditMemoId
+     * @param string $transactionId
+     */
+    public function delete($creditMemoId, $transactionId)
+    {
+        $this->client()->delete(
+            'credit-memos/{creditMemoId}/transaction-allocations/{transactionId}',
+            ['transactionId' => $transactionId, 'creditMemoId' => $creditMemoId]
+        );
+    }
+}

tests/Api/ServiceTest.php

@@ -441,6 +441,48 @@ public function creditMemoInvoiceAllocationsService()
         $service->delete('invoiceId', 'dummy');
     }
 
+    /**
+     * @test
+     */
+    public function creditMemoTransactionAllocationsService()
+    {
+        $client = new Client(['apiKey' => 'QWERTY']);
+
+        /** @var CurlHandler|MockObject $handler */
+        $handler = $this->createMock(CurlHandler::class);
+        $handler
+            ->method('__invoke')
+            ->willReturnOnConsecutiveCalls(
+                $client->createResponse(),
+                $client->createResponse(),
+                $client->createResponse()->withHeader('Location', 'credit-memos/creditMemoId/transaction-allocations/dummy'),
+                $client->createResponse()->withHeader('Location', 'credit-memos/creditMemoId/transaction-allocations/dummy'),
+                $client->createResponse()->withStatus(204)
+            );
+
+        $client = new Client([
+            'apiKey' => 'QWERTY',
+            'httpHandler' => $handler,
+        ]);
+
+        $service = $client->creditMemoTransactionAllocations();
+        self::assertInstanceOf(Services\CreditMemoTransactionAllocationService::class, $service);
+
+        $paginator = $service->paginator('creditMemoId');
+        self::assertInstanceOf(Paginator::class, $paginator);
+
+        $result = $service->search('creditMemoId');
+        self::assertInstanceOf(Rest\Collection::class, $result);
+
+        $result = $service->load('creditMemoId', 'dummy');
+        self::assertInstanceOf(Entities\CreditMemoTransactionAllocation::class, $result);
+
+        $result = $service->update('creditMemoId', 'dummy', []);
+        self::assertInstanceOf(Entities\CreditMemoTransactionAllocation::class, $result);
+
+        $service->delete('creditMemoId', 'dummy');
+    }
+
     /**
      * @test
      */
@@ -1212,6 +1254,11 @@ public function provideServiceClasses()
                 Services\CreditMemoInvoiceAllocationService::class,
                 Entities\CreditMemoInvoiceAllocation::class,
             ],
+            [
+                'creditMemoTransactionAllocations',
+                Services\CreditMemoTransactionAllocationService::class,
+                Entities\CreditMemoTransactionAllocation::class,
+            ],
             [
                 'creditMemos',
                 Services\CreditMemoService::class,