From 2b4d127e3d475cffa22f46c7a3e8bbc54cac87b3 Mon Sep 17 00:00:00 2001
From: Alec Ritson <hello@itsalec.co.uk>
Date: Thu, 11 Jul 2024 11:27:26 +0100
Subject: [PATCH] Stripe - Add method to cancel payment intents (#1860)

---
 packages/stripe/README.md                     | 22 +++++++++++++++++++
 .../stripe/src/Enums/CancellationReason.php   | 11 ++++++++++
 packages/stripe/src/Facades/Stripe.php        |  2 ++
 .../stripe/src/Managers/StripeManager.php     | 19 ++++++++++++++++
 4 files changed, 54 insertions(+)
 create mode 100644 packages/stripe/src/Enums/CancellationReason.php

diff --git a/packages/stripe/README.md b/packages/stripe/README.md
index 85f67d68a8..12b3e0b1d9 100644
--- a/packages/stripe/README.md
+++ b/packages/stripe/README.md
@@ -172,6 +172,28 @@ Stripe::updateIntent(\Lunar\Models\Cart $cart, [
 ]);
 ```
 
+### Cancel an existing intent
+
+If you need to cancel a PaymentIntent, you can do so. You will need to provide a valid reason, those of which can be found in the Stripe docs: https://docs.stripe.com/api/payment_intents/cancel.
+
+Lunar Stripe includes a PHP Enum to make this easier for you:
+
+```php
+use Lunar\Stripe\Enums\CancellationReason;
+
+CancellationReason::ABANDONED;
+CancellationReason::DUPLICATE;
+CancellationReason::REQUESTED_BY_CUSTOMER;
+CancellationReason::FRAUDULENT;
+```
+
+```php
+use Lunar\Stripe\Facades\Stripe;
+use Lunar\Stripe\Enums\CancellationReason;
+
+Stripe::cancelIntent(\Lunar\Models\Cart $cart, CancellationReason $reason);
+```
+
 ### Update the address on Stripe
 
 So you don't have to manually specify all the shipping address fields you can use the helper function to do it for you.
diff --git a/packages/stripe/src/Enums/CancellationReason.php b/packages/stripe/src/Enums/CancellationReason.php
new file mode 100644
index 0000000000..9f0289c4fb
--- /dev/null
+++ b/packages/stripe/src/Enums/CancellationReason.php
@@ -0,0 +1,11 @@
+<?php
+
+namespace Lunar\Stripe\Enums;
+
+enum CancellationReason: string
+{
+    case DUPLICATE = 'duplicate';
+    case FRAUDULENT = 'fraudulent';
+    case REQUESTED_BY_CUSTOMER = 'requested_by_customer';
+    case ABANDONED = 'abandoned';
+}
diff --git a/packages/stripe/src/Facades/Stripe.php b/packages/stripe/src/Facades/Stripe.php
index 6f572784a1..43c707ab22 100644
--- a/packages/stripe/src/Facades/Stripe.php
+++ b/packages/stripe/src/Facades/Stripe.php
@@ -3,6 +3,7 @@
 namespace Lunar\Stripe\Facades;
 
 use Illuminate\Support\Facades\Facade;
+use Lunar\Stripe\Enums\CancellationReason;
 use Lunar\Stripe\MockClient;
 use Stripe\ApiRequestor;
 
@@ -11,6 +12,7 @@
  * @method static createIntent(\Lunar\Models\Cart $cart, array $opts): \Stripe\PaymentIntent
  * @method static syncIntent(\Lunar\Models\Cart $cart): void
  * @method static updateIntent(\Lunar\Models\Cart $cart, array $values): void
+ * @method static cancelIntent(\Lunar\Models\Cart $cart, CancellationReason $reason): void
  * @method static updateShippingAddress(\Lunar\Models\Cart $cart): void
  * @method static getCharges(string $paymentIntentId): \Illuminate\Support\Collection
  * @method static getCharge(string $chargeId): \Stripe\Charge
diff --git a/packages/stripe/src/Managers/StripeManager.php b/packages/stripe/src/Managers/StripeManager.php
index 030a70321a..64b70a1c8c 100644
--- a/packages/stripe/src/Managers/StripeManager.php
+++ b/packages/stripe/src/Managers/StripeManager.php
@@ -5,6 +5,7 @@
 use Illuminate\Support\Collection;
 use Lunar\Models\Cart;
 use Lunar\Models\CartAddress;
+use Lunar\Stripe\Enums\CancellationReason;
 use Stripe\Charge;
 use Stripe\Exception\InvalidRequestException;
 use Stripe\PaymentIntent;
@@ -119,6 +120,24 @@ public function syncIntent(Cart $cart): void
         );
     }
 
+    public function cancelIntent(Cart $cart, CancellationReason $reason): void
+    {
+        $meta = (array) $cart->meta;
+
+        if (empty($meta['payment_intent'])) {
+            return;
+        }
+
+        try {
+            $this->getClient()->paymentIntents->cancel(
+                $meta['payment_intent'],
+                ['cancellation_reason' => $reason->value]
+            );
+        } catch (\Exception $e) {
+
+        }
+    }
+
     /**
      * Fetch an intent from the Stripe API.
      */