README

Installation

Run the following command:

composer require satispay/gbusiness-api-php-sdk

If you do not wish to use Composer, import the init.php file.

require_once("/path/init.php");

Documentation

https://developers.satispay.com

Authenticate with RSA Signature

Sign in to your Dashboard at business.satispay.com, click "Negozi Online" or "Negozi Fisici", and then click on "Genera un token di attivazione" to generate an activation token.

Use the activation token with the authenticateWithToken function to generate and exchange a pair of RSA keys.

Save the keys in your database or in a safe place not accesibile from your website.

// Authenticate and generate the keys
$authentication = \SatispayGBusiness\Api::authenticateWithToken("XXXXXX");

// Export keys
$publicKey = $authentication->publicKey;
$privateKey = $authentication->privateKey;
$keyId = $authentication->keyId;

Reuse the keys after authentication.

// Keys variables
$publicKey = "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhk...";
$privateKey = "-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBg...";
$keyId = "ldg9sbq283og7ua1abpj989kbbm2g60us6f18c1sciq...";

// Set keys
\SatispayGBusiness\Api::setPublicKey($publicKey);
\SatispayGBusiness\Api::setPrivateKey($privateKey);
\SatispayGBusiness\Api::setKeyId($keyId);

Enable Sandbox

To enable sandbox use setSandbox function.

\SatispayGBusiness\Api::setSandbox(true);

Changelog

1.4.0

• Added custom header support in every HTTP call.
• Improve code formatting and documentation.
• Added RSA generation fallback with seclib (available via Composer only).

1.3.0

• Added \SatispayGBusiness\Api::getPlatformHeader() method.

• Added \SatispayGBusiness\Api::setPlatformHeader() method.

• Added \SatispayGBusiness\Api::getTrackingHeader() method.

• Added \SatispayGBusiness\Api::setTrackingHeader() method.

• Added \SatispayGBusiness\Request::HEADER_OS constant for x-satispay-os request header.

• Added \SatispayGBusiness\Request::HEADER_OS_VERSION constant for x-satispay-osv request headers.

• Added \SatispayGBusiness\Request::HEADER_APP_VERSION constant for x-satispay-appv request headers

• Added \SatispayGBusiness\Request::HEADER_APP_NAME constant for x-satispay-appn request headers.

• Added \SatispayGBusiness\Request::HEADER_DEVICE_TYPE constant for x-satispay-devicetype request headers.

• Added \SatispayGBusiness\Request::HEADER_TRACKING_CODE constant for x-satispay-tracking-code request headers.

• Changed in \SatispayGBusiness\Request header key from X-Satispay-Platformv to x-satispay-osv

• Changed in \SatispayGBusiness\Request header key from X-Satispay-Plugin-Version to x-satispay-appv

• Changed in \SatispayGBusiness\Request header key from X-Satispay-Plugin-Name to x-satispay-appn

• Changed in \SatispayGBusiness\Request header key from X-Satispay-Type to x-satispay-devicetype

1.2.1

• Added \SatispayGBusiness\ApiAuthentication class.
• Performed code refactoring to adhere to PSR2 Coding Standards

1.2.0

• Added \SatispayGBusiness\PreAuthorizedPaymentToken class.

1.1.1

• Fixed composer file version

1.1.0

• Removed \SatispayGBusiness\Api::testAuthentication() method.

• Removed \SatispayGBusiness\Api::getSecurityBearer() method.

• Removed \SatispayGBusiness\Api::setSecurityBearer() method.

• Added \SatispayGBusiness\Api::getPlatformVersionHeader() method.

• Added \SatispayGBusiness\Api::setPlatformVersionHeader() method.

• Added \SatispayGBusiness\Api::getPluginVersionHeader() method.

• Added \SatispayGBusiness\Api::setPluginVersionHeader() method.

• Added \SatispayGBusiness\Api::getPluginNameHeader() method.

• Added \SatispayGBusiness\Api::setPluginNameHeader() method.

• Added \SatispayGBusiness\Api::getTypeHeader() method.

• Added \SatispayGBusiness\Api::setTypeHeader() method.