splitit-apimatic-sdk 1.0.0

SDK for Splitit webapi

Getting Started with splitit-web-api-v4

Introduction

Splitit Orchestration API for managing installment plans.

Install the Package

The package is compatible with Python versions 3.7+. Install the package from PyPi using the following pip command:

pip install splitit-apimatic-sdk==1.0.0

You can also view the package at: https://pypi.python.org/pypi/splitit-apimatic-sdk/1.0.0

Initialize the API Client

Note: Documentation for the client can be found here.

The following parameters are configurable for the API Client:

Parameter	Type	Description
environment	Environment	The API environment. Default: Environment.SANDBOX
http_client_instance	Union[Session, HttpClientProvider]	The Http Client passed from the sdk user for making requests
override_http_client_configuration	bool	The value which determines to override properties of the passed Http Client from the sdk user
http_call_back	HttpCallBack	The callback value that is invoked before and after an HTTP call is made to an endpoint
timeout	float	The value to use for connection timeout. Default: 60
max_retries	int	The number of times to retry an endpoint call if it fails. Default: 0
backoff_factor	float	A backoff factor to apply between attempts after the second try. Default: 2
retry_statuses	Array of int	The http statuses on which retry is to be done. Default: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524]
retry_methods	Array of string	The http methods on which retry is to be done. Default: ["GET", "PUT"]
proxy_settings	ProxySettings	Optional proxy configuration to route HTTP requests through a proxy server.
o_auth_2_credentials	OAuth2Credentials	The credential object for OAuth 2 Client Credentials Grant
api_key_credentials	ApiKeyCredentials	The credential object for Custom Header Signature

The API client can be initialized as follows:

Code-Based Client Initialization

from splititwebapiv4.configuration import Environment
from splititwebapiv4.http.auth.api_key import ApiKeyCredentials
from splititwebapiv4.http.auth.o_auth_2 import OAuth2Credentials
from splititwebapiv4.models.o_auth_scope_o_auth_2_enum import OAuthScopeOAuth2Enum
from splititwebapiv4.splititwebapiv_4_client import Splititwebapiv4Client

client = Splititwebapiv4Client(
    o_auth_2_credentials=OAuth2Credentials(
        o_auth_client_id='OAuthClientId',
        o_auth_client_secret='OAuthClientSecret',
        o_auth_scopes=[
            OAuthScopeOAuth2Enum.API_V4
        ]
    ),
    api_key_credentials=ApiKeyCredentials(
        x_splitit_api_key='X-Splitit-Api-Key'
    ),
    environment=Environment.SANDBOX
)

Environment-Based Client Initialization

from splititwebapiv4.splititwebapiv_4_client import Splititwebapiv4Client

# Specify the path to your .env file if it’s located outside the project’s root directory.
client = Splititwebapiv4Client.from_environment(dotenv_path='/path/to/.env')

See the Environment-Based Client Initialization section for details.

Environments

The SDK can be configured to use a different environment for making API calls. Available environments are:

Fields

Name	Description
SANDBOX	Default Sandbox Environment (Transactional API)
PRODUCTION	Production Environment (Transactional API)

Authorization

This API uses the following authentication schemes.

• OAuth2 (OAuth 2 Client Credentials Grant)
• ApiKey (Custom Header Signature)

List of APIs

• Installment Plan

SDK Infrastructure

Configuration

• ProxySettings
• Environment-Based Client Initialization

HTTP

• HttpResponse
• HttpRequest

Utilities

• ApiHelper
• HttpDateTime
• RFC3339DateTime
• UnixDateTime