add payment setups support (#296)

This pull request introduces significant new functionality to support payment setups in the Checkout API, including the addition of new client classes, data models, and enhancements to existing payment and industry data structures. The main focus is on expanding the API's support for more complex payment setup scenarios, such as customer details, industry-specific data, and a variety of payment methods.

Author: david-ruiz-cko

lib/Checkout/CheckoutApi.php

@@ -17,6 +17,7 @@
 use Checkout\Payments\Links\PaymentLinksClient;
 use Checkout\Payments\PaymentsClient;
 use Checkout\Payments\Sessions\PaymentSessionsClient;
+use Checkout\Payments\Setups\PaymentSetupsClient;
 use Checkout\Reports\ReportsClient;
 use Checkout\Risk\RiskClient;
 use Checkout\Sessions\SessionsClient;
@@ -48,6 +49,8 @@ final class CheckoutApi extends CheckoutApmApi
 
     private $paymentSessionsClient;
 
+    private $paymentSetupsClient;
+
     private $forwardClient;
 
     public function __construct(CheckoutConfiguration $configuration)
@@ -71,6 +74,7 @@ public function __construct(CheckoutConfiguration $configuration)
         $this->issuingClient = new IssuingClient($baseApiClient, $configuration);
         $this->paymentContextClient = new PaymentContextsClient($baseApiClient, $configuration);
         $this->paymentSessionsClient = new PaymentSessionsClient($baseApiClient, $configuration);
+        $this->paymentSetupsClient = new PaymentSetupsClient($baseApiClient, $configuration);
         $this->forwardClient = new ForwardClient($baseApiClient, $configuration);
         $this->balancesClient = new BalancesClient(
             $this->getBalancesApiClient($configuration),
@@ -247,6 +251,14 @@ public function getPaymentSessionsClient()
         return $this->paymentSessionsClient;
     }
 
+    /**
+     * @return PaymentSetupsClient
+     */
+    public function getPaymentSetupsClient()
+    {
+        return $this->paymentSetupsClient;
+    }
+
     /**
      * @return ForwardClient
      */

lib/Checkout/Payments/Destination/PaymentRequestIdDestination.php

@@ -3,6 +3,7 @@
 namespace Checkout\Payments\Destination;
 
 use Checkout\Payments\PaymentDestinationType;
+use Checkout\Common\AccountHolder;
 
 class PaymentRequestIdDestination extends PaymentRequestDestination
 {

lib/Checkout/Payments/FlightLegDetails.php

@@ -2,6 +2,8 @@
 
 namespace Checkout\Payments;
 
+use DateTime;
+
 class FlightLegDetails
 {
     /**
@@ -30,7 +32,7 @@ class FlightLegDetails
 
     /**
      * The departure date in YYYY-MM-DD format.
-     * @var string
+     * @var DateTime
      */
     public $departure_date;
 

lib/Checkout/Payments/Setups/Common/Customer/Customer.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace Checkout\Payments\Setups\Common\Customer;
+
+use Checkout\Common\Phone;
+
+class Customer
+{
+    /**
+     * @var Email
+     */
+    public $email;
+
+    /**
+     * @var string
+     */
+    public $name;
+
+    /**
+     * @var Phone
+     */
+    public $phone;
+
+    /**
+     * @var Device
+     */
+    public $device;
+
+    /**
+     * @var MerchantAccount
+     */
+    public $merchant_account;
+}

lib/Checkout/Payments/Setups/Common/Customer/Device.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Checkout\Payments\Setups\Common\Customer;
+
+class Device
+{
+    /**
+     * @var string
+     */
+    public $locale;
+}

lib/Checkout/Payments/Setups/Common/Customer/Email.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Checkout\Payments\Setups\Common\Customer;
+
+class Email
+{
+    /**
+     * @var string
+     */
+    public $address;
+
+    /**
+     * @var bool
+     */
+    public $verified;
+}

lib/Checkout/Payments/Setups/Common/Customer/MerchantAccount.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace Checkout\Payments\Setups\Common\Customer;
+
+use DateTime;
+
+class MerchantAccount
+{
+    /**
+     * @var string
+     */
+    public $id;
+
+    /**
+     * @var DateTime
+     */
+    public $registration_date;
+
+    /**
+     * @var DateTime
+     */
+    public $last_modified;
+
+    /**
+     * @var bool
+     */
+    public $returning_customer;
+
+    /**
+     * @var DateTime
+     */
+    public $first_transaction_date;
+
+    /**
+     * @var DateTime
+     */
+    public $last_transaction_date;
+
+    /**
+     * @var int
+     */
+    public $total_order_count;
+
+    /**
+     * @var int
+     */
+    public $last_payment_amount;
+}

lib/Checkout/Payments/Setups/Common/Industry/AirlineData.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace Checkout\Payments\Setups\Common\Industry;
+
+use Checkout\Payments\Ticket;
+
+class AirlineData
+{
+    /**
+     * @var Ticket
+     */
+    public $ticket;
+
+    /**
+     * @var array of Passenger
+     */
+    public $passengers;
+
+    /**
+     * @var array of FlightLegDetails
+     */
+    public $flight_leg_details;
+}

lib/Checkout/Payments/Setups/Common/Industry/Industry.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Checkout\Payments\Setups\Common\Industry;
+
+use Checkout\Payments\AccommodationData;
+
+class Industry
+{
+    /**
+     * @var AirlineData
+     */
+    public $airline_data;
+
+    /**
+     * @var AccommodationData
+     */
+    public $accommodation_data;
+}

lib/Checkout/Payments/Setups/Common/Order/Order.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Checkout\Payments\Setups\Common\Order;
+
+use Checkout\Payments\ShippingDetails;
+
+class Order
+{
+    /**
+     * @var array of Product
+     */
+    public $items;
+
+    /**
+     * @var ShippingDetails
+     */
+    public $shipping;
+
+    /**
+     * @var array of OrderSubMerchant
+     */
+    public $sub_merchants;
+
+    /**
+     * @var int
+     */
+    public $discount_amount;
+}