additional request api

src/Requests/Baskets/CreateBasketRequest.php

@@ -23,7 +23,9 @@ public function __construct(
     protected Method $method = Method::POST;
 
     /**
-     * Define the endpoint for the request
+     * Create a basket that can be used to pay for items.
+     *
+     * @see https://docs.tebex.io/tebex-checkout-apis/eICB5LG5njxwP9wLlQv4/apis#create-a-basket-that-can-be-used-to-pay-for-items
      */
     public function resolveEndpoint(): string
     {

src/Requests/Baskets/GetBasketRequest.php

@@ -18,7 +18,9 @@ public function __construct(
     protected Method $method = Method::GET;
 
     /**
-     * Define the endpoint for the request
+     * Fetch a basket by its identifier.
+     *
+     * @see https://docs.tebex.io/tebex-checkout-apis/eICB5LG5njxwP9wLlQv4/apis#fetch-a-basket-by-its-identifier
      */
     public function resolveEndpoint(): string
     {

src/Requests/Baskets/Packages/AddPackageRequest.php

@@ -13,7 +13,7 @@ class AddPackageRequest extends Request implements HasBody
 
     public function __construct(
         protected string $ident,
-        protected object $package,
+        protected array $package,
         protected string $type,
     ) {
     }
@@ -24,7 +24,9 @@ public function __construct(
     protected Method $method = Method::POST;
 
     /**
-     * Define the endpoint for the request
+     * Add a package to a basket.
+     *
+     * @see https://docs.tebex.io/tebex-checkout-apis/eICB5LG5njxwP9wLlQv4/apis#add-package-to-a-basket
      */
     public function resolveEndpoint(): string
     {

src/Requests/Baskets/Packages/DeletePackageRequest.php

@@ -19,7 +19,9 @@ public function __construct(
     protected Method $method = Method::DELETE;
 
     /**
-     * Define the endpoint for the request
+     * Remove a row from the basket
+     *
+     * @see https://docs.tebex.io/tebex-checkout-apis/eICB5LG5njxwP9wLlQv4/apis#remove-a-row-from-the-basket
      */
     public function resolveEndpoint(): string
     {

src/Requests/Baskets/Sales/CreateSaleRequest.php

@@ -25,7 +25,9 @@ public function __construct(
     protected Method $method = Method::POST;
 
     /**
-     * Define the endpoint for the request
+     * Add a sale to the basket
+     *
+     * @see https://docs.tebex.io/tebex-checkout-apis/eICB5LG5njxwP9wLlQv4/apis#add-a-sale-to-the-basket
      */
     public function resolveEndpoint(): string
     {

src/Requests/Checkout/CreateCheckoutRequest.php

@@ -23,7 +23,9 @@ public function __construct(
     protected Method $method = Method::POST;
 
     /**
-     * Define the endpoint for the request
+     * Create a checkout request.
+     *
+     * @see https://docs.tebex.io/tebex-checkout-apis/eICB5LG5njxwP9wLlQv4/apis#create-a-checkout-request
      */
     public function resolveEndpoint(): string
     {

src/Requests/Payments/GetPaymentRequest.php

@@ -18,7 +18,9 @@ public function __construct(
     protected Method $method = Method::GET;
 
     /**
-     * Define the endpoint for the request
+     * Fetch a payment by its transaction ID
+     *
+     * @see https://docs.tebex.io/tebex-checkout-apis/eICB5LG5njxwP9wLlQv4/apis#fetch-a-payment-by-its-transaction-id
      */
     public function resolveEndpoint(): string
     {

src/Requests/Payments/RefundPaymentRequest.php

@@ -18,7 +18,9 @@ public function __construct(
     protected Method $method = Method::POST;
 
     /**
-     * Define the endpoint for the request
+     * Refund a payment by its transaction ID
+     *
+     * @see https://docs.tebex.io/tebex-checkout-apis/eICB5LG5njxwP9wLlQv4/apis#refund-a-payment-by-its-transaction-id
      */
     public function resolveEndpoint(): string
     {

src/Requests/RecurringPayments/CancelRecurringPaymentRequest.php

@@ -18,7 +18,9 @@ public function __construct(
     protected Method $method = Method::DELETE;
 
     /**
-     * Define the endpoint for the request
+     * Cancel a recurring payment.
+     *
+     * @see https://docs.tebex.io/tebex-checkout-apis/eICB5LG5njxwP9wLlQv4/apis#cancel-a-recurring-payment
      */
     public function resolveEndpoint(): string
     {

src/Requests/RecurringPayments/GetRecurringPaymentRequest.php

@@ -18,7 +18,9 @@ public function __construct(
     protected Method $method = Method::GET;
 
     /**
-     * Define the endpoint for the request
+     * Fetch a recurring payment (subscription) by its reference.
+     *
+     * @see https://docs.tebex.io/tebex-checkout-apis/eICB5LG5njxwP9wLlQv4/apis#fetch-a-recurring-payment-subscription-by-its-reference
      */
     public function resolveEndpoint(): string
     {

src/Requests/RecurringPayments/UpdateRecurringPaymentRequest.php

@@ -23,7 +23,9 @@ public function __construct(
     protected Method $method = Method::PUT;
 
     /**
-     * Define the endpoint for the request
+     * Update a subscription with a new product / amount to pay - replacing the existing product.
+     *
+     * @see https://docs.tebex.io/tebex-checkout-apis/eICB5LG5njxwP9wLlQv4/apis#update-a-subscription-with-a-new-product-amount-to-pay-replacing-the-existing-product
      */
     public function resolveEndpoint(): string
     {

src/Resources/BasketResource.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Shimmer\LaravelTebexCheckout\Resources;
+
+use Saloon\Contracts\Response;
+use Shimmer\LaravelTebexCheckout\Requests\Baskets\CreateBasketRequest;
+use Shimmer\LaravelTebexCheckout\Requests\Baskets\GetBasketRequest;
+
+class BasketResource extends Resource
+{
+    public function get(string $id): Response
+    {
+        return $this->connector->send(new GetBasketRequest($id));
+    }
+
+    public function create(string $returnUrl, string $completeUrl): Response
+    {
+        return $this->connector->send(new CreateBasketRequest($returnUrl, $completeUrl));
+    }
+}

src/Resources/CheckoutResource.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Shimmer\LaravelTebexCheckout\Resources;
+
+use Saloon\Contracts\Response;
+use Shimmer\LaravelTebexCheckout\Requests\Checkout\CreateCheckoutRequest;
+
+class CheckoutResource extends Resource
+{
+    public function create(array $basket, array $items): Response
+    {
+        return $this->connector->send(new CreateCheckoutRequest($basket, $items));
+    }
+}

src/Resources/PackageResource.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Shimmer\LaravelTebexCheckout\Resources;
+
+use Saloon\Contracts\Response;
+use Shimmer\LaravelTebexCheckout\Requests\Baskets\Packages\AddPackageRequest;
+use Shimmer\LaravelTebexCheckout\Requests\Baskets\Packages\DeletePackageRequest;
+
+class PackageResource extends Resource
+{
+    public function create(string $id, array $package, string $type): Response
+    {
+        return $this->connector->send(new AddPackageRequest($id, $package, $type));
+    }
+
+    public function delete(string $id, string $rowID): Response
+    {
+        return $this->connector->send(new DeletePackageRequest($id, $rowID));
+    }
+}

src/Resources/PaymentResource.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Shimmer\LaravelTebexCheckout\Resources;
+
+use Saloon\Contracts\Response;
+use Shimmer\LaravelTebexCheckout\Requests\Payments\GetPaymentRequest;
+use Shimmer\LaravelTebexCheckout\Requests\Payments\RefundPaymentRequest;
+
+class PaymentResource extends Resource
+{
+    public function get(string $txnID): Response
+    {
+        return $this->connector->send(new GetPaymentRequest($txnID));
+    }
+
+    public function refund(string $txnID): Response
+    {
+        return $this->connector->send(new RefundPaymentRequest($txnID));
+    }
+
+    public function delete(string $txnID): Response
+    {
+        return $this->refund($txnID);
+    }
+}

src/Resources/RecurringPaymentResource.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Shimmer\LaravelTebexCheckout\Resources;
+
+use Saloon\Contracts\Response;
+use Shimmer\LaravelTebexCheckout\Requests\RecurringPayments\CancelRecurringPaymentRequest;
+use Shimmer\LaravelTebexCheckout\Requests\RecurringPayments\GetRecurringPaymentRequest;
+use Shimmer\LaravelTebexCheckout\Requests\RecurringPayments\UpdateRecurringPaymentRequest;
+
+class RecurringPaymentResource extends Resource
+{
+    public function get(string $reference): Response
+    {
+        return $this->connector->send(new GetRecurringPaymentRequest($reference));
+    }
+
+    public function update(string $reference, array $items): Response
+    {
+        return $this->connector->send(new UpdateRecurringPaymentRequest($reference, $items));
+    }
+
+    public function cancel(string $reference): Response
+    {
+        return $this->connector->send(new CancelRecurringPaymentRequest($reference));
+    }
+
+    public function delete(string $reference): Response
+    {
+        return $this->cancel($reference);
+    }
+}

src/Resources/Resource.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace Shimmer\LaravelTebexCheckout\Resources;
+
+use Saloon\Contracts\Connector;
+
+class Resource
+{
+    public function __construct(
+        protected Connector $connector
+    ){}
+}

src/Resources/SaleResource.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Shimmer\LaravelTebexCheckout\Resources;
+
+use Saloon\Contracts\Response;
+use Shimmer\LaravelTebexCheckout\Requests\Baskets\Sales\CreateSaleRequest;
+
+class SaleResource extends Resource
+{
+    public function create(string $id, string $name, string $discountType, float $amount): Response
+    {
+        return $this->connector->send(new CreateSaleRequest($id, $name, $discountType, $amount));
+    }
+}

src/TebexCheckout.php

@@ -6,6 +6,12 @@
 use Saloon\Http\Auth\BasicAuthenticator;
 use Saloon\Http\Connector;
 use Saloon\Traits\Plugins\AcceptsJson;
+use Shimmer\LaravelTebexCheckout\Resources\BasketResource;
+use Shimmer\LaravelTebexCheckout\Resources\CheckoutResource;
+use Shimmer\LaravelTebexCheckout\Resources\PackageResource;
+use Shimmer\LaravelTebexCheckout\Resources\PaymentResource;
+use Shimmer\LaravelTebexCheckout\Resources\RecurringPaymentResource;
+use Shimmer\LaravelTebexCheckout\Resources\SaleResource;
 
 class TebexCheckout extends Connector
 {
@@ -52,4 +58,34 @@ protected function defaultAuth(): ?Authenticator
             $this->password
         );
     }
+
+    public function basket(): BasketResource
+    {
+        return new BasketResource($this);
+    }
+
+    public function packages(): PackageResource
+    {
+        return new PackageResource($this);
+    }
+
+    public function sales(): SaleResource
+    {
+        return new SaleResource($this);
+    }
+
+    public function checkout(): CheckoutResource
+    {
+        return new CheckoutResource($this);
+    }
+
+    public function payments(): PaymentResource
+    {
+        return new PaymentResource($this);
+    }
+
+    public function recurringPayments(): RecurringPaymentResource
+    {
+        return new RecurringPaymentResource($this);
+    }
 }