4.2.0

• Added:
  • Added property DateOfIncorporation to class CompanyInformation.
  • Added property PaymentCode to class OrderTypeInformation.
• Removed:
  • Removed property PaymentProduct816SpecificInput of class RedirectPaymentMethodSpecificInput, as this property is no longer supported by the REST API.

4.1.0

• Added:
  • Added property NetworkTokenUsed to class CardPaymentMethodSpecificOutput.
  • Added property NaicsCommodityCode to class OrderLineDetails.
  • Added property ShippedFromZip to class Shipping.

4.0.2

• Fixed:
  • When a DefaultConnection was created with a custom HttpClient provider function, the provided HttpClient instances were not disposed automatically. Now each provided HttpClient instance will be disposed at the end of each request.
    An extra constructor was added that also takes a mandatory Action<HttpClient> that is called at the end of each request. This can be used to take control over the automatic disposal of provided HttpClient instances. For instance, it can be disabled completely by providing an Action<HttpClient> that does nothing.

4.0.1

• Fixed:
  • Changed the default message for classes AuthorizationException and ReferenceException, as the previous ones were the same as for class ValidationException.

4.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 CreateCommunicator and CreateClient methods to class Factory that take all arguments required to create a Communicator except for the IMarshaller.
  • Added a constructor to class DefaultConnection that takes a Func<HttpClient> and an optional Action. The Func<HttpClient> allows you to provide your own HttpClient instances, e.g. using an IHttpClientFactory. The Action will be called when the DefaultConnection instance is disposed.
• Changed:
  • Changed the project names Worldline.Connect.Sdk and Worldline.Connect.Sdk.StrongName.
  • Renamed all namespaces, and moved classes and interfaces 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.
  • Replaced method Merchant of class Client with method WithNewMerchant of new class V1Client. Instances of this class are available through read-only property V1 of class Client.
  • Replaced methods of class MerchantClient with read-only properties.
  • Moved methods CreateHelper and CreateHelperBuilder from class Webhooks to new class V1WebhooksFactory. Instances of this class are available through read-only property V1 of class Webhooks.
  • Replaced properties ApiKeyId and SecretApiKey of class CommunicatorConfiguration with more generic properties AuthorizationId and AuthorizationSecret. The existing properties remain as aliases though.
  • Renamed class GlobalCollectException to PlatformException.
  • Renamed method CreateSimpleAuthenticationSignature of interface IAuthenticator to GetAuthorization. Changed its return type from string to Task<string> to support asynchronous authentication.
  • Renamed class DefaultAuthenticator to V1HMACAuthenticator.
  • Renamed class MetaDataProvider, its ServerMetaDataHeaders property and class MetaDataProviderBuilder to MetadataProvider, ServerMetadataHeaders and MetadataProviderBuilder respectively.
  • Decoupled class CommunicatorConfiguration from configuration section CommunicatorConfigurationSection. This allows multiple CommunicatorConfiguration instances to be created with different values. Creating instances based on CommunicatorConfigurationSection through Factory.CreateConfiguration is still possible.
  • Interface IConnection now extends interface IObfuscationCapable.
  • Integrated class Session into class Communicator.
  • Replaced class SessionBuilder with class CommunicatorBuilder, and the CreateSessionBuilder methods of class Factory with CreateCommunicatorBuilder methods.
  • Made methods GetHeaderDateString, ThrowExceptionIfNecessary and GetIdempotenceTimestamp of class Communicator static.
  • Property ClientHeaders of class ApiResource now returns an empty list if no client meta info is configured.
• Removed:
  • Removed constant ApiVersion of class Client.
  • Removed method createException of class ApiResource in favor of separate ExceptionFactory classes per API version.
  • Removed class Session.
  • Removed CreateCommunicator and CreateClient methods of class Factory that had a parameter of type Session.
  • Removed property SignatureString of class AuthorizationType in favor of an override of ToString.
  • Removed parameter authorizationType from the V1HMACAuthenticator constructor, as its value should always be V1HMAC.
  • Removed the protected Validate methods of class WebhooksHelper.
  • Removed previously deprecated class LoggingUtil.
  • Removed previously deprecated constructors of classes LogMessageBuilder, RequestLogMessageBuilder and ResponseLogMessageBuilder.