solidgate/php-sdk

Php API SDK for SolidGate payment gateway

v1.6.2 2024-04-11 10:03 UTC

Requires

• php: ^7.1|^8.0
• ext-json: *
• ext-openssl: *
• guzzlehttp/guzzle: ^6.1|^7

MIT

• George Younger

README

PHP SDK provides API options for integrating Solidgate’s payment orchestrator into your PHP applications.

Check our

• Payment guide to understand business value better
• API Reference to find more examples of usage

Structure

SDK for PHP contains	Table of contents
src/solidgate/ – main library source code for development composer.json – script for managing dependencies and library imports	Requirements Installation Usage Errors

Requirements

• PHP: 7.2 or later
• Composer: Dependency manager for PHP
• Solidgate account: Public and secret key (request via [e-mail])

Installation

To start using the PHP SDK:

1. Ensure you have your public and secret key.
2. Install the SDK in your project using Composer:

   composer require solidgate/php-sdk

3. Alternatively, add the library to your composer.json file

   {
       "require": {
           "solidgate/php-sdk": "~1.0"
       }
   }

4. Import the installed libraries into your application.
5. Use test credentials to validate your integration.
6. After successful testing, request production credentials and deploy your service.
   Composer simplifies the installation and management of SDK dependencies, ensuring seamless integration.

Usage

Charge a payment

<?php

use SolidGate\API\Api;

$api = new Api('YourMerchantId', 'YourPrivateKey');

$response = $api->charge(['SomePaymentAttributes from API reference']);

Reconciliations

<?php

use SolidGate\API\Api;

$api = new Api('YourMerchantId', 'YourPrivateKey');

$dateFrom = new \DateTime("2019-01-01 00:00:00+00:00");
$dateTo = new \DateTime("2020-01-06 00:00:00+00:00");

$orderIterator = $api->getUpdatedOrders($dateFrom, $dateTo);
//$orderIterator = $api->getUpdatedChargebacks($dateFrom, $dateTo);
//$orderIterator = $api->getUpdatedAlerts($dateFrom, $dateTo);

foreach ($orderIterator as $order) {
    // process one order
}

if ($api->getException() instanceof \Throwable) {
    // save exception to log and retry request (if necessary)
}

Form resign

<?php

use SolidGate\API\Api;

$api = new Api('YourMerchantId', 'YourPrivateKey');

$response = $api->formResign(['SomePaymentAttributes from API reference']);

$response->toArray(); // pass to your Frontend

Errors

Handle errors, using a try/catch block.

try {
        $response = $api->charge([...]);
        } catch (Throwable $e) {
        error_log($e->getMessage());
}