Add Issuer and PaymentMethod classes

Author: amacneil

src/Omnipay/Common/Issuer.php

@@ -0,0 +1,57 @@
+<?php
+
+namespace Omnipay\Common;
+
+/**
+ * Issuer
+ */
+class Issuer
+{
+    protected $id;
+    protected $name;
+    protected $paymentMethod;
+
+    /**
+     * Create a new Issuer
+     *
+     * @param string      $id            The identifier of this issuer
+     * @param string      $name          The name of this issuer
+     * @param string|null $paymentMethod The ID of a payment method this issuer belongs to
+     */
+    public function __construct($id, $name, $paymentMethod = null)
+    {
+        $this->id = $id;
+        $this->name = $name;
+        $this->paymentMethod = $paymentMethod;
+    }
+
+    /**
+     * The identifier of this issuer
+     *
+     * @return string
+     */
+    public function getId()
+    {
+        return $this->id;
+    }
+
+    /**
+     * The name of this issuer
+     *
+     * @return string
+     */
+    public function getName()
+    {
+        return $this->name;
+    }
+
+    /**
+     * The ID of a payment method this issuer belongs to
+     *
+     * @return string
+     */
+    public function getPaymentMethod()
+    {
+        return $this->paymentMethod;
+    }
+}

src/Omnipay/Common/Message/FetchIssuersResponseInterface.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Omnipay\Common\Message;
+
+/**
+ * Fetch Issuers Response interface
+ */
+interface FetchIssuersResponseInterface extends ResponseInterface
+{
+    /**
+     * Get the returned list of issuers.
+     *
+     * These represent banks which the user must choose between.
+     *
+     * @return array An array of \Omnipay\Common\Issuer objects
+     */
+    public function getIssuers();
+}

src/Omnipay/Common/Message/FetchPaymentMethodsResponseInterface.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Omnipay\Common\Message;
+
+/**
+ * Fetch Payment Methods Response interface
+ */
+interface FetchPaymentMethodsResponseInterface extends ResponseInterface
+{
+    /**
+     * Get the returned list of payment methods.
+     *
+     * These represent separate payment methods which the user must choose between.
+     *
+     * @return array An array of \Omnipay\Common\PaymentMethod objects
+     */
+    public function getPaymentMethods();
+}

src/Omnipay/Common/PaymentMethod.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace Omnipay\Common;
+
+/**
+ * Payment Method
+ */
+class PaymentMethod
+{
+    protected $id;
+    protected $name;
+
+    /**
+     * Create a new PaymentMethod
+     *
+     * @param string $id   The identifier of this payment method
+     * @param string $name The name of this payment method
+     */
+    public function __construct($id, $name)
+    {
+        $this->id = $id;
+        $this->name = $name;
+    }
+
+    /**
+     * The identifier of this payment method
+     *
+     * @return string
+     */
+    public function getId()
+    {
+        return $this->id;
+    }
+
+    /**
+     * The name of this payment method
+     *
+     * @return string
+     */
+    public function getName()
+    {
+        return $this->name;
+    }
+}

tests/Omnipay/Common/IssuerTest.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace Omnipay\Common;
+
+use Omnipay\Tests\TestCase;
+
+class IssuerTest extends TestCase
+{
+    public function testConstruct()
+    {
+        $issuer = new Issuer('99', 'Acme Corp');
+
+        $this->assertSame('99', $issuer->getId());
+        $this->assertSame('Acme Corp', $issuer->getName());
+        $this->assertNull($issuer->getPaymentMethod());
+    }
+
+    public function testConstructWithPaymentMethod()
+    {
+        $issuer = new Issuer('99', 'Acme Corp', 'ideal');
+
+        $this->assertSame('99', $issuer->getId());
+        $this->assertSame('Acme Corp', $issuer->getName());
+        $this->assertSame('ideal', $issuer->getPaymentMethod());
+    }
+}

tests/Omnipay/Common/PaymentMethodTest.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Omnipay\Common;
+
+use Omnipay\Tests\TestCase;
+
+class PaymentMethodTest extends TestCase
+{
+    public function testConstruct()
+    {
+        $method = new PaymentMethod('99', 'Acme Corp');
+
+        $this->assertSame('99', $method->getId());
+        $this->assertSame('Acme Corp', $method->getName());
+    }
+}