TAP API reference
The TAP APIs provide a secure way to add additional payments to your merchant's terminals.
The Adminstration Service allows you to add merchants to the service.
The Terminal Definition Service allows to add payment methods to the terminal.
The Payment Service enables you to process alternative payments programmatically.
The LookUp Service allows to add a merchant's third party agreement to TAP services.
This is the complete API reference for TAP.
Environments and base addresses
All communication between your site and the TAP Service is managed over HTTPS. The TAP Service REST APIs are collected under the following base addresses:
Requests and responses
The TAP APIs follow the RESTful architectural style. A set of resources can be accessed using some of the endpoints provided by the APIs. To retrieve, add, or update resources, you use the associated HTTP methods for these actions:
|GET||Retrieves a resource (idempotent, will never mutate a resource)|
|POST||Creates a new resource. A JSON object, provided by you, describes the resource.|
|PUT||Updates an existing resource. A JSON object, provided by you, describes the changes.|
You can pass parameters to the TAP APIs using:
- Header parameters. For example, the
Authorizationheader specifying the private API key is always sent as an HTTP header.
- Path parameters.
- Query parameters.
- JSON objects. Some requests, typically POST and PUT, expect you to pass JSON objects to the TAP API.
In order to programmatically communicate with our TAP service, you must generate an access token using your client_id and your client_secret.
Data types and formats
The TAP APIs uses the data types and data formats as defined in OpenAPI specification.
Date and time
All date and time strings should be formatted according to the definition of
date-time in RFC3339, unless otherwise specified. For example, the string
2021-03-23T15:30:55.23Z represents 30 minutes and 55.23 seconds after the 15th hour of March 23rd, 2021 in UTC.
Currency and amount
Currency should always be specified using a 3-letter code (ISO-4217). The following table lists all currencies supported by Nets Easy:
|USD||United States dollar|
Amounts are specified in the lowest monetary unit for the given currency, without punctuation marks. For example: 100,00 NOK is specified as
10000 and 9.99 USD is specified as
Country codes and phone prefixes
The following table lists all countries supported by TAP:
|Country||ISO Code||Phone Prefix|
|Antigua & Barbuda||ATG||1|
List of Payment providers we're partnering with:
SWISH_E_COM, KLARNA, SANTANDER