README

Implementación del Botón de Pago Yappy para Laravel.

Este paquete está basado en la Librería en PHP del sitio web de Banco General.

Instalación

Para instalar, utiliza el siguiente comando:

composer require lawiet/laravel-yappy-checkout-v2

Si tienes Laravel 8 o superior. Para versiones anteriores tienes agregar unas líneas a tu archivo config/app.php, dentro de la llave providers y dentro de aliases:

'providers' => [
    // Otros paquetes por acá
    // ...
    Yappi\YappyCheckout\YappyCheckoutServiceProvider::class,
],

'aliases' => [
    // Otros aliases por acá
    // ...
    'YappyCheckout' => Yappi\YappyCheckout\Facades\YappyCheckoutFacade::class,
],

Configuración

Agrega las siguientes variables a tu .env (y a tu .env.example en blanco si eres un buen muchacho):

YAPPY_SECRET_KEY=
YAPPY_MERCHANT_ID=
YAPPY_MERCHANT_URL=
YAPPY_IPN_URL=

Si quieres tener más control sobre la configuración, puedes hacer publish del archivo de configuración:

php artisan vendor:publish --provider="Yappi\YappyCheckout\YappyCheckoutServiceProvider"

Esto agregará el archivo config/yappy.php a tu proyecto.

Uso

crear una orden

use Yappi\YappyCheckout\YappyCheckout;

class YapiController extends Controller
{
    public function createPayment()
    {
        $yappyCheckout = new YappyCheckout();

        $response = $yappyCheckout->createOrder(
            'order-123',
            '66666666',
            10.00,
            0.00,
            0.00,
            10.00
        );
        
        ...
    }
}

El método createOrder devuelve Exception si ha habido un error creando la orden. Este método recibe los siguientes parámetros:

Si todo sale bien, se devuelve la siguiente respuesta:

IPN

Una vez que se haya hecho o se cancele la transacción, se recibira la notificación a través de YAPPY_IPN_URL:

YAPPY_IPN_URL="${APP_URL}/api/yappi/ipn"

Recibir el estado de la transacción

Una vez terminada la transacción, Yappy nos enviará el estado a nuestro servidor a mi-dominio.com/pagosbg.php. Lamentablemente, no podemos cambiar esa ruta, así que toca trabajar con ese .php feíto en la URL.

Creamos nuestra ruta en routes/web.php.

// Para Laravel 8 en adelante
Route::get('/yappi/ipn', [YappiController::class, 'ipn']);

// O para versiones anteriores
Route::get('/yappi/ipn.php', 'YappiController@ipn');

Y en nuestro controlador.

use Yappi\YappyCheckout\YappyCheckout;
use Illuminate\Http\Request;

class YappiController extends Controller
{
    public function yappyPaymentStatus(Request $request)
    {
        $yappyCheckout = new YappyCheckout();
        
        $result = $yappyCheckout->getStatus($request->all());
        
        if ($result != 'SUCCESS') {
            // aqui la logica de error
            ...
        }
        
        // aqui la logica de exito
        ...
    }
}

El método getStatus retorna el status en el que ha quedado el pago. Los valores de status son:

Contribuir

Si deseas contribuir, siéntete libre de subir tu pull request usando el estándar PSR-2 que es el que usa Laravel.

Autor

Desarrollado por Lawiet. Este proyecto ha sido realizado con la guia del proyecto shino47/laravel-yappy-checkout el cual ha sido deprecado