About sargilla/firstdata

sargilla/firstdata is a Laravel package for integration of firstdata in laravel. It currently has 1 GitHub stars and 28 downloads on Packagist (latest version v1.0). Install it with composer require sargilla/firstdata. Discover more Laravel packages by sargilla or browse all Laravel packages to compare alternatives.

Last updated August 15, 2026

Integration of FirstData in Laravel

This package has tools to integrate firstdata payments in a laravel project.

Installation

Require the package

composer require sargilla/firstdata

Publish config file

php artisan vendor:publish --tag=firstdata

Configurate the .env file with your store data

FIRSTDATA_FORM_URL=
FIRSTDATA_STORE_ID=
FIRSTDATA_SHARED_SECRET=
FIRSTDATA_RESPONSE_FAILURE=
FIRSTDATA_RESPONSE_SUCCESS=
FIRSTDATA_RESPONSE_NOTIFICATION=
FIRSTDATA_TIMEZONE=

How to use

You can use the Firstdata facade to call two methods in your blade templates :


Firstdata::getDateTime() // It returns formated datetime


Firstdata::createExtendedHash($totalcharge,$currency,$invoiceNumber)

Example form request

This is an example form to test the integration

<html>
<head>
    <title>IPG Connect Sample for PHP</title>
</head>
<body>
    <h1>Order Form</h1>
    <form method="post" action="{{config('firstdata.form_url')}}">
        <input type="hidden" name="txntype" value="sale">
        <input type="hidden" name="timezone" value="{{config('firstdata.timezone')}}" />
        <input type="hidden" name="txndatetime" value="{{ Firstdata::getDateTime() }}" />
        <input type="hidden" name="hash_algorithm"  value="HMACSHA256" />
        <input type="hidden" name="hashExtended" value="{{ Firstdata::createExtendedHash('13.00','032','50') }}" />
        <input type="hidden" name="storename" value="{{ config('firstdata.store_id') }}" />
        <input type="hidden" name="mode" value="payonly" />
        <input type="hidden" name="paymentMethod" value="M" />
        <input type="hidden" name="chargetotal" value="13.00" />
        <input type="hidden" name="currency" value="032" />
        <input type="hidden" name="invoicenumber" value="50" />
        <input type="hidden" name="responseFailURL" value="{{ config('firstdata.response_failure') }}" />
        <input type="hidden" name="responseSuccessURL" value="{{ config('firstdata.response_success') }}" />
        <input type="hidden" name="transactionNotificationURL" value="{{ config('firstdata.response_notification') }}" />
        <input type="submit" value="Submit">
    </form>
</body>
</html>

Routes

Recomended routes for responses

Route::get('first-data', 'Payments\FirstDataController@showForm');
Route::post('first-data/response/success', 'Payments\FirstDataController@success');
Route::post('first-data/response/failure', 'Payments\FirstDataController@failure');
Route::post('first-data/response/notification', 'Payments\FirstDataController@notification');

Controller

Recomended controller

namespace App\Http\Controllers\Payments;

use Carbon\Carbon;
use Illuminate\Support\Facades\Log;

class FirstDataController {

    public function success()
    {
        // PROCESS SUCCESS AND REDIRECT
        Log::notice('OPERATION SUCCESS');
        Log::info(request()->all());
        dd(request()->all());
    }

    public function failure()
    {
        // PROCESS FAILURE AND REDIRECT
        Log::notice('OPERATION FAILED');
        Log::info(request()->all());
        dd(request()->all());
    }

    public function notification()
    {
        // PROCESS NOTIFICATION
        Log::notice('OPERATION NOTIFICATION');
        Log::info(request()->all());
        dd(request()->all());
    }
}

Comments