Added void and refund functions for credit card payments.

README.md

@@ -68,3 +68,29 @@ $response = $gateway->capture([
     'transactionReference' => $transactionReference,
 ])->send();
 ```
+
+An authorized transaction can be voided:
+
+```php
+// Captured from the authorization response.
+$transactionReference = $response->getTransactionReference();
+
+$response = $gateway->void([
+    'transactionReference' => $transactionReference,
+])->send();
+```
+
+A cleared credit card payment can be refunded, given the original
+transaction reference, the original amount, and the last four digits
+of the credit card:
+
+```php
+$response = $gateway->refund([
+    'amount' => '7.99',
+    'currency' => 'USD',
+    'transactionReference' => $transactionReference,
+    'numberLastFour' => '1234',
+])->send();
+```
+
+

src/ApiGateway.php

@@ -10,6 +10,8 @@
 
 use Omnipay\AuthorizeNetApi\Message\AuthorizeRequest;
 use Omnipay\AuthorizeNetApi\Message\PurchaseRequest;
+use Omnipay\AuthorizeNetApi\Message\VoidRequest;
+use Omnipay\AuthorizeNetApi\Message\RefundRequest;
 
 class ApiGateway extends AbstractGateway
 {
@@ -42,4 +44,26 @@ public function purchase(array $parameters = array())
             $parameters
         );
     }
+
+    /**
+     * Void an authorized transaction.
+     */
+    public function void(array $parameters = array())
+    {
+        return $this->createRequest(
+            VoidRequest::class,
+            $parameters
+        );
+    }
+
+    /**
+     * Refund a captured transaction (before it is cleared).
+     */
+    public function refund(array $parameters = array())
+    {
+        return $this->createRequest(
+            RefundRequest::class,
+            $parameters
+        );
+    }
 }

src/Message/AuthorizeRequest.php

@@ -36,13 +36,6 @@ class AuthorizeRequest extends AbstractRequest
      */
     public function getData()
     {
-        /*$amount = new MoneyPhp(
-            new Money(
-                $this->getAmountInteger(),
-                new Currency($this->getCurrency())
-            )
-        );*/
-
         $amount = new Amount($this->getCurrency(), $this->getAmountInteger());
 
         $transaction = $this->createTransaction($amount);

src/Message/CaptureRequest.php

@@ -69,6 +69,6 @@ public function sendData($data)
     {
         $response_data = $this->sendTransaction($data);
 
-        return new CaptureResponse($this, $response_data);
+        return new Response($this, $response_data);
     }
 }

src/Message/RefundRequest.php

@@ -0,0 +1,67 @@
+<?php
+
+namespace Omnipay\AuthorizeNetApi\Message;
+
+use Academe\AuthorizeNet\Amount\MoneyPhp;
+use Academe\AuthorizeNet\Amount\Amount;
+use Academe\AuthorizeNet\AmountInterface;
+use Academe\AuthorizeNet\Request\Transaction\Refund;
+use Academe\AuthorizeNet\Request\Model\Order;
+use Academe\AuthorizeNet\Payment\CreditCard;
+
+class RefundRequest extends CaptureRequest
+{
+    public function getData()
+    {
+        $transaction = parent::getData();
+
+        $card = $this->getCard();
+
+        if ($card) {
+            // A credit card has been supplied.
+
+            if ($card->getNumber()) {
+                $creditCard = new CreditCard(
+                    $card->getNumber(),
+                    // Either MMYY or MMYYYY will work.
+                    // (This will be overwritten with 'XXXX' for now)
+                    $card->getExpiryMonth() . $card->getExpiryYear()
+                );
+
+                $transaction = $transaction->withPayment($creditCard);
+            }
+        }
+
+        // Instead of supplying the full credit card dtails, just
+        // provide the lasy four digits of the card number.
+
+        if ($this->getNumberLastFour()) {
+            $creditCard = new CreditCard(
+                $this->getNumberLastFour(),
+                'XXXX'
+            );
+
+            $transaction = $transaction->withPayment($creditCard);
+        }
+
+        return $transaction;
+    }
+
+    protected function createTransaction(AmountInterface $amount, $refTransId)
+    {
+        return new Refund($amount, $refTransId);
+    }
+
+    /**
+     * The last four digits of the origonal credit card.
+     */
+    public function getNumberLastFour()
+    {
+        return $this->getParameter('numberLastFour');
+    }
+
+    public function setNumberLastFour($value)
+    {
+        return $this->setParameter('numberLastFour', $value);
+    }
+}

src/Message/CaptureResponse.php → src/Message/Response.php

@@ -10,10 +10,8 @@
 use Academe\AuthorizeNet\Response\Collections\TransactionMessages;
 use Academe\AuthorizeNet\Response\Collections\Errors;
 use Omnipay\Common\Message\RequestInterface;
-use Academe\AuthorizeNet\Response\Response;
-use Academe\AuthorizeNet\Response\Model\TransactionResponse as TransactionResponseModel;
 
-class CaptureResponse extends AbstractResponse
+class Response extends AbstractResponse
 {
     public function __construct(RequestInterface $request, $data)
     {

src/Message/VoidRequest.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace Omnipay\AuthorizeNetApi\Message;
+
+use Academe\AuthorizeNet\Amount\MoneyPhp;
+use Academe\AuthorizeNet\Amount\Amount;
+use Academe\AuthorizeNet\AmountInterface;
+use Academe\AuthorizeNet\Request\Transaction\VoidTransaction;
+use Academe\AuthorizeNet\Request\Model\Order;
+
+class VoidRequest extends AbstractRequest
+{
+    /**
+     * Return the complete message object.
+     */
+    public function getData()
+    {
+        // Identify the original transaction being voided.
+        $refTransId = $this->getTransactionReference();
+
+        $transaction = new VoidTransaction($refTransId);
+
+        return $transaction;
+    }
+
+    /**
+     * Accept a transaction and sends it as a request.
+     *
+     * @param $data TransactionRequestInterface
+     * @returns CaptureResponse
+     */
+    public function sendData($data)
+    {
+        $response_data = $this->sendTransaction($data);
+
+        return new Response($this, $response_data);
+    }
+}