Add support for the PaymentMethod resource

.travis.yml

@@ -13,7 +13,7 @@ php:
 
 env:
   global:
-    - STRIPE_MOCK_VERSION=0.44.0
+    - STRIPE_MOCK_VERSION=0.49.0
   matrix:
     - AUTOLOAD=1
     - AUTOLOAD=0

init.php

@@ -97,6 +97,7 @@
 require(dirname(__FILE__) . '/lib/OrderItem.php');
 require(dirname(__FILE__) . '/lib/OrderReturn.php');
 require(dirname(__FILE__) . '/lib/PaymentIntent.php');
+require(dirname(__FILE__) . '/lib/PaymentMethod.php');
 require(dirname(__FILE__) . '/lib/Payout.php');
 require(dirname(__FILE__) . '/lib/Person.php');
 require(dirname(__FILE__) . '/lib/Plan.php');

lib/PaymentIntent.php

@@ -11,7 +11,7 @@
  * @property int $amount_capturable
  * @property int $amount_received
  * @property string $application
- * @property int $application_fee
+ * @property int $application_fee_amount
  * @property int $canceled_at
  * @property string $cancellation_reason
  * @property string $capture_method
@@ -27,9 +27,9 @@
  * @property StripeObject $metadata
  * @property mixed $next_action
  * @property string $on_behalf_of
+ * @property string $payment_method
  * @property string[] $payment_method_types
  * @property string $receipt_email
- * @property string $return_url
  * @property string $review
  * @property mixed $shipping
  * @property string $source

lib/PaymentMethod.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace Stripe;
+
+/**
+ * Class PaymentMethod
+ *
+ * @property string $id
+ * @property string $object
+ * @property mixed $billing_details
+ * @property mixed $card
+ * @property mixed $card_present
+ * @property int $created
+ * @property string $customer
+ * @property mixed $ideal
+ * @property bool $livemode
+ * @property StripeObject $metadata
+ * @property mixed $sepa_debit
+ * @property string $type
+ *
+ * @package Stripe
+ */
+class PaymentMethod extends ApiResource
+{
+
+    const OBJECT_NAME = "payment_method";
+
+    use ApiOperations\All;
+    use ApiOperations\Create;
+    use ApiOperations\Retrieve;
+    use ApiOperations\Update;
+
+    /**
+     * @param array|null $params
+     * @param array|string|null $opts
+     *
+     * @return PaymentMethod The attached payment method.
+     */
+    public function attach($params = null, $opts = null)
+    {
+        $url = $this->instanceUrl() . '/attach';
+        list($response, $opts) = $this->_request('post', $url, $params, $opts);
+        $this->refreshFrom($response, $opts);
+        return $this;
+    }
+
+    /**
+     * @param array|null $params
+     * @param array|string|null $opts
+     *
+     * @return PaymentMethod The detached payment method.
+     */
+    public function detach($params = null, $opts = null)
+    {
+        $url = $this->instanceUrl() . '/detach';
+        list($response, $opts) = $this->_request('post', $url, $params, $opts);
+        $this->refreshFrom($response, $opts);
+        return $this;
+    }
+}

lib/Util/Util.php

@@ -110,6 +110,7 @@ public static function convertToStripeObject($resp, $opts)
             \Stripe\OrderItem::OBJECT_NAME => 'Stripe\\OrderItem',
             \Stripe\OrderReturn::OBJECT_NAME => 'Stripe\\OrderReturn',
             \Stripe\PaymentIntent::OBJECT_NAME => 'Stripe\\PaymentIntent',
+            \Stripe\PaymentMethod::OBJECT_NAME => 'Stripe\\PaymentMethod',
             \Stripe\Payout::OBJECT_NAME => 'Stripe\\Payout',
             \Stripe\Person::OBJECT_NAME => 'Stripe\\Person',
             \Stripe\Plan::OBJECT_NAME => 'Stripe\\Plan',

tests/Stripe/PaymentMethodTest.php

@@ -0,0 +1,94 @@
+<?php
+
+namespace Stripe;
+
+class PaymentMethodTest extends TestCase
+{
+    const TEST_RESOURCE_ID = 'pm_123';
+
+    public function testIsListable()
+    {
+        $this->expectsRequest(
+            'get',
+            '/v1/payment_methods'
+        );
+        $resources = PaymentMethod::all([
+            'customer' => 'cus_123',
+            'type' => 'card',
+        ]);
+        $this->assertTrue(is_array($resources->data));
+        $this->assertInstanceOf("Stripe\\PaymentMethod", $resources->data[0]);
+    }
+
+    public function testIsRetrievable()
+    {
+        $this->expectsRequest(
+            'get',
+            '/v1/payment_methods/' . self::TEST_RESOURCE_ID
+        );
+        $resource = PaymentMethod::retrieve(self::TEST_RESOURCE_ID);
+        $this->assertInstanceOf("Stripe\\PaymentMethod", $resource);
+    }
+
+    public function testIsCreatable()
+    {
+        $this->expectsRequest(
+            'post',
+            '/v1/payment_methods'
+        );
+        $resource = PaymentMethod::create([
+            'type' => 'card',
+        ]);
+        $this->assertInstanceOf("Stripe\\PaymentMethod", $resource);
+    }
+
+    public function testIsSaveable()
+    {
+        $resource = PaymentMethod::retrieve(self::TEST_RESOURCE_ID);
+        $resource->metadata["key"] = "value";
+        $this->expectsRequest(
+            'post',
+            '/v1/payment_methods/' . $resource->id
+        );
+        $resource->save();
+        $this->assertInstanceOf("Stripe\\PaymentMethod", $resource);
+    }
+
+    public function testIsUpdatable()
+    {
+        $this->expectsRequest(
+            'post',
+            '/v1/payment_methods/' . self::TEST_RESOURCE_ID
+        );
+        $resource = PaymentMethod::update(self::TEST_RESOURCE_ID, [
+            "metadata" => ["key" => "value"],
+        ]);
+        $this->assertInstanceOf("Stripe\\PaymentMethod", $resource);
+    }
+
+    public function testCanAttach()
+    {
+        $resource = PaymentMethod::retrieve(self::TEST_RESOURCE_ID);
+        $this->expectsRequest(
+            'post',
+            '/v1/payment_methods/' . $resource->id . '/attach'
+        );
+        $resource = $resource->attach([
+            'customer' => 'cus_123',
+        ]);
+        $this->assertInstanceOf("Stripe\\PaymentMethod", $resource);
+        $this->assertSame($resource, $resource);
+    }
+
+    public function testCanDetach()
+    {
+        $resource = PaymentMethod::retrieve(self::TEST_RESOURCE_ID);
+        $this->expectsRequest(
+            'post',
+            '/v1/payment_methods/' . $resource->id . '/detach'
+        );
+        $resource = $resource->detach();
+        $this->assertInstanceOf("Stripe\\PaymentMethod", $resource);
+        $this->assertSame($resource, $resource);
+    }
+}

tests/bootstrap.php

@@ -2,7 +2,7 @@
 
 require_once(__DIR__ . '/StripeMock.php');
 
-define("MOCK_MINIMUM_VERSION", "0.44.0");
+define("MOCK_MINIMUM_VERSION", "0.49.0");
 
 if (\Stripe\StripeMock::start()) {
     register_shutdown_function('\Stripe\StripeMock::stop');