Skip to content

treeStoneIT/laravel-converge-api

Repository files navigation

Laravel Elavon / Converge API

Latest Version on Packagist Fix PHP code style issues Total Downloads

A simple, easy to use Laravel wrapper for Elavon's Converge API via key value pairs instead of XML.

Installation

You can install the package via composer:

composer require treestoneit/laravel-converge-api

You can publish the config file with:

php artisan vendor:publish --provider="Treestoneit\LaravelConvergeApi\LaravelConvergeApiServiceProvider" --tag="config"

This is the contents of the published config file:

return [
    /*
     * Merchant ID: Elavon-assigned Converge account ID.
     */
    'merchant_id' => env('CONVERGE_MERCHANT_ID', ''),

    /*
     * Converge User ID: The user ID with Hosted Payment API User status that
     * can send transaction requests through the terminal.
     */
    'user_id'     => env('CONVERGE_USER_ID', ''),

    /*
     * Terminal ID: Unique identifier of the terminal that will process the 
     * transaction request and submit to the Converge gateway.
     * 
     * Important: The ssl_user_id sending the transaction request must be 
     * associated with the terminal that will process the request.
     */
    'pin'         => env('CONVERGE_PIN', ''),

    /*
     * Demo / Live Site
     */
    'demo'        => env('CONVERGE_DEMO', true),
];

Usage

    $converge = app(\Treestoneit\LaravelConvergeApi\Converge::class);

    $createSale = $converge->authOnly([
        'ssl_card_number' => '5121212121212124',
        'ssl_exp_date' => '0325',
        'ssl_cvv2cvc2' => '321',
        'ssl_amount' => '250.00',
        'ssl_add_token' => 'Y',
    ]);

Testing

On our todo list :-)

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

This package is built as a Laravel wrapper using the code in PHP Converge API built by Phillip Roth

License

The MIT License (MIT). Please see License File for more information.