feat: add getCashinDetails method to TelepagosIntegrationService and corresponding tests

app/Domains/Integration/Services/TelepagosIntegrationService.php

@@ -130,6 +130,22 @@ class TelepagosIntegrationService extends BaseIntegrationService
         ]);
     }
 
+    /**
+     * Get the details of a cash-in payment.
+     *
+     * @param int $cashinId
+     * @return array
+     * @throws Exception
+     */
+    public function getCashinDetails(int $cashinId): array
+    {
+        $response = $this->client()->get("/v2/payment/cashin/{$cashinId}");
+
+        return $this->handleResponse($response, 'get cash-in details', [
+            'cashin_id' => $cashinId,
+        ]);
+    }
+
     /**
      * Handle the Telepagos API response, logging any failures and throwing Exceptions.
      *

tests/Feature/Integration/IntegrationServiceTest.php

@@ -411,4 +411,115 @@ class IntegrationServiceTest extends TestCase
 
         $service->generateQr(1200.00, 'Test Concept', 'Test Description');
     }
+
+    public function test_it_gets_cashin_details(): void
+    {
+        Integration::create([
+            'integration_code' => 'telepagos_homo',
+            'name' => 'Telepagos',
+            'url' => 'https://api.telepagos.com.ar',
+            'integration_data_schema' => [
+                'username' => 'required|string',
+                'password' => 'required|string',
+            ]
+        ]);
+
+        TenantIntegration::create([
+            'tenant_code' => $this->tenant->codigo,
+            'integration_code' => 'telepagos_homo',
+            'integration_data' => [
+                'username' => 'tele_user',
+                'password' => 'tele_pass',
+            ]
+        ]);
+
+        Http::fake([
+            'https://api.telepagos.com.ar/v2/auth/token' => Http::response([
+                'status' => 'ok',
+                'token' => 'mock-jwt-token-123',
+                'expires_at' => now()->addHour()->toDateTimeString()
+            ], 200),
+            'https://api.telepagos.com.ar/v2/payment/cashin/6351' => Http::response([
+                'status' => 'ok',
+                'buyer' => [
+                    'cuit' => '20416561398',
+                    'cvu' => '0000124900000000011974'
+                ],
+                'amount' => 1200,
+                'concept' => 'VAR',
+                'operation' => 'QR Telepagos',
+                'operation_id' => 37,
+                'description' => 'Pago prueba',
+                'transaction_id' => '2026070364',
+                'qr_order_id' => 6351,
+                'link_id' => null
+            ], 200)
+        ]);
+
+        $service = new TelepagosIntegrationService('telepagos');
+        $service->forTenant($this->tenant->codigo);
+
+        $result = $service->getCashinDetails(6351);
+
+        $this->assertEquals('ok', $result['status']);
+        $this->assertEquals(1200, $result['amount']);
+        $this->assertEquals('VAR', $result['concept']);
+        $this->assertEquals(6351, $result['qr_order_id']);
+
+        Http::assertSent(function ($request) {
+            return $request->hasHeader('Authorization', 'Bearer mock-jwt-token-123')
+                && $request->url() === 'https://api.telepagos.com.ar/v2/payment/cashin/6351'
+                && $request->method() === 'GET';
+        });
+    }
+
+    public function test_it_logs_and_throws_exception_on_get_cashin_details_error(): void
+    {
+        Integration::create([
+            'integration_code' => 'telepagos_homo',
+            'name' => 'Telepagos',
+            'url' => 'https://api.telepagos.com.ar',
+            'integration_data_schema' => [
+                'username' => 'required|string',
+                'password' => 'required|string',
+            ]
+        ]);
+
+        TenantIntegration::create([
+            'tenant_code' => $this->tenant->codigo,
+            'integration_code' => 'telepagos_homo',
+            'integration_data' => [
+                'username' => 'tele_user',
+                'password' => 'tele_pass',
+            ]
+        ]);
+
+        Http::fake([
+            'https://api.telepagos.com.ar/v2/auth/token' => Http::response([
+                'status' => 'ok',
+                'token' => 'mock-jwt-token-123',
+                'expires_at' => now()->addHour()->toDateTimeString()
+            ], 200),
+            'https://api.telepagos.com.ar/v2/payment/cashin/6351' => Http::response([
+                'status' => 'error',
+                'message' => 'Cashin no encontrado'
+            ], 404)
+        ]);
+
+        \Illuminate\Support\Facades\Log::shouldReceive('error')
+            ->once()
+            ->with('Telepagos get cash-in details failed: Cashin no encontrado', \Mockery::on(function ($context) {
+                return $context['cashin_id'] === 6351
+                    && $context['response_status'] === 404
+                    && $context['response_body'] === ['status' => 'error', 'message' => 'Cashin no encontrado'];
+            }));
+
+        $service = new TelepagosIntegrationService('telepagos');
+        $service->forTenant($this->tenant->codigo);
+
+        $this->expectException(Exception::class);
+        $this->expectExceptionMessage("Telepagos get cash-in details failed: Cashin no encontrado");
+
+        $service->getCashinDetails(6351);
+    }
 }