Merge pull request #5 from innovawebcl/develop

Willywes · web-flow · commit ccba250ccead · 2022-04-29T10:40:22.000-04:00
Develop
diff --git a/changelog.md b/changelog.md
@@ -2,6 +2,18 @@
 
 All notable changes to `Transbank` will be documented in this file.
 
+## v2.7.0 - 2022-04-29
+### Added
+- Laravel illuminate/support 9
+- HelperRedirect function to return data array
+- Refund Response Codes
+- Response Commerce Code Response Codes
+### Updated
+- VCI Response Codes
+### Fixed
+- Source Code
+
+
 ## v2.6.0 - 2022-04-28
 ### Added
 - Laravel illuminate/support 9
diff --git a/src/Helpers/HelperTransbankResponseCode.php b/src/Helpers/HelperTransbankResponseCode.php
@@ -4,6 +4,8 @@
 namespace Innovaweb\Transbank\Helpers;
 
 
+use Exception;
+
 class HelperTransbankResponseCode
 {
 
@@ -18,17 +20,40 @@ public static function VCI($code)
     {
         $code = strtoupper(strval($code));
         try {
+
             $codes = [
-                'TSY' => 'Autenticación exitosa.',
-                'TSN' => 'Autenticación fallida.',
+                'TSY' => 'Autenticación Exitosa.',
+                'TSN' => 'Autenticación Rechazada.',
+                'NP' => 'No Participa, probablemente por ser una tarjeta extranjera que no participa en el programa 3DSecure, sin autenticación.',
+                'U3' => 'Falla conexión, Autenticación Rechazada.',
+                'INV' => 'Datos Inválidos.',
+                'A' => 'Intentó.',
+                'CNP1' => 'Comercio no participa.',
+                'EOP' => 'Error operacional.',
+                'BNA' => 'BIN no adherido.',
+                'ENA' => 'Emisor no adherido.',
                 'TO' => 'Tiempo máximo excedido para autenticación.',
                 'ABO' => 'Autenticación abortada por tarjeta habiente.',
-                'U3' => 'Error interno en la autenticación.',
-                'NP' => 'No Participa, probablemente por ser una tarjeta extranjera que no participa en el programa 3DSecure.',
                 'ACS2' => 'Autenticación fallida extranjera.',
+                // Para venta extranjera, estos son algunos de los códigos:
+
+                'TSYS' => 'Autenticación exitosa Sin fricción. Resultado autenticación: Autenticación Exitosa.',
+                'TSAS' => 'Intento, tarjeta no enrolada / emisor no disponible. Resultado autenticación: Autenticación Exitosa.',
+                'TSNS' => 'Fallido, no autenticado, denegado / no permite intentos. Resultado autenticación: Autenticación denegada.',
+                'TSRS' => 'Autenticación rechazada - sin fricción. Resultado autenticación: Autenticación rechazada.',
+                'TSUS' => 'Autenticación no se pudo realizar por problema técnico u otro motivo. Resultado autenticación: Autenticación fallida.',
+                'TSCF' => 'Autenticación con fricción (No aceptada por el comercio). Resultado autenticación: Autenticación incompleta.',
+                'TSYF' => 'Autenticación exitosa con fricción. Resultado autenticación: Autenticación exitosa.',
+                'TSNF' => 'No autenticado. Transacción denegada con fricción. Resultado autenticación: Autenticación denegada.',
+                'TSUF' => 'Autenticación con fricción no se pudo realizar por problema técnico u otro. Resultado autenticación: Autenticación fallida.',
+                'NPC' => 'Comercio no Participa. Resultado autenticación: Comercio/BIN no participa.',
+                'NPB' => 'BIN no participa. Resultado autenticación: Comercio/BIN no participa.',
+                'NPCB' => 'Comercio y BIN no participan. Resultado autenticación: Comercio/BIN no participa.',
+                'SPCB' => 'Comercio y BIN sí participan. Resultado autenticación: Autorización incompleta.',
+
             ];
             return $codes[$code];
-        } catch (\Exception $exception) {
+        } catch (Exception $exception) {
             return 'Exception : Código no encontrado.';
         }
     }
@@ -53,7 +78,37 @@ public static function ResponseCode($code)
                 '-5' => 'Rechazo - Transacción con riesgo de posible fraude.',
             ];
             return $codes[$code];
