包简介

Integration of FirstData in Laravel

README 文档

README

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());
    }
}

sargilla/firstdata 适用场景与选型建议

sargilla/firstdata 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 28 次下载、GitHub Stars 达 1，最近一次更新时间为 2021 年 07 月 15 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「gateway」「laravel」「firstdata」「fiserv」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 sargilla/firstdata 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 sargilla/firstdata 我们能提供哪些服务？

定制开发 / 二次开发

基于 sargilla/firstdata 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发