API for sappay dashboard & checkout
Note: Documentation for the client can be found here.
The following parameters are configurable for the API Client:
Parameter | Type | Description |
---|---|---|
credentials |
Credentials | The API credentials for authentication. Default: Credentials |
environment |
Environment | The API environment. Default: Environment.Production |
timeout |
number |
Timeout for API calls. Default: 0 |
httpClientOptions |
Partial<HttpClientOptions> |
Stable configurable http client options. |
unstableHttpClientOptions |
any |
Unstable configurable http client options. |
accessToken |
string |
The OAuth 2.0 Access Token to use for API requests. |
Parameter | Type | Description |
---|---|---|
username |
string |
email on merchant dashboard. |
password |
string |
password on merchant dashboard. |
clientId |
string |
API client ID obtained from Merchant portal. |
clientSecret |
string |
API client Secret Key obtained from Merchant portal. requests. |
Parameter | Type | Description |
---|---|---|
timeout |
number |
Timeout in milliseconds. |
httpAgent |
any |
Custom http agent to be used when performing http requests. |
httpsAgent |
any |
Custom https agent to be used when performing http requests. |
retryConfig |
Partial<RetryConfiguration> |
Configurations to retry requests. |
Parameter | Type | Description |
---|---|---|
maxNumberOfRetries |
number |
Maximum number of retries. Default: 0 |
retryOnTimeout |
boolean |
Whether to retry on request timeout. Default: true |
retryInterval |
number |
Interval before next retry. Used in calculation of wait time for next request in case of failure. Default: 1 |
maximumRetryWaitTime |
number |
Overall wait time for the requests getting retried. Default: 0 |
backoffFactor |
number |
Used in calculation of wait time for next request in case of failure. Default: 2 |
httpStatusCodesToRetry |
number[] |
Http status codes to retry against. Default: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524] |
httpMethodsToRetry |
HttpMethod[] |
Http methods to retry against. Default: ['GET', 'PUT'] |
The API client can be initialized as follows:
const sappayClient = new Client({
credentials: {
clientId: '<YOUR CLIENT ID>',
clientSecret: '<YOUR CLIENT SECRET KEY>',
username: '<YOUR MERCHANT EMAIL>',
password: '<YOUR MERCHANT PASSWORD>',
},
});
then pass the client
to ApiController
as follows:
const sapPay = new ApiController(sappayClient);