-        } catch (\Exception $exception) {
+        } catch (Exception $exception) {
+            return 'Exception : Código no encontrado.';
+        }
+    }
+
+    /**
+     * ResponseCommerceCode
+     *
+     * @param string $code response_commerce_code.
+     * @return string retorna el significado del código, Código de respuesta de la transacción al comercio.
+     *
+     */
+    public static function ResponseCommerceCode($code)
+    {
+        $code = strval($code);
+        try {
+            $codes = [
+                '-1' => 'Tarjeta inválida.',
+                '-2' => 'Error de conexión.',
+                '-3' => 'Excede monto máximo.',
+                '-4' => 'Fecha de expiración inválida.',
+                '-5' => 'Problema en autenticación.',
+                '-6' => 'Rechazo general.',
+                '-7' => 'Tarjeta bloqueada.',
+                '-8' => 'Tarjeta vencida.',
+                '-9' => 'Transacción no soportada.',
+                '-10' => 'Problema en la transacción.',
+                '-11' => 'Excede límite de reintentos de rechazos (Próximamente).',
+            ];
+            return $codes[$code];
+        } catch (Exception $exception) {
             return 'Exception : Código no encontrado.';
         }
     }
@@ -79,7 +134,7 @@ public static function Status($code)
                 'CAPTURED' => 'Transacción capturada.',
             ];
             return $codes[$code];
-        } catch (\Exception $exception) {
+        } catch (Exception $exception) {
             return 'Exception : Código no encontrado.';
         }
     }
@@ -105,7 +160,40 @@ public static function PaymentTypeCode($code)
                 'VP' => 'Venta Prepago.',
             ];
             return $codes[$code];
-        } catch (\Exception $exception) {
+        } catch (Exception $exception) {
+            return 'Exception : Código no encontrado.';
+        }
+    }
+
+    /**
+     * RefundCode
+     *
+     * @param string $code refund_code.
+     * @return string retorna el significado del código, Reembolso de la transacción.
+     *
+     */
+    public static function RefundCode($code)
+    {
+        $code = strtoupper(strval($code));
+        try {
+            $codes = [
+                '304' => 'Validación de campos de entrada nulos.',
+                '245' => 'Código de comercio no existe.',
+                '22' => 'El comercio no se encuentra activo.',
+                '316' => 'El comercio indicado no corresponde al certificado o no es hijo del comercio MALL en caso de transacciones MALL.',
+                '308' => 'Operación no permitida.',
+                '274' => 'Transacción no encontrada.',
+                '16' => 'La transacción no permite anulación.',
+                '292' => 'La transacción no está autorizada.',
+                '284' => 'Periodo de anulación excedido.',
+                '310' => 'Transacción anulada previamente.',
+                '311' => 'Monto a anular excede el saldo disponible para anular.',
+                '312' => 'Error genérico para anulaciones.',
+                '315' => 'Error del autorizador.',
+                '53' => 'La transacción no permite anulación parcial de transacciones con cuotas.',
+            ];
+            return $codes[$code];
+        } catch (Exception $exception) {
             return 'Exception : Código no encontrado.';
         }
     }
diff --git a/src/OneClickMall.php b/src/OneClickMall.php
@@ -3,6 +3,7 @@
 
 namespace Innovaweb\Transbank;
 
+use Exception;
 use GuzzleHttp\Exception\GuzzleException;
 use Innovaweb\Transbank\Helpers\HelperRedirect;
 use Transbank\Webpay\Oneclick as OneClick;
@@ -51,7 +52,7 @@ public function createInscription($username, $email, $url_return)
                 'response' => $response
             ];
 
