Minor update

src/Gateway.php

@@ -5,6 +5,7 @@
 use Omnipay\Common\AbstractGateway;
 use Omnipay\Worldline\Message\CompletePurchaseRequest;
 use Omnipay\Worldline\Message\PurchaseRequest;
+use Omnipay\Worldline\Message\RefundRequest;
 
 /**
  * Worldline Hosted Checkout Gateway
@@ -69,4 +70,9 @@ public function completePurchase(array $parameters = [])
     {
         return $this->createRequest(CompletePurchaseRequest::class, $parameters);
     }
+
+    public function refund(array $parameters = [])
+    {
+        return $this->createRequest(RefundRequest::class, $parameters);
+    }
 }

src/Message/CompletePurchaseRequest.php

@@ -23,6 +23,8 @@ public function setHostedCheckoutId($value)
 
     public function getData()
     {
+        $this->validate('merchantId', 'hostedCheckoutId');
+
         return $this->httpRequest->request->all();
     }
 

src/Message/PurchaseRequest.php

@@ -115,6 +115,22 @@ public function setSessionTimeout($value)
         return $this->setParameter('sessionTimeout', $value);
     }
 
+    public function getTransactionChannel()
+    {
+        return $this->getParameter('transactionChannel');
+    }
+
+    /**
+     * Transaction channel can only be either 'ECOMMERCE' or 'MOTO'
+     */
+    public function setTransactionChannel($value)
+    {
+        if (!in_array($value, ['ECOMMERCE', 'MOTO'])) {
+            $value = null;
+        }
+        return $this->setParameter('transactionChannel', $value);
+    }
+
     public function getData()
     {
         $this->validate('merchantId', 'amount', 'currency');
@@ -141,7 +157,7 @@ public function getData()
         $data = [
             'cardPaymentMethodSpecificInput' => [
                 'authorizationMode' => 'SALE',
-                'transactionChannel' => 'ECOMMERCE',
+                'transactionChannel' => $this->getTransactionChannel() ?? 'ECOMMERCE',
             ],
             'hostedCheckoutSpecificInput' => [
                 // if adding locale, validate locale against known formats

src/Message/RefundRequest.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace Omnipay\Worldline\Message;
+
+/**
+ * Worldline Refund Request
+ *
+ * @see https://docs.direct.worldline-solutions.com/en/api-reference#tag/Payments/operation/RefundPaymentApi
+ */
+class RefundRequest extends PurchaseRequest
+{
+    protected $requestMethod = 'POST';
+
+    public function getPaymentId()
+    {
+        return $this->getParameter('paymentId');
+    }
+
+    public function setPaymentId($value)
+    {
+        return $this->setParameter('paymentId', $value);
+    }
+
+    public function getData()
+    {
+        $this->validate('merchantId', 'amount', 'currency', 'paymentId');
+
+        $data = [
+            'amountOfMoney' => [
+                'amount' => $this->getAmountInteger(),
+                'currencyCode' => $this->getCurrency(),
+            ],
+            'operationReferences' => [
+                'merchantReference' => $this->getTransactionId(),
+            ],
+        ];
+
+        return $data;
+    }
+
+    protected function createResponse($data)
+    {
+        return $this->response = new RefundResponse($this, json_decode($data));
+    }
+
+    protected function getAction()
+    {
+        return '/v2/'.$this->getMerchantId().'/payments/'.$this->getPaymentId();
+    }
+}

src/Message/RefundResponse.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace Omnipay\Worldline\Message;
+
+use Omnipay\Common\Message\AbstractResponse;
+
+/**
+ * Worldline Refund Response
+ */
+class RefundResponse extends AbstractResponse
+{
+    /**
+     * Is the response successful?
+     *
+     * @return boolean
+     */
+    public function isSuccessful()
+    {
+        return !isset($this->data->errorId) && $this->data->status == 'REFUNDED';
+    }
+
+    /**
+     * Numeric status code (also in back office / report files)
+     *
+     * @return null|string
+     */
+    public function getCode()
+    {
+        return $this->data->statusOutput->statusCode ?? $this->data->refundResult->statusOutput->statusCode ?? null;
+    }
+
+    /**
+     * Get the authorisation code if available.
+     *
+     * @return null|string
+     */
+    public function getTransactionReference()
+    {
+        return $this->data->id ?? null;
+    }
+
+    /**
+     * Get the merchant response message if available.
+     *
+     * @return null|string
+     */
+    public function getMessage()
+    {
+        return $this->data->status ?? $this->data->errorId ?? null;
+    }
+}

tests/GatewayTest.php

@@ -65,7 +65,7 @@ public function testCompletePurchaseFailure()
 
         $options = array_merge($this->options, ['hostedCheckoutId' => '0000000001']);
 
-        $response = $this->gateway->completePurchase($this->options)->send();
+        $response = $this->gateway->completePurchase($options)->send();
 
         $this->assertFalse($response->isSuccessful());
         $this->assertFalse($response->isRedirect());