worldline-acquiring/acquiring-sdk-php

PHP SDK to communicate with the Worldline Acquiring platform using the Worldline Acquiring API

1.0.0 2024-12-11 15:28 UTC

Requires

• php: >=7.4
• ext-curl: *
• ext-json: *
• ext-mbstring: *
• robtimus/multipart: ~1.0

Requires (Dev)

• phpunit/phpunit: ~9

MIT

• Worldline

• sdk

README

Introduction

The Worldline Acquiring PHP SDK helps you to communicate with the Worldline Acquiring API. Its primary features are:

• convenient PHP wrapper around the API calls and responses:
  • marshalls PHP request objects to HTTP requests
  • unmarshalls HTTP responses to PHP response objects or PHP exceptions
• handling of all the details concerning authentication
• handling of required metadata

See the Worldline Acquiring Documentation for more information on how to use the SDK.

Structure of this repository

This repository consists out of the following components:

1. The source code of the SDK itself: /src and /lib
2. The source code of the unit and integration tests: /tests

Requirements

PHP 5.4 or above is required. In addition, to support streaming uploads, package robtimus/multipart is required.

Installation via Composer

1. Initialize Composer in your project, if this is not already done, by executing the following command:

   composer init
   

2. Add a requirement to the SDK to your composer.json file by executing the following command:

   composer require worldline-acquiring/acquiring-sdk-php
   

3. Add vendor/autoload.php to your project, if this is not already done, by adding the following line of code:

   require __DIR__ . '/vendor/autoload.php';
   

Manual installation

1. Download the latest version of the PHP SDK from GitHub. Choose the acquiring-sdk-php-x.y.z.tar.gz file from the releases page, where x.y.z is the version number.
2. Add the contents of the tar.gz file to your project. The content of the /src and /lib folders may be combined, if this is required by the project.
3. Add all classes from the /src and /lib folders to your autoloader; all classes inside these folders are compliant with PSR-4.

Development and testing

1. Install Composer
2. From the root of the sdk-php project, run composer install
3. Copy tests/config.json.dist to tests/config.json and replace the template values by actual values
4. From the root of the sdk-php project, vendor/phpunit/phpunit/phpunit (or just phpunit when it is already installed on your local machine)