-        } catch (\Exception $exception) {
+        } catch (Exception $exception) {
             return [
                 'status' => 'error',
                 'exception' => $exception->getMessage(),
@@ -72,24 +73,24 @@ public function finishInscription($tbk_token)
     {
         try {
             if (!$tbk_token) {
-                $tbk_token  = $_POST['TBK_TOKEN'];
+                $tbk_token = $_POST['TBK_TOKEN'];
             }
-            $response = (new MallInscription)->finish($tbk_token );
+            $response = (new MallInscription)->finish($tbk_token);
 
-            if((int) $response->getResponseCode() === 0){
+            if ((int)$response->getResponseCode() === 0) {
                 return [
                     'status' => 'success',
                     'response' => $response
                 ];
-            }else{
+            } else {
                 return [
                     'status' => 'error',
                     'exception' => $response,
                 ];
             }
 
 
-        } catch (\Exception $exception) {
+        } catch (Exception $exception) {
             return [
                 'status' => 'error',
                 'exception' => $exception->getMessage(),
@@ -99,7 +100,6 @@ public function finishInscription($tbk_token)
 
     /**
      * authorize
-
      */
     public function authorize($username, $tbkUser, $order_id, $details)
     {
@@ -111,7 +111,7 @@ public function authorize($username, $tbkUser, $order_id, $details)
                 'response' => $response
             ];
 
-        } catch (\Exception $exception) {
+        } catch (Exception $exception) {
             return [
                 'status' => 'error',
                 'exception' => $exception->getMessage(),
@@ -132,7 +132,7 @@ public function getStatus($buyOrder)
                 'response' => $response
             ];
 
-        } catch (\Exception $exception) {
+        } catch (Exception $exception) {
             return [
                 'status' => 'error',
                 'exception' => $exception->getMessage(),
diff --git a/src/WebpayPlus.php b/src/WebpayPlus.php
@@ -3,6 +3,8 @@
 
 namespace Innovaweb\Transbank;
 
+use Exception;
+use GuzzleHttp\Exception\GuzzleException;
 use Innovaweb\Transbank\Helpers\HelperRedirect;
 use Transbank\Webpay\WebpayPlus as WPPlus;
 use Transbank\Webpay\WebpayPlus\Exceptions\TransactionCreateException;
@@ -47,6 +49,7 @@ public function __construct(string $webpay_plus_commerce_code = '',
      * @param string $url_return URL del comercio, a la cual Webpay redireccionará posterior al proceso de autorización. Largo máximo: 256
      * @return array en caso de success retorna un objeto con token: con Token de la transacción. Largo: 64, string url: URL de formulario de pago Webpay. Largo máximo: 255.
      *
+     * @throws GuzzleException
      */
     public function createTransaction($buy_order, $session_id, $amount, $url_return)
     {
@@ -63,7 +66,12 @@ public function createTransaction($buy_order, $session_id, $amount, $url_return)
                 'response' => $response
             ];
 
-        } catch (TransactionCreateException | \Exception $exception) {
+        } catch (TransactionCreateException $exception) {
+            return [
+                'status' => 'error',
+                'exception' => $exception->getMessage(),
+            ];
+        } catch (Exception $exception) {
             return [
                 'status' => 'error',
                 'exception' => $exception->getMessage(),
@@ -77,6 +85,7 @@ public function createTransaction($buy_order, $session_id, $amount, $url_return)
      * @param string $token_ws Token de la transacción. Largo: 64.
      * @return array en caso de success retorna objecto con datos de la transacción
      *
+     * @throws GuzzleException
      */
     public function commitTransaction($token_ws)
     {
@@ -92,7 +101,7 @@ public function commitTransaction($token_ws)
                 'response' => $response
             ];
 
-        } catch (\Exception $exception) {
+        } catch (Exception $exception) {
             return [
                 'status' => 'error',
                 'exception' => $exception->getMessage(),
@@ -107,6 +116,7 @@ public function commitTransaction($token_ws)
      * @param float $amount Monto de la transacción. Máximo 2 decimales para USD. Largo máximo: 17
      * @return array en caso de success retorna objecto con datos del reembolso
      *
+     * @throws GuzzleException
      */
     public function refundTransaction($token, $amount)
     {
@@ -117,7 +127,7 @@ public function refundTransaction($token, $amount)
                 'response' => $response
             ];
 
-        } catch (\Exception $exception) {
+        } catch (Exception $exception) {
             return [
                 'status' => 'error',
                 'exception' => $exception->getMessage(),
@@ -130,7 +140,7 @@ public function refundTransaction($token, $amount)
      *
      * @param string $token Token de la transacción. Largo: 64.
      * @return array en caso de success retorna objecto con datos de la transacción
-     *
+     * @throws GuzzleException
      */
     public function getStatusTransaction($token)
     {
@@ -141,7 +151,7 @@ public function getStatusTransaction($token)
                 'response' => $response
             ];
 
-        } catch (\Exception $exception) {
+        } catch (Exception $exception) {
             return [
                 'status' => 'error',
                 'exception' => $exception->getMessage(),
@@ -154,9 +164,9 @@ public function getStatusTransaction($token)
      *
      * @param string $token Token de la transacción. Largo: 64.
      * @return array en caso de success retorna objecto con datos de la transacción
-     *
+     * @throws GuzzleException
      */
-    public function getTransactionStatus($token)
+    public function getTransactionStatus(string $token)
     {
         return $this->getStatusTransaction($token);
     }
@@ -167,4 +177,11 @@ public function redirectHTML($url = '', $token = '')
         $token = empty($token) ? $this->token : $token;
         return HelperRedirect::redirectHTML($url, $token);
     }
+
+    public function dataArray($url = '', $token = '')
+    {
+        $url = empty($url) ? $this->url : $url;
+        $token = empty($token) ? $this->token : $token;
+        return HelperRedirect::dataArray($url, $token);
+    }
 }
