7.0.1

• Changed:
  • Classes ApiException, AuthorizationException, DeclinedPaymentException, DeclinedPayoutException, DeclinedRefundException, IdempotenceException, PlatformException, ReferenceException and ValidationException each define their own default message.
  • Changed the default message for class ResponseException.

7.0.0

This SDK is a rebranded and updated version of the SDK that was previously published under the Ingenico name. Next to renaming to Worldline, the SDK has been restructured to better support future improvements like multiple API versions and different authentication mechanisms. You can use the migration guide to upgrade from the previous version. Previous versions and release notes of this SDK can be found here.

The following is an overview of changes:

• Added:
  • Added class Webhooks that can easily create webhooks helper instances. You can use it by calling Webhooks::v1()->createHelper(...).
  • Added class JSONUtil for some shared JSON conversion functionality.
  • Added interface Authenticator and implementing class V1HMACAuthenticator.
  • Added properties connectTimeout and readTimeout to class CommunicatorConfiguration.
• Changed:
  • Changed the Composer project name to worldline-global-collect/connect-sdk-php.
  • Renamed all namespaces, and moved classes between namespaces. Each API version now has its own namespace structure that contains all classes specific for that version, including classes like APIError, exceptions and webhooks classes.
  • Made the integrator required.
  • Moved method merchant from class Client to new class V1Client. Instances of this class are available through method v1 of class Client.
  • Replaced properties apiKeyId and secretApiKey of class CommunicatorConfiguration with more generic properties authorizationId and authorizationSecret. The existing getters and setters remain as aliases though.
  • Changed the parameters of the constructor of class Communicator to a required CommunicatorConfiguration and an optional Authenticator and Connection.
  • Changed the parameters of the constructor of class DefaultConnection to an optional CommunicatorConfiguration.
  • Renamed method getPaymentResult of class DeclinedPaymentException getCreatePaymentResult.
  • Renamed class GlobalCollectException to PlatformException.
  • Renamed class ResponseExceptionFactory to ExceptionFactory.
  • Renamed class Resource to ApiResource.
  • Renamed client classes to have their names end with Client. For instance, class Merchant is renamed to MerchantClient, and class Payments is renamed to PaymentsClient.
  • Classes AuthorizationException and ValidationException now extend ResponseException instead of ReferenceException.
  • Methods of class Communicator now throw instances of new class ErrorResponseException instead of using instances of ResponseExceptionFactory.
  • The BodyHandler parameter of methods getWithBinaryResponse, deleteWithBinaryResponse, postWithBinaryResponse and putWithBinaryResponse of class Communicator is now the first parameter.
  • Combined interface ConnectionResponse and class DefaultConnectionResponse into class ConnectionResponse.
  • Class ResponseFactory no longer defaults to an ErrorResponse but instead requires the ResponseClassMap argument to have a value for its defaultErrorResponseClassName field.
  • Methods of class HttpHeaderHelper have been made static.
  • The constructor of class HttpHeaderHelper has been made private.
  • Method instantiateUri of class Resource has been made protected.
  • Field responseClassNamesByHttpStatusCode of class ResponseClassMap has been made private.
  • The fields of classes ProxyConfiguration, ApiVersionMismatchException, InvalidResponseException and ResponseHeaderBuilder have been made private.
• Removed:
  • Removed constant API_VERSION of class Client.
  • Removed class RequestHeaderGenerator in favor of new classes V1HMACAuthenticator and MetadataProvider and new methods in class Communicator.
  • Removed method getResponseExceptionFactory of class Communicator.
  • Removed the ResponseExceptionFactory parameter from methods of class Communicator.
  • Removed the ProxyConfiguration parameter from methods of interface Connection and class DefaultConnection.
  • Removed methods getConnection, setConnection, getCommunicatorConfiguration and setCommunicatorConfiguration of class Communicator.
  • Removed field httpHeaderHelper of class HttpObfuscator.
  • Removed method getLastJsonDecodeErrorString of class DataObject.
  • Removed field secretKeyStore and method validate of class WebhooksHelper.