Download the PHP package mitchdav/st-george-ipg-laravel without Composer

St.George IPG Client

A Laravel service provider for the St.George Internet Payment Gateway.

Please review the mitchdav/st-george-ipg package readme for installation of the base package.

Installation

composer require mitchdav/st-george-ipg-laravel

Once the library is installed, add the following service provider to your file:

You can also add the facade if required:

You can then export the config file with the following command:

php artisan vendor:publish --provider="StGeorgeIPG\Laravel\Provider"

Configuration

You first need to define the following environment variable in your file:

IPG_CLIENT_ID=

Depending on whether you have an authentication token set (required for the WebService provider, but only required if already set in the Merchant Administration Console for the Extension provider):

IPG_AUTHENTICATION_TOKEN=

You can set the system to use the test mode so that all transactions will go to the St.George IPG test server:

IPG_TEST=TRUE

If you are using the Extension provider, you'll need to define your certificate password, and optionally the certificate path, log file and the debug setting:

IPG_CERTIFICATE_PASSWORD=
IPG_CERTIFICATE_PATH=
IPG_LOG_FILE=
IPG_DEBUG=TRUE

Both and are set to suitable defaults so you can leave these empty if you wish.

Finally, review or edit the file, which reads the environment variables and populates the configuration for the package.

If you wish to use the Extension provider instead, change the value to .

Usage

The package provides a Client and Facade which are both configured using the values from the file.

You can then use the client in the same way as the mitchdav/st-george-ipg package.

Charging the Customer (purchase)

Others

Check the usage guide on the mitchdav/st-george-ipg package.

Commands

ipg:test-purchase {provider?} {cert?}

This command allows you to test your connection to the St.George IPG server by performing a test purchase. The command will instruct the provider to use the test server (regardless of your configuration), so it is safe to use in a live environment.

php artisan ipg:test-purchase

• You can optionally tell the command to use a specific provider, by providing the full class name.
• If using the Extension provider, you can also optionally pass in the certificate file to use when connecting.

ipg:update-certificate {path?} {url?} {--skip-test}

This command allows you to update the certificate file used by the Extension provider to connect to the St.George IPG server. The command will download the latest certificate, test it, and if successful it will save it to the configured or provided path.

php artisan ipg:update-certificate

• You can optionally set the path to save the certificate to, which will default to the value in the file.
• You can optionally specify the URL to download the certificate from, which will default to .
• You can optionally force the command to skip the test to ensure that the latest certificate is saved, though this is not recommended.

Testing

The library is currently not formally tested, however it is known to work with Laravel 5.4 projects. I aim to implement testing soon, however if you discover any problems please submit an issue and I will get back to you as soon as possible.