Download the PHP package emanuelecoppola/satispay-php-sdk without Composer

Satispay PHP SDK

This is the most complete PHP SDK for integrating the Satispay APIs.

It provides a comprehensive solution that supports all Satispay API features, allowing for seamless integration of payment functionalities into your PHP applications.

This software is currently mantained by:

• Emanuele Coppola: github.com/sponsors/EmanueleCoppola

Table of Contents

• Get Started
• Supported APIs
• Usage
  • Client instantiation
  • Client authentication
  • SatispayGBusinessClient payments
  • SatispayGBusinessClient pre-authorizations
  • SatispayGBusinessClient daily closures
  • SatispayGBusinessClient consumers
  • SatispayGBusinessClient profile
  • SatispayGBusinessClient reports
  • SatispayGBusinessClient MQTT
  • SatispayGBusinessClient sessions
  • SatispayGAgentClient payments
  • SatispayGAgentClient receipts
  • SatispayGAgentClient report requests
  • SatispayGAgentClient invoices

Get Started

Requires: PHP 7.0+, ext-curl, ext-mbstring, ext-json

First, install the SDK via the Composer package manager:

If you're using a 7.x PHP version be sure to use a Composer 2.x version that has composer-runtime-api:^2.
As per Composer System Requirements:

Composer in its latest version requires PHP 7.2.5 to run. A long-term-support version (2.2.x) still offers support for PHP 5.3.2+ in case you are stuck with a legacy PHP version. A few sensitive php settings and compile flags are also required, but when using the installer you will be warned about any incompatibilities.

Also ensure that the php-http/discovery composer plugin is allowed to run.
This will allow an authomatic PSR-18 HTTP client discovery.

If no PSR-18 HTTP client implementations are available in your project, you can manually install a client:

Then, you can start interacting with Satispay APIs:

If necessary, it is possible to specify a different PSR-18 client implementation.

Supported APIs

This SDK supports the following APIs:

• Business API
• Agent APIs

Usage

Client instantiation

Client authentication

To authenticate your application, you need to use the 6 character activation code provided by Satispay.
You can read more here: https://developers.satispay.com/docs/credentials

In order to authenticate you can use the following code:

SatispayGBusinessClient payments

Official documentation and code examples:

• Create payment -> code example
• Get payment -> code example
• Get shop-payment list -> code example
• Update payment -> code example

SatispayGBusinessClient pre-authorizations

Official documentation and code examples:

• Create pre-authorization -> code example
• Get pre-authorization -> code example
• Update pre-authorization -> code example

SatispayGBusinessClient daily closures

Official documentation and code examples:

• Get daily closure -> code example

SatispayGBusinessClient consumers

Official documentation and code examples:

• Get consumer -> code example

SatispayGBusinessClient profile

Official documentation and code examples:

• Get profile -> code example

SatispayGBusinessClient reports

Official documentation and code examples:

• Create report -> code example
• Get report -> code example
• Get reports -> code example

SatispayGBusinessClient MQTT

Official documentation and code examples:

• Authenticate -> code example
• Subscribe -> code example

SatispayGBusinessClient sessions

The sessions are usually used in combination with MQTT.

Official documentation and code examples:

• Session create -> code example
• Session get -> code example
• Session create event -> code example
• Session update -> code example

SatispayGAgentClient payments

Official documentation and code examples:

• Create PagoPA payment -> code example
• Get PagoPA payment -> code example
• Get PagoPA payments -> code example
• Update PagoPA payment -> code example

SatispayGAgentClient receipts

Official documentation and code examples:

• Get PagoPA receipt -> code example

SatispayGAgentClient report requests

Official documentation and code examples:

• Create PagoPA report request -> code example
• Get PagoPA report request -> code example
• Get PagoPA report requests -> code example

SatispayGAgentClient invoices

Official documentation and code examples:

• Create PagoPA invoice -> code example
• Get PagoPA invoices -> code example