Worldline Acquiring Go SDK

Introduction

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

• convenient go wrapper around the API calls and responses
  • marshalls Go request structs to HTTP requests
  • unmarshalls HTTP responses to Go response structs or Go 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.

Requirements

Go version 1.20 or higher is required. No additional packages are required.

Examples

This repository also contains some example code. This code is contained in the examples folder.

Installation

Source

To install the latest version of this repository, run the following command from a terminal:

go get github.com/Worldline-Acquiring/acquiring-sdk-go

Release

Go 1.11 added module support and with that support for versions in go get. This means that, if your project uses modules, you can add @version to the go get command to get a specific version. For example, go get github.com/Worldline-Acquiring/acquiring-sdk-go@2.9.0 will download version 2.9.0 of the SDK. See the releases page for an overview of available releases.

If your project does not use modules yet, you will need to use the instructions above to install from source. Note that new major versions may introduce breaking changes. We therefore recommend using modules in your project. See Migrating to Go Modules for more information.

Running tests

There are two types of tests: unit tests and integration tests. The unit tests will work out-of-the-box; for the integration tests some configuration is required. First, some environment variables need to be set:

• acquiring.api.oauth2.clientId for the OAUth2 client id to use.
• acquiring.api.clientSecret for the OAuth2 client secret to use.
• acquiring.api.merchantId for your merchant ID.
• acquiring.api.proxyUrl for the URL to the proxy to use (optional). If set, it should be in the form scheme://[userinfo@]host[:port]. Examples: http://proxy.example.org, http://user:pass@proxy.example.org, http://proxy.example.org:3128.

The following commands can now be executed from the root directory of the SDK folder to execute the tests:

• Unit tests:

  go test ./...
  

• Both unit and integration tests:

  go test -tags=integration  ./...