Redys Laravel

![Software License][ico-license] , _(*1)

Introducción

Tras finalizar la actualización de la clases Redsys para trabajar con sha256, he aprovechado en crear este package para laravel, de esta forma hacemos más ameno el trabajar con este framework., _(*2)

Instalación

Via Composer, _(*3)

Laravel 5.1 ``` bash $ composer require "ssheduardo/redsys-laravel=1.0.*", _(*4)


**Laravel 5.2, 5.3, 5.4**
``` bash
$ composer require "ssheduardo/redsys-laravel=~1.1.0"

Laravel 5.5, 5.6, 5.7, 5.8 ``` bash $ composer require "ssheduardo/redsys-laravel=~1.3.0", _(*5)

**Laravel 6.0, 7.x, 8.x, 9.x, 10.x, 11.x, 12,x**
``` bash
$ composer require "ssheduardo/redsys-laravel=~1.4.0"

O si lo prefieres, puedes agregarlo en la sección require de tu composer.json, _(*6)

Laravel 5.1, _(*7)

  "ssheduardo/redsys-laravel": "1.0.*"

Laravel 5.2, 5.3, 5.4, _(*8)

  "ssheduardo/redsys-laravel": "~1.1.0"

Laravel 5.5, 5.6, 5.7, 5.8, _(*9)

  "ssheduardo/redsys-laravel": "~1.3.0"

Laravel 6.0, 7.x, 8.x, 9.x, 10.x, 11.x, 12,x, _(*10)

  "ssheduardo/redsys-laravel": "~1.4.0"

Ahora debemos cargar nuestro Services Provider dentro del array 'providers' (config/app.php), _(*11)

Si usas Laravel 5.5 o superior, no necesitas cargar el services provider, _(*12)

Ssheduardo\Redsys\RedsysServiceProvider::class

Creamos un alias dentro del array 'aliases' (config/app.php), _(*13)

Si usas Laravel 5.5 o superior no necesitas crear el alias, _(*14)

'Redsys'    => Ssheduardo\Redsys\Facades\Redsys::class,

Y finalmente publicamos nuestro archivo de configuración, _(*15)

php artisan vendor:publish --tag="redsys-config"

Esto nos creará un archivo llamado redsys.php dentro de config, en este archivo debemos configurar nuestra key, url ok y ko., _(*16)

Uso

Imaginemos que tenemos esta ruta http://ubublog.com/redsys que enlaza con RedsysController@index, _(*17)


Route::controller(RedsysController::class)->prefix('redsys')
    ->group(function () {
        Route::get('/', 'index');
    });

Y el contenido del controlador RedsysController sería este: ``` php <?php, _(*18)

namespace App\Http\Controllers;, _(*19)

use Exception; use Illuminate\Http\Request; use Ssheduardo\Redsys\Facades\Redsys;, _(*20)

class RedsysController extends Controller { public function index() { try { $key = config('redsys.key'); $code = config('redsys.merchantcode');, _(*21)

        Redsys::setAmount(rand(10, 600));
        Redsys::setOrder(time());
        Redsys::setMerchantcode($code); //Reemplazar por el código que proporciona el banco
        Redsys::setCurrency('978');
        Redsys::setTransactiontype('0');
        Redsys::setTerminal('1');
        Redsys::setMethod('T'); //Solo pago con tarjeta, no mostramos iupay
        Redsys::setNotification(config('redsys.url_notification')); //Url de notificacion
        Redsys::setUrlOk(config('redsys.url_ok')); //Url OK
        Redsys::setUrlKo(config('redsys.url_ko')); //Url KO
        Redsys::setVersion('HMAC_SHA256_V1');
        Redsys::setTradeName('Tienda S.L');
        Redsys::setTitular('Pedro Risco');
        Redsys::setProductDescription('Compras varias');
        Redsys::setEnviroment('test'); //Entorno test

        $signature = Redsys::generateMerchantSignature($key);
        Redsys::setMerchantSignature($signature);

        $form = Redsys::createForm();
    } catch (Exception $e) {
        echo $e->getMessage();
    }
    return view('redsys', compact('form'));
}

}, _(*22)

Podemos hacer un pequeño diseño usando una plantilla blade quedando algo así

![image](https://user-images.githubusercontent.com/1160138/219521074-86ceb930-e7c9-4008-bcca-e7a8aab0c1fa.png)


Esta clase hereda de mi clase principal https://github.com/ssheduardo/sermepa, aquí encontrarán más ejemplos de los métodos que trae la clase **Tvp.php**

## Notas adicionales

Dentro del archivo /config/redsys.php, se debe configurar el FUC (Merchant Code) y nuestra key. Puntos a tener en cuenta de la configuración si no has trabajado con redsys-laravel anteriormente:

- Si queremos usar el entorno de producción debemos usar el string 'live' como environment.

- El FUC en el entorno de pruebas debe ser real, de otro modo se obtendrá el error de importe 0 (https://github.com/ssheduardo/redsys-laravel#20)

- La url OK ('url_ok') se usa para redireccionar tras un pago correcto (no contiene información del pago), lo mismo ocurre con la url de KO ('url_ko'). La url que tiene información del pago realizado es la URL de notificación ('url_notification') que deberá comprobar la firma de la información del siguiente modo:

```php
  $key = config('redsys.key');
  $parameters = Redsys::getMerchantParameters($request->input('Ds_MerchantParameters'));
  $DsResponse = $parameters["Ds_Response"];
  $DsResponse += 0;

  if (Redsys::check($key, $request->input()) && $DsResponse <= 99) {
      // lo que quieras que haya si es positiva la confirmación de redsys


  } else {
      //lo que quieras que haga si no es positivo

  }