add: create setup intent request

Author: Alexander (SASh) Alexiev

src/Message/SetupIntents/AbstractRequest.php

@@ -0,0 +1,39 @@
+<?php
+
+/**
+ * Stripe Abstract Request.
+ */
+
+namespace Omnipay\Stripe\Message\SetupIntents;
+
+/**
+ * Stripe Payment Intent Abstract Request.
+ *
+ * This is the parent class for all Stripe payment intent requests.
+ * It adds just a getter and setter.
+ *
+ * @see \Omnipay\Stripe\PaymentIntentsGateway
+ * @see \Omnipay\Stripe\Message\AbstractRequest
+ * @link https://stripe.com/docs/api/payment_intents
+ */
+abstract class AbstractRequest extends \Omnipay\Stripe\Message\AbstractRequest
+{
+    /**
+     * @param string $value
+     *
+     * @return AbstractRequest provides a fluent interface.
+     */
+    public function setSetupIntentReference($value)
+    {
+        return $this->setParameter('paymentIntentReference', $value);
+    }
+
+    /**
+     * @return mixed
+     */
+    public function getSetupIntentReference()
+    {
+        return $this->getParameter('paymentIntentReference');
+    }
+
+}

src/Message/SetupIntents/CreateSetupIntentRequest.php

@@ -0,0 +1,66 @@
+<?php
+
+/**
+ * Stripe Create Payment Method Request.
+ */
+namespace Omnipay\Stripe\Message\SetupIntents;
+
+/**
+ * Stripe create setup intent
+ *
+ * ### Example
+ *
+ * <code>
+ *
+ * </code>
+ *
+ * @see \Omnipay\Stripe\Message\PaymentIntents\AttachPaymentMethodRequest
+ * @see \Omnipay\Stripe\Message\PaymentIntents\DetachPaymentMethodRequest
+ * @see \Omnipay\Stripe\Message\PaymentIntents\UpdatePaymentMethodRequest
+ * @link https://stripe.com/docs/api/setup_intents/create
+ */
+class CreateSetupIntentRequest extends AbstractRequest
+{
+    /**
+     * @inheritdoc
+     */
+    public function getData()
+    {
+        $data = [];
+
+        if ($this->getCustomerReference()) {
+            $data['customer'] = $this->getCustomerReference();
+        }
+        if ($this->getDescription()){
+            $data['description'] = $this->getDescription();
+        }
+
+        if ($this->getMetadata()){
+            $this['metadata'] = $this->getMetadata();
+        }
+        if ($this->getPaymentMethod()){
+            $this['payment_method'] = $this->getPaymentMethod();
+        }
+
+        $data['usage'] = 'off_session';
+        $data['payment_method_types'][] = 'card';
+
+        return $data;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function getEndpoint()
+    {
+        return $this->endpoint.'/setup_intents';
+    }
+
+    /**
+     * @inheritdoc
+     */
+    protected function createResponse($data, $headers = [])
+    {
+        return $this->response = new Response($this, $data, $headers);
+    }
+}

src/Message/SetupIntents/Response.php

@@ -0,0 +1,130 @@
+<?php
+
+/**
+ * Stripe Payment Intents Response.
+ */
+namespace Omnipay\Stripe\Message\SetupIntents;
+
+use Omnipay\Common\Message\ResponseInterface;
+use Omnipay\Stripe\Message\Response as BaseResponse;;
+
+/**
+ * Stripe Payment Intents Response.
+ *
+ * This is the response class for all payment intents related responses.
+ *
+ * @see \Omnipay\Stripe\PaymentIntentsGateway
+ */
+class Response extends BaseResponse implements ResponseInterface
+{
+    /**
+     * Get the status of a payment intents response.
+     *
+     * @return string|null
+     */
+    public function getStatus()
+    {
+        if (isset($this->data['object']) && 'setup_intent' === $this->data['object']) {
+            return $this->data['status'];
+        }
+
+        return null;
+    }
+
+    /**
+     * Return true if the payment intent requires confirmation.
+     *
+     * @return bool
+     */
+    public function requiresConfirmation()
+    {
+        return $this->getStatus() === 'requires_confirmation';
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function getClientSecret()
+    {
+        if (isset($this->data['object']) && 'setup_intent' === $this->data['object']) {
+            if (!empty($this->data['client_secret'])) {
+                return $this->data['client_secret'];
+            }
+        }
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function getCustomerReference()
+    {
+
+        if (isset($this->data['object']) && 'setup_intent' === $this->data['object']) {
+            if (!empty($this->data['customer'])) {
+                return $this->data['customer'];
+            }
+        }
+
+        return parent::getCustomerReference();
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function isSuccessful()
+    {
+        if (isset($this->data['object']) && 'setup_intent' === $this->data['object']) {
+            return in_array($this->getStatus(), ['succeeded', 'requires_capture']);
+        }
+
+        return parent::isSuccessful();
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function isCancelled()
+    {
+        if (isset($this->data['object']) && 'setup_intent' === $this->data['object']) {
+            return $this->getStatus() === 'canceled';
+        }
+
+        return parent::isCancelled();
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function isRedirect()
+    {
+        if ($this->getStatus() === 'requires_action' || $this->getStatus() === 'requires_source_action') {
+            // Currently this gateway supports only manual confirmation, so any other
+            // next action types pretty much mean a failed transaction for us.
+            return (!empty($this->data['next_action']) && $this->data['next_action']['type'] === 'redirect_to_url');
+        }
+
+        return parent::isRedirect();
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function getRedirectUrl()
+    {
+        return $this->isRedirect() ? $this->data['next_action']['redirect_to_url']['url'] : parent::getRedirectUrl();
+    }
+
+    /**
+     * Get the payment intent reference.
+     *
+     * @return string|null
+     */
+    public function getSetupIntentReference()
+    {
+        if (isset($this->data['object']) && 'setup_intent' === $this->data['object']) {
+            return $this->data['id'];
+        }
+
+        return null;
+    }
+}

src/PaymentIntentsGateway.php

@@ -166,4 +166,16 @@ public function deleteCard(array $parameters = array())
     {
         return $this->createRequest('\Omnipay\Stripe\Message\PaymentIntents\DetachPaymentMethodRequest', $parameters);
     }
+
+    // Setup Intent
+
+    /**
+     * @inheritdoc
+     *
+     * @return \Omnipay\Stripe\Message\SetupIntents\CreateSetupIntentRequest
+     */
+    public function createSetupIntent(array $parameters = array())
+    {
+        return $this->createRequest('\Omnipay\Stripe\Message\SetupIntents\CreateSetupIntentRequest', $parameters);
+    }
 }