Import legacy package's 2.x changes (#2)

src/Contracts/PaymentRequestor.php

@@ -69,6 +69,14 @@ public function authorize($data, Billable $billable = null);
      */
     public function capture(PaymentTransaction $transaction, $data = []);
 
+    /**
+     * Retrieve the transaction details from the provider.
+     *
+     * @param \Payavel\Checkout\Models\PaymentTransaction $transaction
+     * @return \Payavel\Checkout\PaymentResponse
+     */
+    public function getTransaction(PaymentTransaction $transaction);
+
     /**
      * Void a previously authorized transaction.
      * 

src/Contracts/PaymentResponder.php

@@ -53,6 +53,13 @@ public function authorizeResponse();
      */
     public function captureResponse();
 
+    /**
+     * Maps details from the getTransaction() response to the expected format.
+     * 
+     * @return array|mixed
+     */
+    public function getTransactionResponse();
+
     /**
      * Maps details from the void() response to the expected format.
      *

src/Facades/Payment.php

@@ -21,6 +21,7 @@
  * @method static \Payavel\Checkout\PaymentResponse deletePaymentMethod(\Payavel\Checkout\Models\PaymentMethod $paymentMethod)
  * @method static \Payavel\Checkout\PaymentResponse authorize($data, \Payavel\Checkout\Contracts\Billable $billable = null)
  * @method static \Payavel\Checkout\PaymentResponse capture(\Payavel\Checkout\Models\PaymentTransaction $transaction, $data = [])
+ * @method static \Payavel\Checkout\PaymentResponse getTransaction(\Payavel\Checkout\Models\PaymentTransaction $transaction)
  * @method static \Payavel\Checkout\PaymentResponse void(\Payavel\Checkout\Models\PaymentTransaction $transaction, $data = [])
  * @method static \Payavel\Checkout\PaymentResponse refund(\Payavel\Checkout\Models\PaymentTransaction $transaction, $data = [])
  * 

src/Models/PaymentTransaction.php

@@ -5,10 +5,12 @@
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Payavel\Checkout\Database\Factories\PaymentTransactionFactory;
+use Payavel\Checkout\Models\Traits\PaymentTransactionRequests;
 
 class PaymentTransaction extends Model
 {
-    use HasFactory;
+    use HasFactory,
+        PaymentTransactionRequests;
 
     /**
      * The attributes that aren't mass assignable.

src/Models/Traits/PaymentTransactionRequests.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Payavel\Checkout\Models\Traits;
+
+trait PaymentTransactionRequests
+{
+    use ConfiguresPaymentGateway;
+
+    /**
+     * Fetch the transaction details from the provider.
+     *
+     * @return \Payavel\Checkout\PaymentResponse
+     */
+    public function fetch()
+    {
+        return $this->gateway->getTransaction($this);
+    }
+
+    /**
+     * Request the provider to void the transaction.
+     *
+     * @param array|mixed $data
+     * @return \Payavel\Checkout\PaymentResponse
+     */
+    public function void($data = [])
+    {
+        return $this->gateway->void($this, $data);
+    }
+
+    /**
+     * Request the provider to refund the transaction.
+     *
+     * @param array|mixed $data
+     * @return \Payavel\Checkout\PaymentResponse
+     */
+    public function refund($data = [])
+    {
+        return $this->gateway->refund($this, $data);
+    }
+}

src/PaymentGateway.php

@@ -92,6 +92,17 @@ public function capture(PaymentTransaction $transaction, $data = [])
         return tap($this->gateway->capture($transaction, $data))->configure(__FUNCTION__, $this->provider, $this->merchant);
     }
 
+    /**
+     * Retrieve the transaction details from the provider.
+     *
+     * @param \Payavel\Checkout\Models\PaymentTransaction $transaction
+     * @return \Payavel\Checkout\PaymentResponse
+     */
+    public function getTransaction(PaymentTransaction $transaction)
+    {
+        return tap($this->gateway->getTransaction($transaction))->configure(__FUNCTION__, $this->provider, $this->merchant);
+    }
+
     /**
      * Void a previously authorized transaction.
      * 

src/Traits/PaymentRequests.php

@@ -92,6 +92,17 @@ public function capture(PaymentTransaction $transaction, $data = [])
         $this->throwRuntimeException(__FUNCTION__);
     }
 
+    /**
+     * Retrieve the transaction details from the provider.
+     *
+     * @param \Payavel\Checkout\Models\PaymentTransaction $transaction
+     * @return \Payavel\Checkout\PaymentResponse
+     */
+    public function getTransaction(PaymentTransaction $transaction)
+    {
+        $this->throwRuntimeException(__FUNCTION__);
+    }
+
     /**
      * Void a previously authorized transaction.
      * 

src/Traits/PaymentResponses.php

@@ -93,6 +93,16 @@ public function captureResponse()
         return $this->genericResponse(__FUNCTION__);
     }
 
+    /**
+     * Maps details from the getTransaction() response to the expected format.
+     * 
+     * @return array|mixed
+     */
+    public function getTransactionResponse()
+    {
+        $this->throwRuntimeException(__FUNCTION__);
+    }
+
     /**
      * Maps details from the void() response to the expected format.
      *

src/stubs/payment-request.stub

@@ -101,6 +101,17 @@ class {{ name }}PaymentRequest extends PaymentRequest
         //
     }
 
+    /**
+     * Retrieve the transaction details from the provider.
+     *
+     * @param \Payavel\Checkout\Models\PaymentTransaction $transaction
+     * @return \Payavel\Checkout\PaymentResponse
+     */
+    public function getTransaction(PaymentTransaction $transaction)
+    {
+        //
+    }
+
     /**
      * Void a previously authorized transaction.
      *

src/stubs/payment-response.stub

@@ -86,6 +86,16 @@ class {{ name }}PaymentResponse extends PaymentResponse
         //
     }
 
+    /**
+     * Maps details from the getTransaction() response to the expected format.
+     * 
+     * @return array|mixed
+     */
+    public function getTransactionResponse()
+    {
+        //
+    }
+
     /**
      * Maps details from the void() response to the expected format.
      *

tests/GatewayTestCase.php

@@ -132,6 +132,11 @@ public function capture(PaymentTransaction $transaction, $data = [])
         return new FakePaymentResponse([]);
     }
 
+    public function getTransaction(PaymentTransaction $transaction)
+    {
+        return new FakePaymentResponse([]);
+    }
+
     public function void(PaymentTransaction $paymentTransaction, $data =[])
     {
         return new FakePaymentResponse([]);
@@ -194,6 +199,13 @@ public function captureResponse()
         ];
     }
 
+    public function getTransactionResponse()
+    {
+        return [
+            'requestMethod' => $this->requestMethod,
+        ];
+    }
+
     public function voidResponse()
     {
         return [

tests/Unit/TestPaymentGateway.php

@@ -121,6 +121,21 @@ public function capture_method_returns_configured_response()
         $this->assertEquals('capture', $response->data['requestMethod']);
     }
 
+    /** @test */
+    public function get_transaction_method_returns_configured_response()
+    {
+        $transaction = PaymentTransaction::factory()->create([
+            'provider_id' => Payment::getProvider()->getId(),
+            'merchant_id' => Payment::getMerchant()->getId(),
+        ]);
+
+        $response = Payment::getTransaction($transaction);
+
+        $this->assertResponseIsConfigured($response);
+
+        $this->assertEquals('getTransaction', $response->data['requestMethod']);
+    }
+
     /** @test */
     public function void_method_returns_configured_response()
     {