The Python SDK helps you to communicate with the payment platform server API. Its primary features are:
- convenient Python library for the API calls and responses
- marshalls Python request objects to HTTP requests
- unmarshalls HTTP responses to Python response objects or Python exceptions
- handling of all the details concerning authentication
- handling of required meta data
Its use is demonstrated by an example for each possible call. The examples execute a call using the provided API key.
This repository consists out of three main components:
- The source code of the SDK itself:
/onlinepayments/sdk/
- The source code of the SDK unit tests:
/tests/unit/
- The source code of the example integration tests:
/tests/integration/
Note that the source code of the unit tests and integration tests can only be found on GitHub.
Python 3.5 or higher is required. In addition, the following package is required:
- requests 2.20.0 or higher
This package will be installed automatically if the SDK is installed manually or using pip following the below instructions.
To install the SDK using pip, execute the following command:
pip install onlinepayments-sdk-python3
Alternatively, you can install the SDK from a source distribution file:
-
Download the latest version of the Python SDK from GitHub. Choose the
onlinepayments-sdk-python3-x.y.z.zip
file from the releases page, wherex.y.z
is the version number. -
Execute the following command in the folder where the SDK was downloaded to:
pip install onlinepayments-sdk-python3-x.y.z.zip
After the Python SDK has been installed, it can be uninstalled using the following command:
pip uninstall onlinepayments-sdk-python3
The required package can be uninstalled in the same way.
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:
onlinePayments.api.apiKeyId
for the API key id to use.onlinePayments.api.secretApiKey
for the secret API key to use.onlinePayments.api.merchantId
for your merchant ID.
In order to run the unit and integration tests, the mock backport and mockito packages are required. These can be installed using the following command:
pip install mock mockito
The following commands can then be executed from the tests
directory to execute the tests:
-
Unit tests:
python run_unit_tests.py
-
Integration tests:
python run_integration_tests.py
-
Both unit and integration tests:
python run_all_tests.py