Dokumentation

1Introduction

This document explains common aspects of all the REST services. Use the index on the right side to quickly navigate through the chapters. An overview over and introduction to the Rest services can be found in the general documentation.

1.1Type System

The REST service is based up on the following basic types. They are considered as primitives.

Long

A long is a number consisting only of digits. It is has a size of 64 bit.

Integer

An integer is a number consisting only of digits. It is has a size of 32 bit.

String

A string consists of digits or chars. The size is not limited by definition. However the parameters and properties may specify explicitly a size.

Boolean

A boolean holds either true or false.

Decimal

A decimal is floating point number. We typically have 19 digits and 8 decimal places.

Date

A date defines a specific day. We represent dates as strings since JSON does not provide a standard way to represent dates. We format the dates according to ISO 8601 (e.g. 2012-04-23). A date will not contain a time zone. If it is relevant to attach a time to the corresponding date we use UTC for this purpose. If you are in doubts how to convert to a date use UTC.

DateTime

A date defines a specific point in time. We represent dates as strings since JSON does not provide a standard way to represent dates. We format the dates according to ISO 8601 (e.g. 2012-04-23T18:25:43.511[Europe/Berlin]). When no time zone is provided we will use the time zone based on the current acting user or UTC. We strongly recommend always providing a time zone.

Duration

A duration defines a time span between to time points (e.g. one month). A duration is represented as a String in the duration format of ISO 8601 (e.g. P1M).

Complex Object

A complex object consists of a set of properties. Each property can have again a primitive type, a complex object or a collection.

Collection

A collection is a list of either primitives or a list of complex objects. A collection consists always of the same type. We do not mix types within a collection.

Binary

A binary contains data in a arbitrary format. The corresponding format is indicated along the type (e.g. text/csv)

1.2Object Versioning / Locking

The API returns objects and allows to update those objects. This may lead to race conditions when the same object is modified by multiple users or processes at the same time. Each potentially affected object contains a property version. This version is incremented whenever a change on it is applied. Before an update is applied on the object the version is verified to be still the same. If this check fails the update fails. This version number is also updated when a change is applied through the user interface. As a consequence to update a particular object the version property has to be passed. This concept is also known as optimistic locking.

The failure of an update should be handled depending on the context. Generally there are two options:

  • If a user was the trigger for the update let the user apply the update again. The latest version should be fetched and presented to the user to update the object again.

  • If an automated process is the trigger of the update the update should be wrapped within a loop which retries on a failure to update the object multiple times.

When a request leads to a conflict we return a 409 HTTP status.

1.3Entity Search

For most entities there is a search operation. The search allows to fetch only particular entities. Means the returned entities are filtered by a query. The query is structured similar to a SQL query. Essentially there is a part which limits the result and there is a paging mechanism. The model definition Entity Query defines the whole query.

The filter object allows to formulate the restrictions. The expression is similar to the WHERE part in an SQL statement. It is a recursive data structure which allows to define AND and OR groups. Each group can have multiple restrictions on properties. The fieldName can reference a property or it can be a path to a property. As an example to get all application users which are linked with the account test the following query can be used:

{
	'filter': {
		'fieldName': 'primaryAccount.name',
		'operator': 'EQUALS',
		'type': 'LEAF',
		'value': 'test'
	}
}

Beside the restriction given through the filter the query can also order the results by a fieldName. As the fieldName of the filter the fieldName of the orderBys can use the dot notation to order by a foreign property.

The paging can be realized by indicating the startingEntity and the numberOfEntities. The startingEntity indicates the entity with which the result should start. The numberOfEntities controls how many results should be returned. The get the total count for a particular filter the count operation can be used.

There are some limitation regarding the fields which can be used to filter results. Not all fields can be used for filtering and sorting. The fields which are marked as virtual cannot be used for filtering and ordering. Additionally if the relationship between entities are implemented with a reference consisting of a long the relationship cannot be used for ordering and filtering.

Some properties may be language aware. As such the filtering and ordering will impact the result. As such it is recommended to provide a language to make sure that the right results are returned. If no language is provided either the default language (en-US) is used or the language we may detect within the HTTP request.

1.4Machine-readable API Definition / Swagger

The description of the API in this document is intended to be used when the API is integrated without using a software development kit (SDK) and it is intended to be used as a reference to understand each single service.

To simplify the integration we provide the API definition also in a machine readable format. The service description is written in Swagger. It can be found under Swagger. The Swagger documentation may provide more details about how to use the provided JSON file.

Swagger uses tags to group operations together and each operation is uniquely identified by an operationId. The Swagger specification is not strict enough to generate meaningful client code. As such we introduce the following conventions:

  1. Each operation will be tagged exactly with one tag. This tag correspond to the service name. It is always in camel case.

  2. Each operationId starts with the operation tag followed by a underscore (_) and an operation name. This operation name is unique per service. Means each tag will contain exactly one such operation name and not more. This operation name is also in camel case.

We recommend to create a class per service (tag) and each such service class can hold all operations of this particular tag. The operation name can be used as the method name of the operation within the class. Client languages which are not object oriented may use the whole operationId as the identifier. We ensure that the operationId is stable over time.

1.5SDK

We provide software development kits (SDK) for several programming languages. Those SDK reduce your effort to integrate our services. All available SDKs including documentation can be accessed via our Github Repository.

1.6Meta Data

There are objects which contain meta data. Meta data properties allow to store arbitrary data along the object. The data provided is not changed or touched by our system. However it can be accessed as any other property of the object. The data can be accessed over the web service API, but also within templates etc. The meta data property is a key / value store.

There are some limits what can be stored and how it can be stored:

  • Per object no more than 25 key / value pairs can be provided.

  • A key cannot be longer as 40 chars.

  • A value cannot be longer as 512 chars.

  • The key can only contain alphabetic chars, numeric chars and underscores. The key cannot starts with an underscore or a number. The regex against we validate the key is: [a-zA-Z]{1}[a-zA-Z0-9_]{0,39}

  • The value can contain any printable UTF-8 char including line breaks. However stop chars etc. are not permitted. The value can also contain HTML tags.

2Authentication

In order to use the REST services you will have to properly authenticate in the web service API. In order to authenticate a request we use a MAC authentication algorithm. How this authentication algorithm has to be implemented - in case you do not use our libraries - is described in details here.

2.1Basics

The MAC authentication requires four custom HTTP headers to be sent with each request:

  • x-mac-version: To indicate the algorithm version. For the current this will always be the single digit 1.

  • x-mac-userid: The user ID (an unsigned integer) formatted as a decimal number.

  • x-mac-timestamp: The time formated as unix timestamp.

  • x-mac-value: The actual MAC value (a 64 byte value calculated as explained below) encoded in Base64 (with padding, using the standard alphabet) as defined in section 4 of RFC 4648.

Note
Splitting the Base64 string into whitespace separated chunks is accepted but not recommended.

Below you will find an example for the generation of a MAC value with example inputs including examples in some programming languages as guidelines.

2.2Getting the User ID and Authentication Key

To get the x-mac-userid you will first have to create an application user in your account. In order to do this navigate to Account > Users > Application Users and create your application user.

Once an application user is created you will see its ID in the corresponding column of the application user list. This value should be used for the x-mac-userid. In the image below it would be the userid 4.

Example Userid
Figure 1. Navigate to Account > Users > Application Users and get the userid. In this example it is the number 4.
Important
When you create a new user you will be displayed an application_user_key. This key represents the 32 byte authentication key encoded with Base-64. You should write that key down as it is used to sign the requests. For security reasons, the key will not be shown again! In case you loose the key, you will not be able to continue using that key. However you can create at any time a new key and deactivate the old one. The number of active keys a user can have is limited.

2.3Calculating the Time Stamp

The x-mac-timestamp is an unsigned integer (formatted as a decimal number) representing the number of seconds since midnight 1970‑01‑01. (See also UNIX Time Stamp in Wikipedia.)

The time in the request is needed to prevent relay attacks. In order to use the API you have to make sure that your server has set an accurate system time. We do currently allow a maximum of 600 seconds difference between our server time and your calculated time stamp.

The following example code demonstrates how to generated a time stamp using PHP:

<?php
// Assigns the current timestamp to the timestamp variable:
$timestamp = time();
?>

2.4Calculating the MAC Value

After you collected all the data you have to calculate the x-mac-value using the following input:

  1. Algorithm Version: The same fixed string as defined above in x-mac-version header.

  2. User ID: The user ID as used for the x-mac-userid header.

  3. Time stamp: The same string representing the current time as used for the x-mac-timestamp header.

  4. Method: The name of the HTTP method used for the request (as a string). This is normally one of the HTTP standard methods GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT. Note: These values are case-sensitive; the standard methods are always uppercase.

  5. Path: The path component of the requested URL, including any query string (example see below).

To calculate the MAC, the strings from these items are concatenated into a single string (the authentication message) using the vertical bar |; (U+007C) as a separator.

This string is then encoded to a sequence of bytes using the UTF-8 encoding (without any byte order mark) according to RFC 3629. These bytes form the message which will be authenticated by the MAC which we generate.

Apart from the message bytes, the HMAC-SHA512 algorithm requires a secret key. In our case this is a sequence of exactly 32 bytes which you received in Base-64 encoding as the application_user_key when you created your application user (see above for more details). With this key you apply the HMAC-SHA512 algorithm to the message bytes and will receive a 64 byte MAC value as the result. This MAC value, again encoded in Base-64 code, will then be the value of x-mac-value header.

For a better understanding you will find an abstract illustration of the MAC calculation below in various programming languages.

2.5Example

In order to illustrate the above we created an example calculation with the following input values to generate an payment page displayed in an iframe. We will guide you through the implementation first a low level implementation. However, you find further down some concrete implementation in various programming languages based on the example values below.

  1. x-mac-version header: 1

  2. x-mac-userid header: 2481632

  3. x-mac-timestamp header: 1425387916

  4. Method: GET

  5. Path: /api/transaction/read?spaceId=12&id=1

  6. Authentication-Key: OWOMg2gnaSx1nukAM6SN2vxedfY1yLPONvcTKbhDv7I=

Concatenating items 1. through 5. with | as the separator we get the following string:

1|2481632|1425387916|GET|/api/transaction/read?spaceId=12&id=1

Which, encoded with UTF-8, results in our Authentication Message (shown as a sequence of 95 bytes in hex):

0x31, 0x7c, 0x32, 0x34, 0x38, 0x31, 0x36, 0x33, 0x32, 0x7c, 0x31, 0x34, 0x32, 0x35, 0x33, 0x38,
0x37, 0x39, 0x31, 0x36, 0x7c, 0x47, 0x45, 0x54, 0x7c, 0x2f, 0x61, 0x70, 0x69, 0x2f, 0x74, 0x72,
0x61, 0x6e, 0x73, 0x61, 0x63, 0x74, 0x69, 0x6f, 0x6e, 0x2f, 0x72, 0x65, 0x61, 0x64, 0x3f, 0x73,
0x70, 0x61, 0x63, 0x65, 0x49, 0x64, 0x3d, 0x31, 0x32, 0x26, 0x69, 0x64, 0x3d, 0x31

Decoding the Authentication-Key into a sequence of 32 bytes gives:

0x39, 0x63, 0x8c, 0x83, 0x68, 0x27, 0x69, 0x2c, 0x75, 0x9e, 0xe9, 0x00, 0x33, 0xa4, 0x8d, 0xda,
0xfc, 0x5e, 0x75, 0xf6, 0x35, 0xc8, 0xb3, 0xce, 0x36, 0xf7, 0x13, 0x29, 0xb8, 0x43, 0xbf, 0xb2

Now we apply the HMAC-SHA512 function with the Authentication-Key as the key and the Authentication Message as the message and get the following 64 bytes sequence as the resulting MAC value:

0xb7, 0x3e, 0xd1, 0xa9, 0x10, 0x47, 0xf0, 0x61, 0x30, 0xdb, 0xdb, 0x63, 0xdb, 0xfc, 0x7b, 0xea,
0x8a, 0x4a, 0x9a, 0x56, 0xed, 0x86, 0x40, 0x85, 0x24, 0xba, 0xa2, 0xc2, 0x42, 0x88, 0x51, 0x90,
0x4a, 0x88, 0xcd, 0x47, 0x68, 0x77, 0xa2, 0xb0, 0x2f, 0xc8, 0x43, 0x36, 0x84, 0x80, 0x20, 0xcc,
0x83, 0x40, 0x88, 0xd2, 0x4b, 0xc9, 0x74, 0xf0, 0x26, 0x6d, 0x2d, 0x75, 0xa3, 0x1c, 0xf3, 0xe1,

The above sequence encoded in Base-64 finally gives the string which should be used as the value of the x-mac-value header:

tz7RqRBH8GEw29tj2/x76opKmlbthgSFJLqiwkKIUQlKiM1HaHeisC/IQzaEgALMgwSI0kvJdPAmbS11oxzz4Q==

2.5.1PHP

To create an authentication in PHP use the example below as an illustration on how to create the x-mac-value.

<?php
$decodedSecret = base64_decode("OWOMg2gnaSx1nukAM6SN2vxedfY1yLPONvcTKbhDv7I=");
echo base64_encode(hash_hmac("sha512", "1|2481632|1425387916|GET|/api/transaction/read?spaceId=12&id=1", $decodedSecret, true));
?>

2.5.2Java

To create an authentication in Java use the example below as an illustration on how to create the x-mac-value.

import java.nio.charset.StandardCharsets;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;
import java.util.Base64;

import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;

public class Test {
	public static void main(String[] args) throws NoSuchAlgorithmException, InvalidKeyException {
		String securedData =
				"1|2481632|1425387916|GET|/api/transaction/read?spaceId=12&id=1";

		String secret = "OWOMg2gnaSx1nukAM6SN2vxedfY1yLPONvcTKbhDv7I=";
		byte[] decodedSecret = Base64.getDecoder().decode(secret);

		Mac mac = Mac.getInstance("HmacSHA512");
		mac.init(new SecretKeySpec(decodedSecret, "HmacSHA512"));

		byte[] bytes = mac.doFinal(securedData.getBytes(StandardCharsets.UTF_8));

		System.out.println(new String(Base64.getEncoder().encode(bytes), StandardCharsets.UTF_8));
	}
}

2.5.3Python

To create an authentication in Python use the example below as an illustration on how to create the x-mac-value.

import hashlib
import hmac
import base64

def sign(secret, userId, method, path, timestamp):
    data = "1|" + str(userId) + "|"+str(timestamp)+"|" + method + "|" + path
    return hmac.new(base64.b64decode(secret), data, hashlib.sha512).digest().encode("base64").replace('\n', '')

print sign("OWOMg2gnaSx1nukAM6SN2vxedfY1yLPONvcTKbhDv7I=", "2481632", "GET", "/api/transaction/read?spaceId=12&id=1", 1425387916)

2.6MAC Calculation Illustrated

The following diagram illustrates the calculation of the complete algorithm described above:

MAC Authentication Algorithm
Figure 2. Diagram illustrating the HMAC value calculation

2.7Request Logging

In some cases it helps when you can attach to each request an ID to trace the request through different systems. By adding the HTTP header x-wallee-logtoken you can send a request token which is added to our logs and we can trace it when you get in contact with us. The log token should contain a unique ID per request.

3Services

In this section all services are described. Each service is responsible for handling one particular entity.

A service consists of different operations. Each operation may accept a set of query parameter and depending on the request method a body message. The query parameter need to be append to the request URL according to the RFC 3986. The body message has to be sent within the body of the HTTP request.

Below there is a complete HTTP request for a notional service SomeService.

POST /api/SomeService/operationName?queryParameter1=valueOfQueryParameter1&queryParameter2=value2 HTTP/1.0
x-mac-version: 1
x-mac-userid: 12313
x-mac-timestamp: 1471016771
x-mac-value: (hash-calculated as described in the previous section)

{"some-property": "some-value", "other-value": 123}

The service will return a response. Depending on the response code the body may contain some JSON object. Each service states what kind of responses can be expected.

3.1Base

3.1.1Account Service

3.1.1.1Read

Reads the entity with the given 'id' and returns it.

GET /api/account/read View in Client
Query Parameters
  • id
    *
    The id of the account which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.1.2Delete

Deletes the entity with the given id.

POST /api/account/delete View in Client
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.1.3Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/account/update View in Client
Message Body *
The account object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.1.4Search

Searches for the entities as specified by the given query.

POST /api/account/search View in Client
Message Body *
The query restricts the accounts which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Account
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.1.5Count

Counts the number of items in the database as restricted by the given filter.

POST /api/account/count View in Client
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.1.6Create

Creates the entity with the given properties.

POST /api/account/create View in Client
Message Body *
The account object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.2Analytics Query Execution Service

3.1.2.1Fetch Result

Fetches one batch of the result of a query execution.

GET /api/analytics-query/fetch-result View in Client
Query Parameters
  • id
    *
    The ID of the query execution for which to fetch the result.
    Long
  • timeout
    The maximal time in seconds to wait for the result if it is not yet available. Use 0 (the default) to return immediately without waiting.
    Integer
  • maxRows
    The maximum number of rows to return per batch. (Between 1 and 999. The default is 999.)
    Integer
  • nextToken
    The next-token of the preceding batch to get the next result batch or null to get the first result batch.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.2.2Submit Query

Submits a query for execution.

POST /api/analytics-query/submit-query View in Client
Message Body *
The query to submit.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.2.3Cancel Execution

Cancels the specified query execution.

POST /api/analytics-query/cancel-execution View in Client
Query Parameters
  • id
    *
    The ID of the query execution to cancel.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.2.4Execution Status

Returns the current status of a query execution.

GET /api/analytics-query/status View in Client
Query Parameters
  • id
    *
    The ID of the query execution for which to get the status.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.2.5Get Schemas

Get the schemas describing the available tables and their columns.

GET /api/analytics-query/schema View in Client
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.2.6Generate Download URL

Generate a URL from which the results of a query execution can be downloaded in CSV format.

GET /api/analytics-query/generate-download-url View in Client
Query Parameters
  • id
    *
    The ID of the query execution for which to generate the download URL.
    Long
  • timeout
    The maximal time in seconds to wait for the result if it is not yet available. Use 0 (the default) to return immediately without waiting.
    Integer
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    String
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.3Metric Usage Service

The metric usage service allows to query used resources.

3.1.3.1Calculate

Calculates the consumed resources for the given space and time range.

POST /api/mertic-usage/calculate View in Client
Query Parameters
  • spaceId
    *
    Long
  • start
    *
    The start date from which on the consumed units should be returned from.
    DateTime
  • end
    *
    The end date to which the consumed units should be returned to. The end date is not included in the result.
    DateTime
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Metric Usage
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.4Space Service

3.1.4.1Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/space/update View in Client
Message Body *
The space object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.4.2Create

Creates the entity with the given properties.

POST /api/space/create View in Client
Message Body *
The space object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.4.3Delete

Deletes the entity with the given id.

POST /api/space/delete View in Client
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.4.4Search

Searches for the entities as specified by the given query.

POST /api/space/search View in Client
Message Body *
The query restricts the spaces which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Space
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.4.5Count

Counts the number of items in the database as restricted by the given filter.

POST /api/space/count View in Client
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.4.6Read

Reads the entity with the given 'id' and returns it.

GET /api/space/read View in Client
Query Parameters
  • id
    *
    The id of the space which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.5Web App Service

The web app service allows to manage the installation of web apps.

3.1.5.1Confirm

This operation confirms the app installation. This method has to be invoked after the user returns to the web app. The request of the user will contain the code as a request parameter. The web app is implied by the client ID resp. user ID that is been used to invoke this operation.

POST /api/web-app/confirm View in Client
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.5.2Uninstall

This operation uninstalls the web app from the provided space. The web app is implied by the client ID resp. user ID that is been used to invoke this operation.

POST /api/web-app/uninstall View in Client
Query Parameters
  • spaceId
    *
    This parameter identifies the space within which the web app should be uninstalled.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.1.5.3Check Installation

This operation returns true when the app is installed in given space. The web app is implied by the client ID resp. user ID that is been used to invoke this operation.

GET /api/web-app/check-installation View in Client
Query Parameters
  • spaceId
    *
    This parameter identifies the space which should be checked if the web app is installed.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Boolean
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2Customer

3.2.1Customer Address Service

3.2.1.1Read

Reads the entity with the given 'id' and returns it.

GET /api/customer-address/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the customer which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.1.2selectDefaultAddress

GET /api/customer-address/select-default-address View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the customer address to set as default.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.1.3Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/customer-address/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The customer object with the properties which should be updated.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.1.4Count

Counts the number of items in the database as restricted by the given filter.

POST /api/customer-address/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.1.5Delete

Deletes the entity with the given id.

POST /api/customer-address/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.1.6Search

Searches for the entities as specified by the given query.

POST /api/customer-address/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the customers which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Customer Address
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.1.7Create

Creates the entity with the given properties.

POST /api/customer-address/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The customer object which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.2Customer Comment Service

3.2.2.1Create

Creates the entity with the given properties.

POST /api/customer-comment/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The customer object which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.2.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/customer-comment/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.2.3pinComment

GET /api/customer-comment/pin-comment View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the customer comment to pin to the top.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.2.4Read

Reads the entity with the given 'id' and returns it.

GET /api/customer-comment/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the customer which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.2.5unpinComment

GET /api/customer-comment/unpin-comment View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the customer comment to unpin.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.2.6Search

Searches for the entities as specified by the given query.

POST /api/customer-comment/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the customers which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Customer Comment
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.2.7Delete

Deletes the entity with the given id.

POST /api/customer-comment/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.2.8Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/customer-comment/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The customer object with the properties which should be updated.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.3Customer Service

3.2.3.1Search

Searches for the entities as specified by the given query.

POST /api/customer/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the customers which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Customer
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.3.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/customer/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.3.3Delete

Deletes the entity with the given id.

POST /api/customer/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.3.4Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/customer/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The customer object with the properties which should be updated.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.3.5Create

Creates the entity with the given properties.

POST /api/customer/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The customer object which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.2.3.6Read

Reads the entity with the given 'id' and returns it.

GET /api/customer/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the customer which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3Debt Collection

3.3.1Debt Collection Case Service

3.3.1.1Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/debt-collection-case/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3.1.2Add Collected Amount

Adds a new collected amount to the case, creating a new payment receipt.

POST /api/debt-collection-case/addCollectedAmount View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the debt collection case for which the amount should be added.
    Long
  • collectedAmount
    *
    The amount that has been collected.
    Decimal
  • externalId
    *
    The unique external id of this payment receipt.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3.1.3Mark Case As Reviewed

This operation will mark a debt collection case as reviewed and allow the collection process to proceed.

POST /api/debt-collection-case/markAsReviewed View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the debt collection case which should be reviewed.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3.1.4Create

Creates the entity with the given properties.

POST /api/debt-collection-case/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The debt collection case object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3.1.5Search

Searches for the entities as specified by the given query.

POST /api/debt-collection-case/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the cases which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3.1.6Attach Document

Attach an additional supporting document to the case.

POST /api/debt-collection-case/attachDocument View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the debt collection case.
    Long
  • fileName
    *
    The file name of the document that is uploaded.
    String
  • contentBase64
    *
    The BASE64 encoded contents of the document.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3.1.7Count

Counts the number of items in the database as restricted by the given filter.

POST /api/debt-collection-case/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3.1.8Mark Case As Prepared

This operation will mark a debt collection case as prepared and allow the collection process to proceed.

POST /api/debt-collection-case/markAsPrepared View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the debt collection case which should be marked as prepared.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3.1.9Delete

Deletes the entity with the given id.

POST /api/debt-collection-case/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3.1.10Close

Closes the debt collection case, meaning no further money can be collected.

POST /api/debt-collection-case/close View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the debt collection case which should be closed.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3.1.11Documents

Returns all documents that are attached to a debt collection case.

POST /api/debt-collection-case/documents View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the debt collection case for which the attached documents are returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3.1.12Read

Reads the entity with the given 'id' and returns it.

GET /api/debt-collection-case/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the debt collection case which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3.2Debt Collector Configuration Service

3.3.2.1Read

Reads the entity with the given 'id' and returns it.

GET /api/debt-collector-configuration/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the debt collector configuration which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3.2.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/debt-collector-configuration/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3.2.3Search

Searches for the entities as specified by the given query.

POST /api/debt-collector-configuration/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the debt collector configuration which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3.3Debt Collector Service

3.3.3.1Read

Reads the entity with the given 'id' and returns it.

GET /api/debt-collector/read View in Client
Query Parameters
  • id
    *
    The id of the collector which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.3.3.2All

This operation returns all entities which are available.

GET /api/debt-collector/all View in Client
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Debt Collector
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.4Document

3.4.1Document Template Service

3.4.1.1Search

Searches for the entities as specified by the given query.

POST /api/document-template/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the document templates which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Document Template
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.4.1.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/document-template/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.4.1.3Read

Reads the entity with the given 'id' and returns it.

GET /api/document-template/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the document template which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.4.2Document Template Type

3.4.2.1All

This operation returns all entities which are available.

GET /api/document-template-type/all View in Client
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.4.2.2Read

Reads the entity with the given 'id' and returns it.

GET /api/document-template-type/read View in Client
Query Parameters
  • id
    *
    The id of the document template type which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.5Installment

3.5.1Installment Payment Service

3.5.1.1Search

Searches for the entities as specified by the given query.

POST /api/installment-payment/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the installment payments which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Installment Payment
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.5.1.2Read

Reads the entity with the given 'id' and returns it.

GET /api/installment-payment/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the installment payment which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.5.1.3Count

Counts the number of items in the database as restricted by the given filter.

POST /api/installment-payment/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The filter which restricts the installment payment which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.5.1.4Create Installment Payment

This operation creates based up on the given transaction an installment payment.

POST /api/installment-payment/createInstallmentPayment View in Client
Query Parameters
  • spaceId
    *
    Long
  • transactionId
    *
    The transaction which should be converted into an installment payment.
    Long
  • installmentPlanConfiguration
    *
    The installment plan configuration ID which should be applied on the transaction.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.5.2Installment Payment Slice Service

3.5.2.1Read

Reads the entity with the given 'id' and returns it.

GET /api/installment-payment-slice/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the installment payment slice which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.5.2.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/installment-payment-slice/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The filter which restricts the installment payment slices which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.5.2.3Search

Searches for the entities as specified by the given query.

POST /api/installment-payment-slice/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the installment payment slices which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.5.3Installment Plan Calculation Service

3.5.3.1Calculate Plans

This operation allows to calculate all plans for the given transaction. The transaction will not be changed in any way.

POST /api/installment-plan-calculation/calculatePlans View in Client
Query Parameters
  • spaceId
    *
    Long
  • transactionId
    *
    The transaction for which the plans should be calculated for.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.5.4Installment Plan Configuration Service

3.5.4.1Count

Counts the number of items in the database as restricted by the given filter.

POST /api/installment-plan-configuration/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The filter which restricts the installment plan configurations which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.5.4.2Search

Searches for the entities as specified by the given query.

POST /api/installment-plan-configuration/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the installment plan configurations which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Installment Plan
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.5.4.3Read

Reads the entity with the given 'id' and returns it.

GET /api/installment-plan-configuration/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the installment plan configuration which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.5.5Installment Plan Slice Configuration

3.5.5.1Search

Searches for the entities as specified by the given query.

POST /api/installment-plan-slice-configuration/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the installment plan slice configurations which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.5.5.2Read

Reads the entity with the given 'id' and returns it.

GET /api/installment-plan-slice-configuration/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the installment plan slice configuration which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.5.5.3Count

Counts the number of items in the database as restricted by the given filter.

POST /api/installment-plan-slice-configuration/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The filter which restricts the installment plan slice configurations which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.6Internationalization

3.6.1Country Service

3.6.1.1All

This operation returns all countries.

GET /api/country/all View in Client
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Country
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.6.2Country State Service

3.6.2.1All

This operation returns all states of all countries.

GET /api/country-state/all View in Client
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of State
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.6.2.2Find by Country

This operation returns all states for a given country.

GET /api/country-state/country View in Client
Query Parameters
  • code
    *
    The country code in ISO code two letter format for which all states should be returned.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of State
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.6.3Currency Service

3.6.3.1All

This operation returns all currencies.

GET /api/currency/all View in Client
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Currency
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.6.4Language Service

3.6.4.1All

This operation returns all languages.

GET /api/language/all View in Client
Examples
GET /api/language/all HTTP/1.1
Host: app-wallee.com 
Content-Type: application/json;charset=utf-8
X-Mac-Version: 1
X-Mac-Userid: <:YOUR_USER_ID>
X-Mac-Timestamp: <:UNIX_TIMESTAMP>
X-Mac-Value: <:CALCULATED_MAC_VALUE>
$client = new \Wallee\Sdk\ApiClient(<:YOUR_USER_ID>, <:YOUR_API_KEY>);

$service = new \Wallee\Sdk\Service\LanguageService($client);
$result = $service->languageAllGet();
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Language
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.6.5Legal Organization Form Service

3.6.5.1Find by Country

This operation returns all legal organization forms for a given country.

GET /api/legal-organization-form/country View in Client
Query Parameters
  • code
    *
    The country in ISO 3166-1 alpha-2 format, for which all legal organization forms should be returned.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.6.5.2Read

Reads the entity with the given 'id' and returns it.

GET /api/legal-organization-form/read View in Client
Query Parameters
  • id
    *
    The id of the legal organization form which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.6.5.3All

This operation returns all entities which are available.

GET /api/legal-organization-form/all View in Client
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.7Label

3.7.1Label Descriptor Group Service

3.7.1.1Read

Reads the entity with the given 'id' and returns it.

GET /api/label-description-group-service/read View in Client
Query Parameters
  • id
    *
    The id of the label descriptor group which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.7.1.2All

This operation returns all entities which are available.

GET /api/label-description-group-service/all View in Client
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.7.2Label Descriptor Service

3.7.2.1Read

Reads the entity with the given 'id' and returns it.

GET /api/label-description-service/read View in Client
Query Parameters
  • id
    *
    The id of the label descriptor which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.7.2.2All

This operation returns all entities which are available.

GET /api/label-description-service/all View in Client
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Label Descriptor
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.7.3Static Value Service

3.7.3.1All

This operation returns all entities which are available.

GET /api/static-value-service/all View in Client
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Static Value
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.7.3.2Read

Reads the entity with the given 'id' and returns it.

GET /api/static-value-service/read View in Client
Query Parameters
  • id
    *
    The id of the static value which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.8Manual Task

3.8.1Manual Task Service

3.8.1.1Search

Searches for the entities as specified by the given query.

POST /api/manual-task/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the manual tasks which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Manual Task
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.8.1.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/manual-task/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.8.1.3Read

Reads the entity with the given 'id' and returns it.

GET /api/manual-task/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the manual task which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9Payment

3.9.1Bank Account Service

3.9.1.1Count

Counts the number of items in the database as restricted by the given filter.

POST /api/bank-account/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.1.2Search

Searches for the entities as specified by the given query.

POST /api/bank-account/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the bank accounts which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Bank Account
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.1.3Read

Reads the entity with the given 'id' and returns it.

GET /api/bank-account/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the bank account which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.2Bank Transaction Service

3.9.2.1Read

Reads the entity with the given 'id' and returns it.

GET /api/bank-transaction/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the bank transaction which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.2.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/bank-transaction/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.2.3Search

Searches for the entities as specified by the given query.

POST /api/bank-transaction/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the bank transactions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Bank Transaction
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.3Card Processing Service

The card processing service allows to process card data directly without using our forms. This service is only allowed to be used in a PCI DSS Level 1 compliant application.

3.9.3.1Process With 3-D Secure

The process method will process the transaction with the given card details by eventually using 3-D secure. The buyer has to be redirect to the URL returned by this method.

POST /api/card-processing/processWith3DSecure View in Client
Query Parameters
  • spaceId
    *
    Long
  • transactionId
    *
    The ID of the transaction which should be processed.
    Long
  • paymentMethodConfigurationId
    *
    The payment method configuration ID which is applied to the transaction.
    Long
Message Body *
The card details as JSON in plain which should be used to authorize the payment.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    String
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.3.2Process

The process method will process the transaction with the given card details without using 3-D secure.

POST /api/card-processing/process View in Client
Query Parameters
  • spaceId
    *
    Long
  • transactionId
    *
    The ID of the transaction which should be processed.
    Long
  • paymentMethodConfigurationId
    *
    The payment method configuration ID which is applied to the transaction.
    Long
Message Body *
The card details as JSON in plain which should be used to authorize the payment.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.4Charge Attempt Service

3.9.4.1Search

Searches for the entities as specified by the given query.

POST /api/charge-attempt/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the charge attempts which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Charge Attempt
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.4.2Read

Reads the entity with the given 'id' and returns it.

GET /api/charge-attempt/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the charge attempt which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.4.3Count

Counts the number of items in the database as restricted by the given filter.

POST /api/charge-attempt/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.5Charge Bank Transaction Service

3.9.5.1Count

Counts the number of items in the database as restricted by the given filter.

POST /api/charge-bank-transaction/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.5.2Read

Reads the entity with the given 'id' and returns it.

GET /api/charge-bank-transaction/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the charge bank transaction which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.5.3Search

Searches for the entities as specified by the given query.

POST /api/charge-bank-transaction/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the charge bank transactions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.6Charge Flow Level Payment Link Service

3.9.6.1Search

Searches for the entities as specified by the given query.

POST /api/charge-flow-level-payment-link/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the charge flow level payment links which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.6.2Read

Reads the entity with the given 'id' and returns it.

GET /api/charge-flow-level-payment-link/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the charge flow level payment link which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.6.3Count

Counts the number of items in the database as restricted by the given filter.

POST /api/charge-flow-level-payment-link/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.7Charge Flow Level Service

3.9.7.1Search

Searches for the entities as specified by the given query.

POST /api/charge-flow-level/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the payment flow levels which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Charge Flow Level
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.7.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/charge-flow-level/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.7.3Send Payment Link

Sends the payment link of the charge flow level with the given 'id'.

POST /api/charge-flow-level/sendMessage View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the charge flow level whose payment link should be sent.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.7.4Read

Reads the entity with the given 'id' and returns it.

GET /api/charge-flow-level/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the payment flow level which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.8Charge Flow Service

3.9.8.1updateRecipient

POST /api/charge-flow/updateRecipient View in Client
Query Parameters
  • spaceId
    *
    Long
  • transactionId
    *
    The transaction id of the transaction whose recipient should be updated.
    Long
  • type
    *
    The id of the charge flow configuration type to recipient should be updated for.
    Long
  • recipient
    *
    The recipient address that should be used to send the payment URL.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.8.2Fetch Charge Flow Payment Page URL

This operation allows to fetch the payment page URL that is been applied on the charge flow linked with the provided transaction. The operation might return an empty result when no payment page is needed or can be invoked.

GET /api/charge-flow/fetch-charge-flow-payment-page-url View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The transaction id of the transaction for which the URL of the charge flow should be fetched.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    String
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.8.3Count

Counts the number of items in the database as restricted by the given filter.

POST /api/charge-flow/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.8.4applyFlow

POST /api/charge-flow/applyFlow View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The transaction id of the transaction which should be process asynchronously.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.8.5Cancel Charge Flow

This operation cancels the charge flow that is linked with the transaction indicated by the given ID.

POST /api/charge-flow/cancel-charge-flow View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the transaction for which the charge flow should be canceled.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.8.6Read

Reads the entity with the given 'id' and returns it.

GET /api/charge-flow/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the charge flow which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.8.7Search

Searches for the entities as specified by the given query.

POST /api/charge-flow/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the charge flows which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Charge Flow
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.9Condition Type Service

3.9.9.1Read

Reads the entity with the given 'id' and returns it.

GET /api/condition-type/read View in Client
Query Parameters
  • id
    *
    The id of the condition type which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.9.2All

This operation returns all entities which are available.

GET /api/condition-type/all View in Client
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Condition Type
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.10Currency Bank Account Service

3.9.10.1Read

Reads the entity with the given 'id' and returns it.

GET /api/currency-bank-account/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the currency bank account which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.10.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/currency-bank-account/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.10.3Search

Searches for the entities as specified by the given query.

POST /api/currency-bank-account/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the currency bank accounts which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.11Delivery Indication Service

3.9.11.1Search

Searches for the entities as specified by the given query.

POST /api/delivery-indication/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the delivery indications which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Delivery Indication
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.11.2Read

Reads the entity with the given 'id' and returns it.

GET /api/delivery-indication/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the delivery indication which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.11.3markAsSuitable

This operation marks the delivery indication as suitable.

POST /api/delivery-indication/markAsSuitable View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The delivery indication id which should be marked as suitable.
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.11.4markAsNotSuitable

This operation marks the delivery indication as not suitable.

POST /api/delivery-indication/markAsNotSuitable View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The delivery indication id which should be marked as not suitable.
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.11.5Count

Counts the number of items in the database as restricted by the given filter.

POST /api/delivery-indication/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.12External Transfer Bank Transaction Service

3.9.12.1Read

Reads the entity with the given 'id' and returns it.

GET /api/external-transfer-bank-transaction/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the external transfer bank transaction which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.12.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/external-transfer-bank-transaction/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.12.3Search

Searches for the entities as specified by the given query.

POST /api/external-transfer-bank-transaction/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the external transfer bank transactions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.13Internal Transfer Bank Transaction Service

3.9.13.1Read

Reads the entity with the given 'id' and returns it.

GET /api/internal-transfer-bank-transaction/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the internal transfer bank transaction which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.13.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/internal-transfer-bank-transaction/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.13.3Search

Searches for the entities as specified by the given query.

POST /api/internal-transfer-bank-transaction/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the internal transfer bank transactions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.14Invoice Reconciliation Record Invoice Link Service

This service allows to link Invoice Reconciliation Records with invoices.

3.9.14.1Read

Reads the entity with the given 'id' and returns it.

GET /api/invoice-reconciliation-record-invoice-link-service/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the invoice reconciliation record invoice link which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.14.2Unlink Invoice

Unlinks the invoice reconciliation record from the provided invoice.

POST /api/invoice-reconciliation-record-invoice-link-service/unlink-transaction View in Client
Query Parameters
  • spaceId
    *
    Long
  • recordId
    *
    The ID of the invoice reconciliation record which should be unlinked.
    Long
  • completionId
    *
    The ID of the completion which should be unlinked.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.14.3Search

Searches for the entities as specified by the given query.

POST /api/invoice-reconciliation-record-invoice-link-service/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the invoice reconciliation record invoice link which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.14.4Link Invoice

Links the invoice reconciliation record with the provided invoice.

POST /api/invoice-reconciliation-record-invoice-link-service/link View in Client
Query Parameters
  • spaceId
    *
    Long
  • recordId
    *
    The ID of the invoice reconciliation record which should be linked.
    Long
  • completionId
    *
    The ID of the completion which should be linked.
    Long
  • amount
    The amount of the invoice reconciliation record linked completion which should be changed.
    Decimal
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.14.5Count

Counts the number of items in the database as restricted by the given filter.

POST /api/invoice-reconciliation-record-invoice-link-service/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.15Invoice Reconciliation Record Service

3.9.15.1Search

Searches for the entities as specified by the given query.

POST /api/invoice-reconciliation-record-service/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the invoice reconciliation records which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.15.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/invoice-reconciliation-record-service/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.15.3Read

Reads the entity with the given 'id' and returns it.

GET /api/invoice-reconciliation-record-service/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the invoice reconciliation record which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.15.4Discard

Discards the invoice reconciliation record.

POST /api/invoice-reconciliation-record-service/discard View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the invoice reconciliation record which should be discarded.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.15.5Resolve

Resolves the invoice reconciliation record.

POST /api/invoice-reconciliation-record-service/resolve View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the invoice reconciliation record which should be resolved.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.15.6Search for matchable invoices by query

Searches for transaction invoices by given query.

POST /api/invoice-reconciliation-record-service/search-for-invoices-by-query View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the invoices which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Transaction Invoice
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.16Invoice Reimbursement Service

3.9.16.1Update payment connector configuration

Updates payment connector configuration for reimbursement which is in manual review.

POST /api/invoice-reimbursement-service/update-connector View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the invoice reimbursement of which connector should be updated.
    Long
  • paymentConnectorConfigurationId
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.16.2Update IBAN

Updates recipient and/or sender IBAN for reimbursement which is in manual review.

POST /api/invoice-reimbursement-service/update-iban View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the invoice reimbursement of which IBANs should be updated.
    Long
  • recipientIban
    String
  • senderIban
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.16.3Read

Reads the entity with the given 'id' and returns it.

GET /api/invoice-reimbursement-service/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the invoice reimbursement which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.16.4Count

Counts the number of items in the database as restricted by the given filter.

POST /api/invoice-reimbursement-service/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.16.5Search

Searches for the entities as specified by the given query.

POST /api/invoice-reimbursement-service/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the invoice reimbursements which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.17Payment Connector Configuration Service

3.9.17.1Read

Reads the entity with the given 'id' and returns it.

GET /api/payment-connector-configuration/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the payment connector configuration which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.17.2Search

Searches for the entities as specified by the given query.

POST /api/payment-connector-configuration/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the payment connector configuration which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.17.3Count

Counts the number of items in the database as restricted by the given filter.

POST /api/payment-connector-configuration/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.18Payment Connector Service

3.9.18.1All

This operation returns all entities which are available.

GET /api/payment-connector/all View in Client
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Payment Connector
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.18.2Read

Reads the entity with the given 'id' and returns it.

GET /api/payment-connector/read View in Client
Query Parameters
  • id
    *
    The id of the connector which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.19Payment Link Service

The payment link service allows to manage payment links via the web service API.

3.9.19.1Search

Searches for the entities as specified by the given query.

POST /api/payment-link/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the payment links which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Payment Link
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.19.2Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/payment-link/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.19.3Delete

Deletes the entity with the given id.

POST /api/payment-link/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.19.4Read

Reads the entity with the given 'id' and returns it.

GET /api/payment-link/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the payment links which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.19.5Count

Counts the number of items in the database as restricted by the given filter.

POST /api/payment-link/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.19.6Create

Creates the entity with the given properties.

POST /api/payment-link/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The payment link object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.20Payment Method Brand Service

3.9.20.1All

This operation returns all entities which are available.

GET /api/payment-method-brand/all View in Client
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.20.2Read

Reads the entity with the given 'id' and returns it.

GET /api/payment-method-brand/read View in Client
Query Parameters
  • id
    *
    The id of the payment method brand which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.21Payment Method Configuration Service

3.9.21.1Count

Counts the number of items in the database as restricted by the given filter.

POST /api/payment-method-configuration/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.21.2Read

Reads the entity with the given 'id' and returns it.

GET /api/payment-method-configuration/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the payment method configuration which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.21.3Search

Searches for the entities as specified by the given query.

POST /api/payment-method-configuration/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the payment method configuration which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.22Payment Method Service

3.9.22.1Read

Reads the entity with the given 'id' and returns it.

GET /api/payment-method/read View in Client
Query Parameters
  • id
    *
    The id of the payment method which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.22.2All

This operation returns all entities which are available.

GET /api/payment-method/all View in Client
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Payment Method
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.23Payment Processor Configuration Service

3.9.23.1Read

Reads the entity with the given 'id' and returns it.

GET /api/payment-processor-configuration/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the payment processor configuration which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.23.2Search

Searches for the entities as specified by the given query.

POST /api/payment-processor-configuration/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the payment processor configuration which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.23.3Count

Counts the number of items in the database as restricted by the given filter.

POST /api/payment-processor-configuration/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.24Payment Processor Service

3.9.24.1Read

Reads the entity with the given 'id' and returns it.

GET /api/payment-processor/read View in Client
Query Parameters
  • id
    *
    The id of the processor which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.24.2All

This operation returns all entities which are available.

GET /api/payment-processor/all View in Client
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Payment Processor
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.25Payment Terminal Service

The payment terminal service allows to fetch the configured terminals.

3.9.25.1Unlink Device With Terminal

Unlinks the device from terminal.

POST /api/payment-terminal/unlink View in Client
Query Parameters
  • spaceId
    *
    Long
  • terminalId
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.25.2Remotely Trigger Final Balance By Identifier

Remotely triggers the final balance receipt on the terminal by terminal identifier.

POST /api/payment-terminal/trigger-final-balance-by-identifier View in Client
Query Parameters
  • spaceId
    *
    Long
  • terminalIdentifier
    *
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.25.3Remotely Trigger Final Balance

Remotely triggers the final balance receipt on the terminal.

POST /api/payment-terminal/trigger-final-balance View in Client
Query Parameters
  • spaceId
    *
    Long
  • terminalId
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.25.4Count

Counts the number of items in the database as restricted by the given filter.

POST /api/payment-terminal/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.25.5Search

Searches for the entities as specified by the given query.

POST /api/payment-terminal/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the payment terminals which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Payment Terminal
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.25.6Read

Reads the entity with the given 'id' and returns it.

GET /api/payment-terminal/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the payment terminal which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.25.7Link Device With Terminal

Links the device with given serial number with terminal.

POST /api/payment-terminal/link View in Client
Query Parameters
  • spaceId
    *
    Long
  • terminalId
    *
    Long
  • serialNumber
    *
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.26Payment Terminal Till Service

The payment terminal till service allows the till to communicate with the terminal.

3.9.26.1Perform Payment Terminal Transaction (using TID)

Starts a payment terminal transaction and waits for its completion. If the call returns with a long polling timeout status, you may try again. The processing of the transaction will be picked up where it was left off.

GET /api/payment-terminal-till/perform-transaction-by-identifier View in Client
Query Parameters
  • spaceId
    *
    Long
  • transactionId
    *
    The ID of the transaction which is used to process with the terminal.
    Long
  • terminalIdentifier
    *
    The identifier (aka TID) of the terminal which should be used to process the transaction.
    String
  • language
    The language in which the messages should be rendered in.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
  • 543
    Error
    This status code indicates that the long polling request timed out.

3.9.26.2Perform Payment Terminal Transaction

Starts a payment terminal transaction and waits for its completion. If the call returns with a long polling timeout status, you may try again. The processing of the transaction will be picked up where it was left off.

GET /api/payment-terminal-till/perform-transaction View in Client
Query Parameters
  • spaceId
    *
    Long
  • transactionId
    *
    The ID of the transaction which is used to process with the terminal.
    Long
  • terminalId
    *
    The ID of the terminal which should be used to process the transaction.
    Long
  • language
    The language in which the messages should be rendered in.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
  • 543
    Error
    This status code indicates that the long polling request timed out.

3.9.27Payment Terminal Transaction Summary Service

The payment terminal transaction summary service allows to fetch the detailed transaction summaries, such as final balance reports.

3.9.27.1Fetch Receipt

Returns the terminal receipt corresponding to the specified transaction summary id.

POST /api/payment-terminal-transaction-summary/fetch-receipt View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.27.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/payment-terminal-transaction-summary/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.27.3Search

Searches for the entities as specified by the given query.

POST /api/payment-terminal-transaction-summary/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the transaction summary reports which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Transaction summary
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.27.4Read

Reads the entity with the given 'id' and returns it.

GET /api/payment-terminal-transaction-summary/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction summary report which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.28Payment Web App Service

The payment web app service allows to insert payment processors through a web app.

3.9.28.1Activate Processor for Production

This operation marks the processor to be usable within the production environment.

POST /api/payment-web-app/activate-processor-for-production View in Client
Query Parameters
  • spaceId
    *
    The space ID identifies the space in which the processor is installed in.
    Long
  • externalId
    *
    The external ID identifies the processor. The external ID corresponds to the ID provided during inserting of the processor.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.28.2Delete Processor

This operation removes the web app payment processor and its connectors from the given space.

POST /api/payment-web-app/delete-processor View in Client
Query Parameters
  • spaceId
    *
    The space ID identifies the space in which the processor is installed in.
    Long
  • externalId
    *
    The external ID identifies the processor. The external ID corresponds to the ID provided during inserting of the processor.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.28.3Insert or Update Processor

This operation inserts or updates a web app payment processor.

POST /api/payment-web-app/insert-or-update-processor View in Client
Query Parameters
  • spaceId
    *
    The space ID identifies the space into which the processor should be inserted into.
    Long
Message Body *
The processor object contains all the details required to create or update a web app processor.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.28.4Update Void

This operation updates the state of the transaction void. This method can be invoked for transactions originally created with a processor associated with the web app that invokes this operation. The returned void corresponds to the void indicated in the request.

POST /api/payment-web-app/update-void View in Client
Query Parameters
  • spaceId
    *
    This is the ID of the space in which the void is located in.
    Long
Message Body *
The void update request allows to update the state of a void.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.28.5Update Refund

This operation updates the state of the refund. This method can be invoked for transactions originally created with a processor associated with the web app that invokes this operation. The returned refund corresponds to the refund indicated in the request.

POST /api/payment-web-app/update-refund View in Client
Query Parameters
  • spaceId
    *
    This is the ID of the space in which the refund is located in.
    Long
Message Body *
The refund update request allows to update the state of a refund.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.28.6Insert or Update Connector

This operation inserts or updates a web app payment connector.

POST /api/payment-web-app/insert-or-update-connector View in Client
Query Parameters
  • spaceId
    *
    The space ID identifies the space into which the connector should be inserted into.
    Long
Message Body *
The connector object contains all the details required to create or update a web app connector.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.28.7Update Charge Attempt

This operation updates the state of the charge attempt. This method can be invoked for transactions originally created with a processor associated with the web app that invokes this operation. The returned charge attempt corresponds to the charge attempt indicated in the request.

POST /api/payment-web-app/update-charge-attempt View in Client
Query Parameters
  • spaceId
    *
    This is the ID of the space in which the charge attempt is located in.
    Long
Message Body *
The charge attempt update request allows to update the state of a charge attempt.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.28.8Update Completion

This operation updates the state of the transaction completion. This method can be invoked for transactions originally created with a processor associated with the web app that invokes this operation. The returned completion corresponds to the completion indicated in the request.

POST /api/payment-web-app/update-completion View in Client
Query Parameters
  • spaceId
    *
    This is the ID of the space in which the completion is located in.
    Long
Message Body *
The completion update request allows to update the state of a completion.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.28.9Delete Connector

This operation removes the web app payment connector from the given space.

POST /api/payment-web-app/delete-connector View in Client
Query Parameters
  • spaceId
    *
    The space ID identifies the space in which the connector is installed in.
    Long
  • externalId
    *
    The external ID identifies the connector. The external ID corresponds to the ID provided during inserting of the connector.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.29Refund Bank Transaction Service

3.9.29.1Count

Counts the number of items in the database as restricted by the given filter.

POST /api/refund-bank-transaction/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.29.2Search

Searches for the entities as specified by the given query.

POST /api/refund-bank-transaction/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the refund bank transactions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.29.3Read

Reads the entity with the given 'id' and returns it.

GET /api/refund-bank-transaction/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the refund bank transaction which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.30Refund Comment Service

3.9.30.1Delete

Deletes the comment with the given id.

POST /api/refund-comment/delete View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.30.2Read

Reads the comment with the given 'id' and returns it.

GET /api/refund-comment/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.30.3Find by refund

Returns all comments of the given refund.

POST /api/refund-comment/all View in Client
Query Parameters
  • spaceId
    *
    Long
  • refundId
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Refund Comment
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.30.4Update

This updates the comment with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the comment.

POST /api/refund-comment/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.30.5Pin

Pins the comment to the top.

GET /api/refund-comment/pin View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.30.6Create

Creates the comment with the given properties.

POST /api/refund-comment/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.30.7Unpin

Unpins the comment from the top.

GET /api/refund-comment/unpin View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.31Refund Recovery Bank Transaction Service

3.9.31.1Search

Searches for the entities as specified by the given query.

POST /api/refund-recovery-bank-transaction/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the refund recovery bank transactions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.31.2Read

Reads the entity with the given 'id' and returns it.

GET /api/refund-recovery-bank-transaction/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the refund recovery bank transaction which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.31.3Count

Counts the number of items in the database as restricted by the given filter.

POST /api/refund-recovery-bank-transaction/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.32Refund Service

3.9.32.1getRefundDocumentWithTargetMediaType

Returns the PDF document for the refund with given id and the given target media type.

GET /api/refund/getRefundDocumentWithTargetMediaType View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the refund to get the document for.
    Long
  • targetMediaTypeId
    *
    The id of the target media type for which the refund should be generated for.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.32.2getRefundDocument

Returns the PDF document for the refund with given id.

GET /api/refund/getRefundDocument View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the refund to get the document for.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.32.3create

This operation creates and executes a refund of a particular transaction.

POST /api/refund/refund View in Client
Examples
use Wallee\Sdk\ApiClient;
use Wallee\Sdk\Model\AddressCreate;
use Wallee\Sdk\Model\LineItemCreate;
use Wallee\Sdk\Model\LineItemType;
use Wallee\Sdk\Model\RefundCreate;
use Wallee\Sdk\Model\RefundState;
use Wallee\Sdk\Model\RefundType;
use Wallee\Sdk\Model\TransactionCreate;
use Wallee\Sdk\Model\TransactionState;
use Wallee\Sdk\Service\RefundService;
use Wallee\Sdk\Service\TransactionService;

// credentials
$spaceId = <:YOUR_SPACE_ID>;
$userId = <:YOUR_USER_ID>;
$secret = <:YOUR_USER_SECRET>;

// Services
$apiClient = new ApiClient($userId, $secret);
$transactionService = new TransactionService($apiClient);
$refundService = new RefundService($apiClient);

// line item
$lineItem = new LineItemCreate();
$lineItem->setName('Red T-Shirt');
$lineItem->setUniqueId('5412');
$lineItem->setSku('red-t-shirt-123');
$lineItem->setQuantity(1);
$lineItem->setAmountIncludingTax(29.95);
$lineItem->setType(LineItemType::PRODUCT);

// Customer Billing Address
$billingAddress = new AddressCreate();
$billingAddress->setCity('Winterthur');
$billingAddress->setCountry('CH');
$billingAddress->setEmailAddress('test@example.com');
$billingAddress->setFamilyName('Customer');
$billingAddress->setGivenName('Good');
$billingAddress->setPostCode('8400');
$billingAddress->setPostalState('ZH');
$billingAddress->setOrganizationName('Test GmbH');
$billingAddress->setPhoneNumber('+41791234567');
$billingAddress->setSalutation('Ms');

// Transaction payload
$transactionPayload = new TransactionCreate();
$transactionPayload->setCurrency('CHF');
$transactionPayload->setLineItems([$lineItem]);
$transactionPayload->setAutoConfirmationEnabled(true);
$transactionPayload->setBillingAddress($billingAddress);
$transactionPayload->setShippingAddress($billingAddress);
$transactionPayload->setFailedUrl('https://YOUR.SITE/transaction?state=fail');
$transactionPayload->setSuccessUrl('https://YOUR.SITE/transaction?state=success');

// Create a transaction
$transaction = $transactionService->create($spaceId, $transactionPayload);
$transaction = $transactionService->processWithoutUserInteraction($spaceId, $transaction->getId());

// Fetch the transaction you would like to refund 
$transaction = $this->transactionService->read($this->spaceId, $transaction->getId());
if (in_array($transaction->getState(), [TransactionState::FULFILL])) {

    // Refund payload
    $refundPayload = new RefundCreate();
    $refundPayload->setAmount($transaction->getAuthorizationAmount());
    $refundPayload->setTransaction($transaction->getId());
    $refundPayload->setMerchantReference($transaction->getMerchantReference());
    $refundPayload->setExternalId($transaction->getId());
    $refundPayload->setType(RefundType::MERCHANT_INITIATED_ONLINE);

    $refund = $refundService->refund($this->spaceId, $refundPayload);
    if(in_array($refund->getState(), [RefundState::SUCCESSFUL])){
        // refund successful
    }
}
package com.wallee.sdk.test;

import com.wallee.sdk.ApiClient;
import com.wallee.sdk.model.*;
import com.wallee.sdk.service.*;

import java.math.BigDecimal;

/**
 * API tests for RefundService
 */
public class RefundServiceTest {

    // Credentials
    private Long spaceId = <:YOUR_SPACE_ID>;
    private Long applicationUserId = <:YOUR_USER_ID>;
    private String authenticationKey = <:YOUR_USER_SECRET>;

    // Services
    private ApiClient apiClient;
    private RefundService refundService;
    private TransactionCompletionService transactionCompletionService;
    private TransactionService transactionService;

    // Models
    private TransactionCreate transactionPayload;

    public RefundServiceTest() {
        this.apiClient = new ApiClient(applicationUserId, authenticationKey);
        this.refundService = new RefundService(this.apiClient);
        this.transactionCompletionService = new TransactionCompletionService(this.apiClient);
        this.transactionService = new TransactionService(this.apiClient);
    }

    /**
     * Get transaction payload
     *
     * @return TransactionCreate
     */
    private TransactionCreate getTransactionPayload() {
        if (this.transactionPayload == null) {
            // Line item
            LineItemCreate lineItem = new LineItemCreate();
            lineItem.name("Red T-Shirt")
                .uniqueId("5412")
                .type(LineItemType.PRODUCT)
                .quantity(BigDecimal.valueOf(1))
                .amountIncludingTax(BigDecimal.valueOf(29.95))
                .sku("red-t-shirt-123");

            // Customer Billind Address
            AddressCreate billingAddress = new AddressCreate();
            billingAddress.city("Winterthur")
                .country("CH")
                .emailAddress("test@example.com")
                .familyName("Customer")
                .givenName("Good")
                .postcode("8400")
                .postalState("ZH")
                .organizationName("Test GmbH")
                .mobilePhoneNumber("+41791234567")
                .salutation("Ms");

            this.transactionPayload = new TransactionCreate();
            this.transactionPayload.autoConfirmationEnabled(true).currency("CHF").language("en-US");
            this.transactionPayload.setBillingAddress(billingAddress);
            this.transactionPayload.setShippingAddress(billingAddress);
            this.transactionPayload.addLineItemsItem(lineItem);
        }
        return this.transactionPayload;
    }

    /**
     * Get refund payload
     *
     * @param transaction
     * @return
     */
    private RefundCreate getRefundPayload(Transaction transaction) {
        RefundCreate refundPayload = new RefundCreate();
        refundPayload.amount(transaction.getAuthorizationAmount())
            .transaction(transaction.getId())
            .merchantReference(transaction.getMerchantReference())
            .externalId(transaction.getId().toString())
            .type(RefundType.MERCHANT_INITIATED_ONLINE);
        return refundPayload;
    }

    /**
     * create
     *
     * This operation creates and executes a refund of a particular transaction.
     */
    public void refund() {
        try {
            Transaction transaction = this.transactionService.create(this.spaceId, this.getTransactionPayload());
            transaction = this.transactionService.processWithoutUserInteraction(this.spaceId, transaction.getId());
            for (int i = 1; i <= 5; i++) {
                if (
                    transaction.getState() == TransactionState.FULFILL ||
                    transaction.getState() == TransactionState.FAILED
                ) {
                    break;
                }

                try {
                    Thread.sleep(i * 30);
                } catch (InterruptedException e) {
                    System.err.println(e.getMessage());
                }
                transaction = this.transactionService.read(this.spaceId, transaction.getId());
            }

            if (transaction.getState() == TransactionState.FULFILL) {
                TransactionCompletion transactionCompletion = this.transactionCompletionService.completeOffline(this.spaceId, transaction.getId());
                transaction = this.transactionService.read(transaction.getLinkedSpaceId(), transactionCompletion.getLinkedTransaction());
                Refund refund = this.refundService.refund(this.spaceId, getRefundPayload(transaction));
                // expect refund.getState() to equal RefundState.SUCCESSFUL
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
using System;
using System.IO;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Linq;
using System.Reflection;
using RestSharp;
using NUnit.Framework;

using Wallee.Model;
using Wallee.Service;
using Wallee.Client;

namespace Wallee.RefundServiceExample
{
    /// <summary>
    ///  Class for RefundServiceExample
    /// </summary>
    public class RefundServiceExample
    {
        private readonly long SpaceId = <:YOUR_SPACE_ID>;
        private readonly string ApplicationUserID = <:YOUR_USER_ID>;
        private readonly string AuthenticationKey = <:YOUR_USER_SECRET>;

        private Configuration Configuration;
        private RefundService RefundService;
        private Transaction Transaction;
        private TransactionCompletionService TransactionCompletionService;
        private TransactionCreate TransactionPayload;
        private TransactionService TransactionService;

        /// <summary>
        /// RefundServiceExample
        /// </summary>
        public RefundServiceExample()
        {
            this.Configuration = new Configuration(this.ApplicationUserID, this.AuthenticationKey);
            this.RefundService = new RefundService(this.Configuration);
            this.TransactionCompletionService = new TransactionCompletionService(this.Configuration);
            this.TransactionService = new TransactionService(this.Configuration);
        }

        // <summary>
        // Get transaction payload
        // <summary>
        private TransactionCreate GetTransactionPayload()
        {
            if (this.TransactionPayload == null)
            {
                // Line item
                LineItemCreate lineItem1 = new LineItemCreate(
                    name: "Red T-Shirt",
                    uniqueId: "5412",
                    type: LineItemType.PRODUCT,
                    quantity: 1,
                    amountIncludingTax: (decimal)29.95
                )
                {
                    Sku = "red-t-shirt-123"
                };

                // Customer Billind Address
                AddressCreate billingAddress = new AddressCreate
                {
                    City = "Winterthur",
                    Country = "CH",
                    EmailAddress = "test@example.com",
                    FamilyName = "Customer",
                    GivenName = "Good",
                    Postcode = "8400",
                    PostalState = "ZH",
                    OrganizationName = "Test GmbH",
                    MobilePhoneNumber = "+41791234567",
                    Salutation = "Ms"
                };

                this.TransactionPayload = new TransactionCreate(new List<LineItemCreate>() { lineItem1 })
                {
                    Currency = "CHF",
                    AutoConfirmationEnabled = true,
                    BillingAddress = billingAddress,
                    ShippingAddress = billingAddress,
                    Language = "en-US"
                };
            }
            return this.TransactionPayload;
        }

        /// <summary>
        /// Create Transaction
        /// </summary>
        private Transaction GetTransaction()
        {
            return this.TransactionService.Create(this.SpaceId, this.GetTransactionPayload());
        }


        // <summary>
        // Get refund payload
        // <summary>
        private RefundCreate GetRefundPayload(Transaction transaction)
        {
            RefundCreate refundPayload = new RefundCreate(transaction.Id.ToString(), RefundType.MERCHANT_INITIATED_ONLINE)
            {
                Amount = transaction.AuthorizationAmount,
                Transaction = transaction.Id,
                MerchantReference = transaction.MerchantReference
            };
            return refundPayload;
        }

        /// <summary>
        /// Refund
        /// </summary>
        public void Refund()
        {
            this.Transaction = this.GetTransaction();
            Transaction transaction = this.TransactionService.ProcessWithoutUserInteraction(this.SpaceId, this.Transaction.Id);
            TransactionState[] TransactionStates = {
                TransactionState.FAILED,
                TransactionState.FULFILL
            };
            for (var i = 1; i <= 5; i++) {
                if (Array.Exists(TransactionStates, element => element == transaction.State)){
                    break;
                }
                System.Threading.Thread.Sleep(i * 30); // keep waiting for the transaction to transition to FULFILL or FAIL
                transaction = this.TransactionService.Read(this.SpaceId, transaction.Id);
            }

            if (transaction.State == TransactionState.FULFILL){
                TransactionCompletion transactionCompletion = this.TransactionCompletionService.CompleteOffline(this.SpaceId, transaction.Id);
                transaction = this.TransactionService.Read(this.SpaceId, transactionCompletion.LinkedTransaction);  // fetch the latest transaction data
                RefundCreate refundPayload = this.GetRefundPayload(transaction);
                Refund refund = this.RefundService.Refund(this.SpaceId, refundPayload);
            }
        }
    }
}
'use strict';
import { Wallee } from 'wallee';
import http = require("http");

// config
let config: { space_id: number, user_id: number, api_secret: string } = {
    space_id: <:YOUR_SPACE_ID>,
    user_id: <:YOUR_USER_ID>,
    api_secret: <:YOUR_USER_SECRET>
};

// Services
let refundService: Wallee.api.RefundService = new Wallee.api.RefundService(config);
let transactionCompletionService: Wallee.api.TransactionCompletionService = new Wallee.api.TransactionCompletionService(config);
let transactionService: Wallee.api.TransactionService = new Wallee.api.TransactionService(config);

// Models
let transactionPayload: Wallee.model.TransactionCreate;

/**
 * Get transaction payload
 */
function getTransactionPayload(): Wallee.model.TransactionCreate {
    if (!transactionPayload) {
        // Line item
        let lineItem: Wallee.model.LineItemCreate = new Wallee.model.LineItemCreate();
        lineItem.name = 'Red T-Shirt';
        lineItem.uniqueId = '5412';
        lineItem.type = Wallee.model.LineItemType.PRODUCT;
        lineItem.quantity = 1;
        lineItem.amountIncludingTax = 29.95;
        lineItem.sku = 'red-t-shirt-123';

        // Customer Billing Address
        let billingAddress: Wallee.model.AddressCreate = new Wallee.model.AddressCreate();
        billingAddress.city = "Winterthur";
        billingAddress.country = "CH";
        billingAddress.emailAddress = "test@example.com";
        billingAddress.familyName = "Customer";
        billingAddress.givenName = "Good";
        billingAddress.postcode = "8400";
        billingAddress.postalState = "ZH";
        billingAddress.organizationName = "Test GmbH";
        billingAddress.mobilePhoneNumber = "+41791234567";
        billingAddress.salutation = "Ms";

        // Payload
        transactionPayload = new Wallee.model.TransactionCreate();
        transactionPayload.lineItems = [lineItem];
        transactionPayload.autoConfirmationEnabled = true;
        transactionPayload.currency = 'CHF';
        transactionPayload.billingAddress = billingAddress;
        transactionPayload.shippingAddress = billingAddress;
    }

    return transactionPayload;
}

/**
 * Get refund payload
 */
function getRefundPayload(transaction: Wallee.model.Transaction): Wallee.model.RefundCreate {
    let refundPayload: Wallee.model.RefundCreate = new Wallee.model.RefundCreate();
    refundPayload.externalId = <string><any>transaction.id;
    refundPayload.type = Wallee.model.RefundType.MERCHANT_INITIATED_ONLINE;
    refundPayload.amount = transaction.authorizationAmount;
    refundPayload.transaction = transaction.id;
    refundPayload.merchantReference = transaction.merchantReference;
    return refundPayload;
}

// Refund a transaction
let transaction: Wallee.model.Transaction;
let refund: Wallee.model.Refund;
transactionService.create(config.space_id, getTransactionPayload())
    .then((response: { response: http.IncomingMessage, body: Wallee.model.Transaction }) => {
        transaction = response.body;
        return transactionService.processWithoutUserInteraction(config.space_id, <number>transaction.id);
    })
    .delay(15000)
    .then((response: { response: http.IncomingMessage, body: Wallee.model.Transaction }) => {
        transaction = response.body;
        return transactionCompletionService.completeOffline(config.space_id, <number>transaction.id)
            .then((response1: { response: http.IncomingMessage, body: Wallee.model.TransactionCompletion }) => {
                return transactionService.read(config.space_id, <number>transaction.id);
            });
    }).then((response: { response: http.IncomingMessage, body: Wallee.model.Transaction }) => {
        transaction = response.body;
        return refundService.refund(config.space_id, getRefundPayload(transaction));
    }).done((response: { response: http.IncomingMessage, body: Wallee.model.Refund }) => {
        refund = response.body;
        // expect refund.state to equal Wallee.model.RefundState.SUCCESSFUL
    });
Query Parameters
  • spaceId
    *
    Long
Message Body *
The refund object which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.32.4Search

Searches for the entities as specified by the given query.

POST /api/refund/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the refunds which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Refund
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.32.5fail

This operation allows to mark a refund as failed which is in state MANUAL_CHECK.

POST /api/refund/fail View in Client
Query Parameters
  • spaceId
    *
    Long
  • refundId
    *
    The id of the refund which should be marked as failed.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.32.6Read

Reads the entity with the given 'id' and returns it.

GET /api/refund/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the refund which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.32.7succeed

This operation allows to mark a refund as successful which is in state MANUAL_CHECK.

POST /api/refund/succeed View in Client
Query Parameters
  • spaceId
    *
    Long
  • refundId
    *
    The id of the refund which should be marked as successful.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.32.8Count

Counts the number of items in the database as restricted by the given filter.

POST /api/refund/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.33Token Service

3.9.33.1Create Token Based On Transaction

This operation creates a token for the given transaction and fills it with the stored payment information of the transaction.

POST /api/token/create-token-based-on-transaction View in Client
Query Parameters
  • spaceId
    *
    Long
  • transactionId
    *
    The id of the transaction for which we want to create the token.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.33.2Search

Searches for the entities as specified by the given query.

POST /api/token/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the tokens which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Token
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.33.3Process Transaction

This operation processes the given transaction by using the token associated with the transaction.

POST /api/token/process-transaction View in Client
Query Parameters
  • spaceId
    *
    Long
  • transactionId
    *
    The id of the transaction for which we want to check if the token can be created or not.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.33.4Check If Token Creation Is Possible

This operation checks if the given transaction can be used to create a token out of it.

POST /api/token/check-token-creation-possible View in Client
Query Parameters
  • spaceId
    *
    Long
  • transactionId
    *
    The id of the transaction for which we want to check if the token can be created or not.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Boolean
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.33.5Delete

Deletes the entity with the given id.

POST /api/token/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.33.6Read

Reads the entity with the given 'id' and returns it.

GET /api/token/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the token which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.33.7Create

Creates the entity with the given properties.

POST /api/token/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The token object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.33.8Count

Counts the number of items in the database as restricted by the given filter.

POST /api/token/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.33.9Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/token/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.33.10Create Transaction for Token Update

This operation creates a transaction which allows the updating of the provided token.

POST /api/token/createTransactionForTokenUpdate View in Client
Query Parameters
  • spaceId
    *
    Long
  • tokenId
    *
    The id of the token which should be updated.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.33.11Create Token

This operation creates a token for the given transaction.

POST /api/token/create-token View in Client
Query Parameters
  • spaceId
    *
    Long
  • transactionId
    *
    The id of the transaction for which we want to create the token.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.34Token Version Service

3.9.34.1Active Version

Returns the token version which is currently active given by the token id. In case no token version is active the method will return null.

GET /api/token-version/active-version View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of a token for which you want to look up the current active token version.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.34.2Search

Searches for the entities as specified by the given query.

POST /api/token-version/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the token versions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Token Version
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.34.3Count

Counts the number of items in the database as restricted by the given filter.

POST /api/token-version/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.34.4Read

Reads the entity with the given 'id' and returns it.

GET /api/token-version/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the token version which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.35Transaction Comment Service

3.9.35.1Create

Creates the comment with the given properties.

POST /api/transaction-comment/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.35.2Read

Reads the comment with the given 'id' and returns it.

GET /api/transaction-comment/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.35.3Find by transaction

Returns all comments of the transaction.

POST /api/transaction-comment/all View in Client
Query Parameters
  • spaceId
    *
    Long
  • transactionId
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Transaction Comment
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.35.4Unpin

Unpins the comment from the top.

GET /api/transaction-comment/unpin View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.35.5Pin

Pins the comment to the top.

GET /api/transaction-comment/pin View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.35.6Update

This updates the comment with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the comment.

POST /api/transaction-comment/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.35.7Delete

Deletes the comment with the given id.

POST /api/transaction-comment/delete View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.36Transaction Completion Service

3.9.36.1Read

Reads the entity with the given 'id' and returns it.

GET /api/transaction-completion/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction completions which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.36.2completePartiallyOnline

This operation can be used to partially complete the transaction online. The completion is forwarded to the processor. This implies that the processor may take some actions based on the completion.

POST /api/transaction-completion/completePartiallyOnline View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.36.3completeOnline

This operation completes the transaction online. The completion is forwarded to the processor. This implies that the processor may take some actions based on the completion.

POST /api/transaction-completion/completeOnline View in Client
Examples
use Wallee\Sdk\ApiClient;
use Wallee\Sdk\Model\AddressCreate;
use Wallee\Sdk\Model\LineItemCreate;
use Wallee\Sdk\Model\LineItemType;
use Wallee\Sdk\Model\TransactionCompletionState;
use Wallee\Sdk\Model\TransactionCreate;
use Wallee\Sdk\Model\TransactionState;
use Wallee\Sdk\Service\TransactionCompletionService;
use Wallee\Sdk\Service\TransactionService;

// credentials
$spaceId = <:YOUR_SPACE_ID>;
$userId = <:YOUR_USER_ID>;
$secret = <:YOUR_USER_SECRET>;

// Services
$apiClient = new ApiClient($userId, $secret);
$transactionCompletionService = new TransactionCompletionService($apiClient);
$transactionService = new TransactionService($apiClient);

// line item
$lineItem = new LineItemCreate();
$lineItem->setName('Red T-Shirt');
$lineItem->setUniqueId('5412');
$lineItem->setSku('red-t-shirt-123');
$lineItem->setQuantity(1);
$lineItem->setAmountIncludingTax(29.95);
$lineItem->setType(LineItemType::PRODUCT);

// Customer Billing Address
$billingAddress = new AddressCreate();
$billingAddress->setCity('Winterthur');
$billingAddress->setCountry('CH');
$billingAddress->setEmailAddress('test@example.com');
$billingAddress->setFamilyName('Customer');
$billingAddress->setGivenName('Good');
$billingAddress->setPostCode('8400');
$billingAddress->setPostalState('ZH');
$billingAddress->setOrganizationName('Test GmbH');
$billingAddress->setPhoneNumber('+41791234567');
$billingAddress->setSalutation('Ms');

// Transaction payload
$transactionPayload = new TransactionCreate();
$transactionPayload->setCurrency('CHF');
$transactionPayload->setLineItems([$lineItem]);
$transactionPayload->setAutoConfirmationEnabled(true);
$transactionPayload->setBillingAddress($billingAddress);
$transactionPayload->setShippingAddress($billingAddress);
$transactionPayload->setFailedUrl('https://YOUR.SITE/transaction?state=fail');
$transactionPayload->setSuccessUrl('https://YOUR.SITE/transaction?state=success');

// Create a transaction
$transaction = $transactionService->create($spaceId, $transactionPayload);
$transaction = $transactionService->processWithoutUserInteraction($spaceId, $transaction->getId());

// Complete a transaction offline
$transactionCompletion = $this->transactionCompletionService->completeOnline($this->spaceId, $transaction->getId());
if(in_array($transactionCompletion->getState(), [TransactionCompletionState::SUCCESSFUL])){
    // completion successful
}
package com.wallee.sdk.test;

import com.wallee.sdk.ApiClient;
import com.wallee.sdk.model.*;
import com.wallee.sdk.service.*;

import java.math.BigDecimal;

/**
 * API tests for TransactionCompletionService
 */
public class TransactionCompletionServiceTest {

    // Credentials
    private Long spaceId = <:YOUR_SPACE_ID>;
    private Long applicationUserId = <:YOUR_USER_ID>;
    private String authenticationKey = <:YOUR_USER_SECRET>;

    // Services
    private ApiClient apiClient;
    private TransactionCompletionService transactionCompletionService;
    private TransactionService transactionService;

    // Models
    private TransactionCreate transactionPayload;

    public TransactionCompletionServiceTest() {
        this.apiClient = new ApiClient(applicationUserId, authenticationKey);
        this.transactionCompletionService = new TransactionCompletionService(this.apiClient);
        this.transactionService = new TransactionService(this.apiClient);
    }

    /**
     * Get transaction payload
     *
     * @return TransactionCreate
     */
    private TransactionCreate getTransactionPayload() {
        if (this.transactionPayload == null) {
            // Line item
            LineItemCreate lineItem = new LineItemCreate();
            lineItem.name("Red T-Shirt")
                .uniqueId("5412")
                .type(LineItemType.PRODUCT)
                .quantity(BigDecimal.valueOf(1))
                .amountIncludingTax(BigDecimal.valueOf(29.95))
                .sku("red-t-shirt-123");

            // Customer Billind Address
            AddressCreate billingAddress = new AddressCreate();
            billingAddress.city("Winterthur")
                .country("CH")
                .emailAddress("test@example.com")
                .familyName("Customer")
                .givenName("Good")
                .postcode("8400")
                .postalState("ZH")
                .organizationName("Test GmbH")
                .mobilePhoneNumber("+41791234567")
                .salutation("Ms");

            this.transactionPayload = new TransactionCreate();
            this.transactionPayload.autoConfirmationEnabled(true).currency("CHF").language("en-US");
            this.transactionPayload.setBillingAddress(billingAddress);
            this.transactionPayload.setShippingAddress(billingAddress);
            this.transactionPayload.addLineItemsItem(lineItem);
        }
        return this.transactionPayload;
    }

    /**
     * completeOnline
     *
     * This operation completes the transaction online. The completion is forwarded to the processor. This implies that the processor may take some actions based on the completion.
     */
    public void completeOnline() {
        try {
            Transaction transaction = this.transactionService.create(this.spaceId, this.getTransactionPayload());
            transaction = this.transactionService.processWithoutUserInteraction(this.spaceId, transaction.getId());
            TransactionCompletion transactionCompletion = this.transactionCompletionService.completeOnline(this.spaceId, transaction.getId());
            TransactionCompletionState[] TransactionCompletionStates = {
                TransactionCompletionState.SUCCESSFUL,
                TransactionCompletionState.PENDING
            };
            // expect transactionCompletion.getState() to be in TransactionCompletionStates
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
using System;
using System.IO;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Linq;
using System.Reflection;
using RestSharp;
using NUnit.Framework;

using Wallee.Model;
using Wallee.Service;
using Wallee.Client;

namespace Wallee.TransactionCompletionServiceExample
{
    /// <summary>
    ///  Class for TransactionCompletionServiceExample
    /// </summary>
    public class TransactionCompletionServiceExample
    {
        private readonly long SpaceId = <:YOUR_SPACE_ID>;
        private readonly string ApplicationUserID = <:YOUR_USER_ID>;
        private readonly string AuthenticationKey = <:YOUR_USER_SECRET>;

        private TransactionCompletionService TransactionCompletionService;
        private TransactionService TransactionService;


        /// <summary>
        /// TransactionCompletionServiceExample
        /// </summary>
        public TransactionCompletionServiceExample()
        {
            Configuration configuration = new Configuration(this.ApplicationUserID, this.AuthenticationKey);
            this.TransactionCompletionService = new TransactionCompletionService(configuration);
            this.TransactionService = new TransactionService(configuration);
        }

        // <summary>
        // Get transaction payload
        // <summary>
        private TransactionCreate GetTransactionPayload()
        {
            // Line item
            LineItemCreate lineItem1 = new LineItemCreate(
                name: "Red T-Shirt",
                uniqueId: "5412",
                type: LineItemType.PRODUCT,
                quantity: 1,
                amountIncludingTax: (decimal)29.95
            )
            {
                Sku = "red-t-shirt-123"
            };

            // Customer Billind Address
            AddressCreate billingAddress = new AddressCreate
            {
                City = "Winterthur",
                Country = "CH",
                EmailAddress = "test@example.com",
                FamilyName = "Customer",
                GivenName = "Good",
                Postcode = "8400",
                PostalState = "ZH",
                OrganizationName = "Test GmbH",
                MobilePhoneNumber = "+41791234567",
                Salutation = "Ms"
            };

            TransactionCreate transactionPayload = new TransactionCreate(new List<LineItemCreate>() { lineItem1 })
            {
                Currency = "CHF",
                AutoConfirmationEnabled = true,
                BillingAddress = billingAddress,
                ShippingAddress = billingAddress,
                Language = "en-US"
            };
            return transactionPayload;
        }

        /// <summary>
        /// CompleteOnline
        /// </summary>
        public void CompleteOnline()
        {
            Transaction transaction = this.TransactionService.Create(this.SpaceId, this.GetTransactionPayload());
            transaction = this.TransactionService.ProcessWithoutUserInteraction(this.SpaceId, transaction.Id);
            TransactionCompletion transactionCompletion = this.TransactionCompletionService.CompleteOnline(this.SpaceId, transaction.Id);
        }
    }
}
'use strict';
import { Wallee } from 'wallee';
import http = require("http");

// config
let config: { space_id: number, user_id: number, api_secret: string } = {
    space_id: <:YOUR_SPACE_ID>,
    user_id: <:YOUR_USER_ID>,
    api_secret: <:YOUR_USER_SECRET>
};

// Services
let transactionCompletionService: Wallee.api.TransactionCompletionService = new Wallee.api.TransactionCompletionService(config);
let transactionService: Wallee.api.TransactionService = new Wallee.api.TransactionService(config);

// Models
let transactionPayload: Wallee.model.TransactionCreate;

/**
 * Get transaction payload
 */
function getTransactionPayload(): Wallee.model.TransactionCreate {
    if (!transactionPayload) {
        // Line item
        let lineItem: Wallee.model.LineItemCreate = new Wallee.model.LineItemCreate();
        lineItem.name = 'Red T-Shirt';
        lineItem.uniqueId = '5412';
        lineItem.type = Wallee.model.LineItemType.PRODUCT;
        lineItem.quantity = 1;
        lineItem.amountIncludingTax = 29.95;
        lineItem.sku = 'red-t-shirt-123';

        // Customer Billing Address
        let billingAddress: Wallee.model.AddressCreate = new Wallee.model.AddressCreate();
        billingAddress.city = "Winterthur";
        billingAddress.country = "CH";
        billingAddress.emailAddress = "test@example.com";
        billingAddress.familyName = "Customer";
        billingAddress.givenName = "Good";
        billingAddress.postcode = "8400";
        billingAddress.postalState = "ZH";
        billingAddress.organizationName = "Test GmbH";
        billingAddress.mobilePhoneNumber = "+41791234567";
        billingAddress.salutation = "Ms";

        // Payload
        transactionPayload = new Wallee.model.TransactionCreate();
        transactionPayload.lineItems = [lineItem];
        transactionPayload.autoConfirmationEnabled = true;
        transactionPayload.currency = 'CHF';
        transactionPayload.billingAddress = billingAddress;
        transactionPayload.shippingAddress = billingAddress;
    }

    return transactionPayload;
}

// Complete a transaction online
let transaction: Wallee.model.Transaction;
let transactionCompletion: Wallee.model.TransactionCompletion;
transactionService.create(config.space_id, getTransactionPayload())
.then((response: { response: http.IncomingMessage, body: Wallee.model.Transaction }) => {
    transaction = response.body;
    return transactionService.processWithoutUserInteraction(config.space_id, <number>transaction.id);
})
.delay(7500)
.then((response: { response: http.IncomingMessage, body: Wallee.model.Transaction }) => {
    transaction = response.body;
    return transactionCompletionService.completeOnline(config.space_id, <number>transaction.id);
})
.delay(7500)
.done((response: { response: http.IncomingMessage, body: Wallee.model.TransactionCompletion }) => {
    transactionCompletion = response.body;
    // expect transactionCompletion.state to equal Wallee.model.TransactionCompletionState.SUCCESSFUL
});
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction which should be completed.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.36.4completeOffline

This operation completes the transaction offline. The completion is not forwarded to the processor. This implies the processor does not do anything. This method is only here to fix manually the transaction state.

POST /api/transaction-completion/completeOffline View in Client
Examples
use Wallee\Sdk\ApiClient;
use Wallee\Sdk\Model\AddressCreate;
use Wallee\Sdk\Model\LineItemCreate;
use Wallee\Sdk\Model\LineItemType;
use Wallee\Sdk\Model\TransactionCompletionState;
use Wallee\Sdk\Model\TransactionCreate;
use Wallee\Sdk\Model\TransactionState;
use Wallee\Sdk\Service\TransactionCompletionService;
use Wallee\Sdk\Service\TransactionService;

// credentials
$spaceId = <:YOUR_SPACE_ID>;
$userId = <:YOUR_USER_ID>;
$secret = <:YOUR_USER_SECRET>;

// Services
$apiClient = new ApiClient($userId, $secret);
$transactionCompletionService = new TransactionCompletionService($apiClient);
$transactionService = new TransactionService($apiClient);

// line item
$lineItem = new LineItemCreate();
$lineItem->setName('Red T-Shirt');
$lineItem->setUniqueId('5412');
$lineItem->setSku('red-t-shirt-123');
$lineItem->setQuantity(1);
$lineItem->setAmountIncludingTax(29.95);
$lineItem->setType(LineItemType::PRODUCT);

// Customer Billing Address
$billingAddress = new AddressCreate();
$billingAddress->setCity('Winterthur');
$billingAddress->setCountry('CH');
$billingAddress->setEmailAddress('test@example.com');
$billingAddress->setFamilyName('Customer');
$billingAddress->setGivenName('Good');
$billingAddress->setPostCode('8400');
$billingAddress->setPostalState('ZH');
$billingAddress->setOrganizationName('Test GmbH');
$billingAddress->setPhoneNumber('+41791234567');
$billingAddress->setSalutation('Ms');

// Transaction payload
$transactionPayload = new TransactionCreate();
$transactionPayload->setCurrency('CHF');
$transactionPayload->setLineItems([$lineItem]);
$transactionPayload->setAutoConfirmationEnabled(true);
$transactionPayload->setBillingAddress($billingAddress);
$transactionPayload->setShippingAddress($billingAddress);
$transactionPayload->setFailedUrl('https://YOUR.SITE/transaction?state=fail');
$transactionPayload->setSuccessUrl('https://YOUR.SITE/transaction?state=success');

// Create a transaction
$transaction = $transactionService->create($spaceId, $transactionPayload);
$transaction = $transactionService->processWithoutUserInteraction($spaceId, $transaction->getId());

// Complete a transaction offline
$transactionCompletion = $this->transactionCompletionService->completeOffline($this->spaceId, $transaction->getId());
if(in_array($transactionCompletion->getState(), [TransactionCompletionState::SUCCESSFUL])){
    // completion successful
}
package com.wallee.sdk.test;

import com.wallee.sdk.ApiClient;
import com.wallee.sdk.model.*;
import com.wallee.sdk.service.*;

import java.math.BigDecimal;

/**
 * API tests for TransactionCompletionService
 */
public class TransactionCompletionServiceTest {

    // Credentials
    private Long spaceId = <:YOUR_SPACE_ID>;
    private Long applicationUserId = <:YOUR_USER_ID>;
    private String authenticationKey = <:YOUR_USER_SECRET>;

    // Services
    private ApiClient apiClient;
    private TransactionCompletionService transactionCompletionService;
    private TransactionService transactionService;

    // Models
    private TransactionCreate transactionPayload;

    public TransactionCompletionServiceTest() {
        this.apiClient = new ApiClient(applicationUserId, authenticationKey);
        this.transactionCompletionService = new TransactionCompletionService(this.apiClient);
        this.transactionService = new TransactionService(this.apiClient);
    }

    /**
     * Get transaction payload
     *
     * @return TransactionCreate
     */
    private TransactionCreate getTransactionPayload() {
        if (this.transactionPayload == null) {
            // Line item
            LineItemCreate lineItem = new LineItemCreate();
            lineItem.name("Red T-Shirt")
                .uniqueId("5412")
                .type(LineItemType.PRODUCT)
                .quantity(BigDecimal.valueOf(1))
                .amountIncludingTax(BigDecimal.valueOf(29.95))
                .sku("red-t-shirt-123");

            // Customer Billind Address
            AddressCreate billingAddress = new AddressCreate();
            billingAddress.city("Winterthur")
                .country("CH")
                .emailAddress("test@example.com")
                .familyName("Customer")
                .givenName("Good")
                .postcode("8400")
                .postalState("ZH")
                .organizationName("Test GmbH")
                .mobilePhoneNumber("+41791234567")
                .salutation("Ms");

            this.transactionPayload = new TransactionCreate();
            this.transactionPayload.autoConfirmationEnabled(true).currency("CHF").language("en-US");
            this.transactionPayload.setBillingAddress(billingAddress);
            this.transactionPayload.setShippingAddress(billingAddress);
            this.transactionPayload.addLineItemsItem(lineItem);
        }
        return this.transactionPayload;
    }

    /**
     * completeOffline
     *
     * This operation completes the transaction offline. The completion is not forwarded to the processor. This implies the processor does not do anything. This method is only here to fix manually the transaction state.
     */
    public void completeOffline() {
        try {
            Transaction transaction = this.transactionService.create(this.spaceId, this.getTransactionPayload());
            transaction = this.transactionService.processWithoutUserInteraction(this.spaceId, transaction.getId());
            TransactionCompletion transactionCompletion = this.transactionCompletionService.completeOffline(this.spaceId, transaction.getId());
            TransactionCompletionState[] TransactionCompletionStates = {
                TransactionCompletionState.SUCCESSFUL,
                TransactionCompletionState.PENDING
            };
            // expect transactionCompletion.getState() to be in TransactionCompletionStates
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
using System;
using System.IO;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Linq;
using System.Reflection;
using RestSharp;
using NUnit.Framework;

using Wallee.Model;
using Wallee.Service;
using Wallee.Client;

namespace Wallee.TransactionCompletionServiceExample
{
    /// <summary>
    ///  Class for TransactionCompletionServiceExample
    /// </summary>
    public class TransactionCompletionServiceExample
    {
        private readonly long SpaceId = <:YOUR_SPACE_ID>;
        private readonly string ApplicationUserID = <:YOUR_USER_ID>;
        private readonly string AuthenticationKey = <:YOUR_USER_SECRET>;

        private TransactionCompletionService TransactionCompletionService;
        private TransactionService TransactionService;


        /// <summary>
        /// TransactionCompletionServiceExample
        /// </summary>
        public TransactionCompletionServiceExample()
        {
            Configuration configuration = new Configuration(this.ApplicationUserID, this.AuthenticationKey);
            this.TransactionCompletionService = new TransactionCompletionService(configuration);
            this.TransactionService = new TransactionService(configuration);
        }

        // <summary>
        // Get transaction payload
        // <summary>
        private TransactionCreate GetTransactionPayload()
        {
            // Line item
            LineItemCreate lineItem1 = new LineItemCreate(
                name: "Red T-Shirt",
                uniqueId: "5412",
                type: LineItemType.PRODUCT,
                quantity: 1,
                amountIncludingTax: (decimal)29.95
            )
            {
                Sku = "red-t-shirt-123"
            };

            // Customer Billind Address
            AddressCreate billingAddress = new AddressCreate
            {
                City = "Winterthur",
                Country = "CH",
                EmailAddress = "test@example.com",
                FamilyName = "Customer",
                GivenName = "Good",
                Postcode = "8400",
                PostalState = "ZH",
                OrganizationName = "Test GmbH",
                MobilePhoneNumber = "+41791234567",
                Salutation = "Ms"
            };

            TransactionCreate transactionPayload = new TransactionCreate(new List<LineItemCreate>() { lineItem1 })
            {
                Currency = "CHF",
                AutoConfirmationEnabled = true,
                BillingAddress = billingAddress,
                ShippingAddress = billingAddress,
                Language = "en-US"
            };
            return transactionPayload;
        }

        /// <summary>
        /// CompleteOffline
        /// </summary>
        public void CompleteOffline()
        {
            Transaction transaction = this.TransactionService.Create(this.SpaceId, this.GetTransactionPayload());
            transaction = this.TransactionService.ProcessWithoutUserInteraction(this.SpaceId, transaction.Id);
            TransactionCompletion transactionCompletion = this.TransactionCompletionService.CompleteOffline(this.SpaceId, transaction.Id);
        }

    }
}
'use strict';
import { Wallee } from 'wallee';
import http = require("http");

// config
let config: { space_id: number, user_id: number, api_secret: string } = {
    space_id: <:YOUR_SPACE_ID>,
    user_id: <:YOUR_USER_ID>,
    api_secret: <:YOUR_USER_SECRET>
};

// Services
let transactionCompletionService: Wallee.api.TransactionCompletionService = new Wallee.api.TransactionCompletionService(config);
let transactionService: Wallee.api.TransactionService = new Wallee.api.TransactionService(config);

// Models
let transactionPayload: Wallee.model.TransactionCreate;

/**
 * Get transaction payload
 */
function getTransactionPayload(): Wallee.model.TransactionCreate {
    if (!transactionPayload) {
        // Line item
        let lineItem: Wallee.model.LineItemCreate = new Wallee.model.LineItemCreate();
        lineItem.name = 'Red T-Shirt';
        lineItem.uniqueId = '5412';
        lineItem.type = Wallee.model.LineItemType.PRODUCT;
        lineItem.quantity = 1;
        lineItem.amountIncludingTax = 29.95;
        lineItem.sku = 'red-t-shirt-123';

        // Customer Billing Address
        let billingAddress: Wallee.model.AddressCreate = new Wallee.model.AddressCreate();
        billingAddress.city = "Winterthur";
        billingAddress.country = "CH";
        billingAddress.emailAddress = "test@example.com";
        billingAddress.familyName = "Customer";
        billingAddress.givenName = "Good";
        billingAddress.postcode = "8400";
        billingAddress.postalState = "ZH";
        billingAddress.organizationName = "Test GmbH";
        billingAddress.mobilePhoneNumber = "+41791234567";
        billingAddress.salutation = "Ms";

        // Payload
        transactionPayload = new Wallee.model.TransactionCreate();
        transactionPayload.lineItems = [lineItem];
        transactionPayload.autoConfirmationEnabled = true;
        transactionPayload.currency = 'CHF';
        transactionPayload.billingAddress = billingAddress;
        transactionPayload.shippingAddress = billingAddress;
    }

    return transactionPayload;
}

// Complete a transaction offline
let transaction: Wallee.model.Transaction;
let transactionCompletion: Wallee.model.TransactionCompletion;
transactionService.create(config.space_id, getTransactionPayload())
.then((response: { response: http.IncomingMessage, body: Wallee.model.Transaction }) => {
    transaction = response.body;
    return transactionService.processWithoutUserInteraction(config.space_id, <number>transaction.id);
})
.delay(7500)
.then((response: { response: http.IncomingMessage, body: Wallee.model.Transaction }) => {
    transaction = response.body;
    return transactionCompletionService.completeOffline(config.space_id, <number>transaction.id);
})
.delay(7500)
.done((response: { response: http.IncomingMessage, body: Wallee.model.TransactionCompletion }) => {
    transactionCompletion = response.body;
    // expect transactionCompletion.state to equal Wallee.model.TransactionCompletionState.SUCCESSFUL
});
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction which should be completed.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.36.5Search

Searches for the entities as specified by the given query.

POST /api/transaction-completion/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the transaction completions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.36.6Count

Counts the number of items in the database as restricted by the given filter.

POST /api/transaction-completion/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.36.7completePartiallyOffline

This operation can be used to partially complete the transaction offline. The completion is not forwarded to the processor. This implies the processor does not do anything. This method is only here to fix manually the transaction state.

POST /api/transaction-completion/completePartiallyOffline View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.37Transaction Iframe Service

3.9.37.1Build JavaScript URL

This operation creates the URL which can be used to embed the JavaScript for handling the iFrame checkout flow.

GET /api/transaction-iframe/javascript-url View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    String
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.38Transaction Invoice Comment Service

3.9.38.1Pin

Pins the comment to the top.

GET /api/transaction-invoice-comment/pin View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.38.2Unpin

Unpins the comment from the top.

GET /api/transaction-invoice-comment/unpin View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.38.3Create

Creates the comment with the given properties.

POST /api/transaction-invoice-comment/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.38.4Read

Reads the comment with the given 'id' and returns it.

GET /api/transaction-invoice-comment/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.38.5Find by invoice

Returns all comments of the given transaction invoice.

POST /api/transaction-invoice-comment/all View in Client
Query Parameters
  • spaceId
    *
    Long
  • invoiceId
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.38.6Update

This updates the comment with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the comment.

POST /api/transaction-invoice-comment/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.38.7Delete

Deletes the comment with the given id.

POST /api/transaction-invoice-comment/delete View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.39Transaction Invoice Service

3.9.39.1isReplacementPossible

Returns whether the transaction invoice with the given id can be replaced.

GET /api/transaction-invoice/isReplacementPossible View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The invoice which should be checked if a replacement is possible.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Boolean
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.39.2Search

Searches for the entities as specified by the given query.

POST /api/transaction-invoice/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the transaction invoices which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Transaction Invoice
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.39.3getInvoiceDocumentWithTargetMediaType

Returns the PDF document for the transaction invoice with given id and target media type id.

GET /api/transaction-invoice/getInvoiceDocumentWithTargetMediaType View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction invoice to get the document for.
    Long
  • targetMediaTypeId
    *
    The id of the target media type for which the invoice should be generated for.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.39.4replace

Replaces the transaction invoice with given id with the replacement and returns the new transaction invoice.

POST /api/transaction-invoice/replace View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction invoices which should be replaced.
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.39.5Mark as Paid

Marks the transaction invoice with the given id as paid.

POST /api/transaction-invoice/markAsPaid View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction invoice which should be marked as paid.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.39.6Mark as Derecognized

Marks the transaction invoice with the given id as derecognized.

POST /api/transaction-invoice/markAsDerecognized View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction invoice which should be marked as derecognized.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.39.7getInvoiceDocument

Returns the PDF document for the transaction invoice with given id.

GET /api/transaction-invoice/getInvoiceDocument View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction invoice to get the document for.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.39.8Read

Reads the entity with the given 'id' and returns it.

GET /api/transaction-invoice/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction invoices which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.39.9Count

Counts the number of items in the database as restricted by the given filter.

POST /api/transaction-invoice/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.40Transaction Lightbox Service

3.9.40.1Build JavaScript URL

This operation creates the URL which can be used to embed the JavaScript for handling the Lightbox checkout flow.

GET /api/transaction-lightbox/javascript-url View in Client
Examples
use Wallee\Sdk\ApiClient;
use Wallee\Sdk\Model\AddressCreate;
use Wallee\Sdk\Model\LineItemCreate;
use Wallee\Sdk\Model\LineItemType;
use Wallee\Sdk\Model\TransactionCreate;
use Wallee\Sdk\Service\TransactionLightboxService;
use Wallee\Sdk\Service\TransactionService;

// credentials
$spaceId = <:YOUR_SPACE_ID>;
$userId = <:YOUR_USER_ID>;
$secret = <:YOUR_USER_SECRET>;

// Services
$apiClient = new ApiClient($userId, $secret);
$transactionLightboxService = new TransactionLightboxService($apiClient);
$transactionService = new TransactionService($apiClient);

// line item
$lineItem = new LineItemCreate();
$lineItem->setName('Red T-Shirt');
$lineItem->setUniqueId('5412');
$lineItem->setSku('red-t-shirt-123');
$lineItem->setQuantity(1);
$lineItem->setAmountIncludingTax(29.95);
$lineItem->setType(LineItemType::PRODUCT);

// Customer Billing Address
$billingAddress = new AddressCreate();
$billingAddress->setCity('Winterthur');
$billingAddress->setCountry('CH');
$billingAddress->setEmailAddress('test@example.com');
$billingAddress->setFamilyName('Customer');
$billingAddress->setGivenName('Good');
$billingAddress->setPostCode('8400');
$billingAddress->setPostalState('ZH');
$billingAddress->setOrganizationName('Test GmbH');
$billingAddress->setPhoneNumber('+41791234567');
$billingAddress->setSalutation('Ms');

// Transaction payload
$transactionPayload = new TransactionCreate();
$transactionPayload->setCurrency('CHF');
$transactionPayload->setLineItems([$lineItem]);
$transactionPayload->setAutoConfirmationEnabled(true);
$transactionPayload->setBillingAddress($billingAddress);
$transactionPayload->setShippingAddress($billingAddress);
$transactionPayload->setFailedUrl('https://YOUR.SITE/transaction?state=fail');
$transactionPayload->setSuccessUrl('https://YOUR.SITE/transaction?state=success');

$transaction   = $transactionService->create($spaceId, $transactionPayload);
$javascriptUrl = $transactionLightboxService->javascriptUrl($spaceId, $transaction->getId());
package com.wallee.sdk.test;

import com.wallee.sdk.ApiClient;
import com.wallee.sdk.model.*;
import com.wallee.sdk.service.*;

import java.math.BigDecimal;

/**
 * API tests for TransactionLightboxService
 */
public class TransactionLightboxServiceTest {

    // Credentials
    private Long spaceId = <:YOUR_SPACE_ID>;
    private Long applicationUserId = <:YOUR_USER_ID>;
    private String authenticationKey = <:YOUR_USER_SECRET>;

    // Services
    private ApiClient apiClient;
    private TransactionLightboxService transactionLightboxService;
    private TransactionService transactionService;

    // Models
    private TransactionCreate transactionPayload;

    public TransactionLightboxServiceTest() {
        this.apiClient = new ApiClient(applicationUserId, authenticationKey);
        this.transactionLightboxService = new TransactionLightboxService(this.apiClient);
        this.transactionService = new TransactionService(this.apiClient);
    }

    /**
     * Get transaction payload
     *
     * @return TransactionCreate
     */
    private TransactionCreate getTransactionPayload() {
        if (this.transactionPayload == null) {
            // Line item
            LineItemCreate lineItem = new LineItemCreate();
            lineItem.name("Red T-Shirt")
                .uniqueId("5412")
                .type(LineItemType.PRODUCT)
                .quantity(BigDecimal.valueOf(1))
                .amountIncludingTax(BigDecimal.valueOf(29.95))
                .sku("red-t-shirt-123");

            // Customer Billind Address
            AddressCreate billingAddress = new AddressCreate();
            billingAddress.city("Winterthur")
                .country("CH")
                .emailAddress("test@example.com")
                .familyName("Customer")
                .givenName("Good")
                .postcode("8400")
                .postalState("ZH")
                .organizationName("Test GmbH")
                .mobilePhoneNumber("+41791234567")
                .salutation("Ms");

            this.transactionPayload = new TransactionCreate();
            this.transactionPayload.autoConfirmationEnabled(true).currency("CHF").language("en-US");
            this.transactionPayload.setBillingAddress(billingAddress);
            this.transactionPayload.setShippingAddress(billingAddress);
            this.transactionPayload.addLineItemsItem(lineItem);
        }
        return this.transactionPayload;
    }

    /**
     * Build JavaScript URL
     *
     * This operation creates the URL which can be used to embed the JavaScript for handling the Lightbox checkout flow.
     */
    public void javascriptUrl() {
        try {
            Transaction transaction = this.transactionService.create(this.spaceId, this.getTransactionPayload());
            String javascriptUrl = this.transactionLightboxService.javascriptUrl(spaceId, transaction.getId());
            // expect javascriptUrl to be a URL beginning with https://
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

}
using System;
using System.IO;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Linq;
using System.Reflection;
using RestSharp;
using NUnit.Framework;

using Wallee.Model;
using Wallee.Service;
using Wallee.Client;

namespace Wallee.TransactionLightboxServiceExample
{
    /// <summary>
    ///  Class for TransactionLightboxServiceExample
    /// </summary>
    public class TransactionLightboxServiceExample
    {
        private readonly long SpaceId = <:YOUR_SPACE_ID>;
        private readonly string ApplicationUserID = <:YOUR_USER_ID>;
        private readonly string AuthenticationKey = <:YOUR_USER_SECRET>;

        private Configuration Configuration;
        private TransactionLightboxService TransactionLightboxService;
        private TransactionCreate TransactionPayload;
        private TransactionService TransactionService;

        /// <summary>
        /// Class for TransactionLightboxServiceExample
        /// </summary>
        public TransactionLightboxServiceExample()
        {
            this.Configuration = new Configuration(this.ApplicationUserID, this.AuthenticationKey);
            this.TransactionLightboxService = new TransactionLightboxService(this.Configuration);
            this.TransactionService = new TransactionService(this.Configuration);
        }

        // <summary>
        // Get transaction payload
        // <summary>
        private TransactionCreate GetTransactionPayload()
        {
            if (this.TransactionPayload == null)
            {
                // Line item
                LineItemCreate lineItem1 = new LineItemCreate(
                    name: "Red T-Shirt",
                    uniqueId: "5412",
                    type: LineItemType.PRODUCT,
                    quantity: 1,
                    amountIncludingTax: (decimal)29.95
                )
                {
                    Sku = "red-t-shirt-123"
                };

                // Customer Billind Address
                AddressCreate billingAddress = new AddressCreate
                {
                    City = "Winterthur",
                    Country = "CH",
                    EmailAddress = "test@example.com",
                    FamilyName = "Customer",
                    GivenName = "Good",
                    Postcode = "8400",
                    PostalState = "ZH",
                    OrganizationName = "Test GmbH",
                    MobilePhoneNumber = "+41791234567",
                    Salutation = "Ms"
                };

                this.TransactionPayload = new TransactionCreate(new List<LineItemCreate>() { lineItem1 })
                {
                    Currency = "CHF",
                    AutoConfirmationEnabled = true,
                    BillingAddress = billingAddress,
                    ShippingAddress = billingAddress,
                    Language = "en-US"
                };
            }
            return this.TransactionPayload;
        }

        /// <summary>
        /// JavascriptUrl
        /// </summary>
        public void JavascriptUrl()
        {
            Transaction transaction = this.TransactionService.Create(this.SpaceId, this.GetTransactionPayload());
            var response = TransactionLightboxService.JavascriptUrl(this.SpaceId, transaction.Id);
        }

    }

}
'use strict';
import { Wallee } from 'wallee';
import http = require("http");

// config
let config: { space_id: number, user_id: number, api_secret: string } = {
    space_id: <:YOUR_SPACE_ID>,
    user_id: <:YOUR_USER_ID>,
    api_secret: <:YOUR_USER_SECRET>
};

// Services
let transactionLightboxService: Wallee.api.TransactionLightboxService = new Wallee.api.TransactionLightboxService(config);
let transactionService: Wallee.api.TransactionService = new Wallee.api.TransactionService(config);

// Models
let transactionPayload: Wallee.model.TransactionCreate;

/**
 * Get transaction payload
 */
function getTransactionPayload(): Wallee.model.TransactionCreate {
    if (!transactionPayload) {
        // Line item
        let lineItem: Wallee.model.LineItemCreate = new Wallee.model.LineItemCreate();
        lineItem.name = 'Red T-Shirt';
        lineItem.uniqueId = '5412';
        lineItem.type = Wallee.model.LineItemType.PRODUCT;
        lineItem.quantity = 1;
        lineItem.amountIncludingTax = 29.95;
        lineItem.sku = 'red-t-shirt-123';

        // Customer Billing Address
        let billingAddress: Wallee.model.AddressCreate = new Wallee.model.AddressCreate();
        billingAddress.city = "Winterthur";
        billingAddress.country = "CH";
        billingAddress.emailAddress = "test@example.com";
        billingAddress.familyName = "Customer";
        billingAddress.givenName = "Good";
        billingAddress.postcode = "8400";
        billingAddress.postalState = "ZH";
        billingAddress.organizationName = "Test GmbH";
        billingAddress.mobilePhoneNumber = "+41791234567";
        billingAddress.salutation = "Ms";

        // Payload
        transactionPayload = new Wallee.model.TransactionCreate();
        transactionPayload.lineItems = [lineItem];
        transactionPayload.autoConfirmationEnabled = true;
        transactionPayload.currency = 'CHF';
        transactionPayload.billingAddress = billingAddress;
        transactionPayload.shippingAddress = billingAddress;
    }

    return transactionPayload;
}

// Fetch lightbox javascript url
transactionService.create(config.space_id, getTransactionPayload())
    .then((response: { response: http.IncomingMessage, body: Wallee.model.Transaction }) => {
        let transaction: Wallee.model.Transaction = response.body;
        return transactionLightboxService.javascriptUrl(config.space_id, <number>transaction.id);
    })
    .done((response: { response: http.IncomingMessage, body: string }) => {
        let javascriptUrl: string = response.body;
        // expect javascriptUrl to be a string
        // expect javascriptUrl to include https://
    });
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    String
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.41Transaction Line Item Version Service

3.9.41.1Count

Counts the number of items in the database as restricted by the given filter.

POST /api/transaction-line-item-version/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.41.2Search

Searches for the entities as specified by the given query.

POST /api/transaction-line-item-version/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts line item versions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.41.3Read

Reads the entity with the given 'id' and returns it.

GET /api/transaction-line-item-version/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The ID of the line item version which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.41.4create

This operation applies a line item version on a particular transaction.

POST /api/transaction-line-item-version/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The line item version object which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.42Transaction Mobile SDK Service

3.9.42.1Build Mobile SDK URL

This operation builds the URL which is used to load the payment form within a WebView on a mobile device. This operation is typically called through the mobile SDK.

GET /api/transaction-mobile-sdk/payment-form-url View in Client
Query Parameters
  • credentials
    *
    The credentials identifies the transaction and contains the security details which grants the access this operation.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    String
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.43Transaction Payment Page Service

3.9.43.1Build Payment Page URL

This operation creates the URL to which the user should be redirected to when the payment page should be used.

GET /api/transaction-payment-page/payment-page-url View in Client
Examples
use Wallee\Sdk\ApiClient;
use Wallee\Sdk\Model\AddressCreate;
use Wallee\Sdk\Model\LineItemCreate;
use Wallee\Sdk\Model\LineItemType;
use Wallee\Sdk\Model\TransactionCreate;
use Wallee\Sdk\Service\TransactionPaymentPageService;
use Wallee\Sdk\Service\TransactionService;

// credentials
$spaceId = <:YOUR_SPACE_ID>;
$userId = <:YOUR_USER_ID>;
$secret = <:YOUR_USER_SECRET>;

// Services
$apiClient = new ApiClient($userId, $secret);
$transactionPaymentPageService = new TransactionPaymentPageService($apiClient);
$transactionService = new TransactionService($apiClient);

// line item
$lineItem = new LineItemCreate();
$lineItem->setName('Red T-Shirt');
$lineItem->setUniqueId('5412');
$lineItem->setSku('red-t-shirt-123');
$lineItem->setQuantity(1);
$lineItem->setAmountIncludingTax(29.95);
$lineItem->setType(LineItemType::PRODUCT);

// Customer Billing Address
$billingAddress = new AddressCreate();
$billingAddress->setCity('Winterthur');
$billingAddress->setCountry('CH');
$billingAddress->setEmailAddress('test@example.com');
$billingAddress->setFamilyName('Customer');
$billingAddress->setGivenName('Good');
$billingAddress->setPostCode('8400');
$billingAddress->setPostalState('ZH');
$billingAddress->setOrganizationName('Test GmbH');
$billingAddress->setPhoneNumber('+41791234567');
$billingAddress->setSalutation('Ms');

// Transaction payload
$transactionPayload = new TransactionCreate();
$transactionPayload->setCurrency('CHF');
$transactionPayload->setLineItems([$lineItem]);
$transactionPayload->setAutoConfirmationEnabled(true);
$transactionPayload->setBillingAddress($billingAddress);
$transactionPayload->setShippingAddress($billingAddress);
$transactionPayload->setFailedUrl('https://YOUR.SITE/transaction?state=fail');
$transactionPayload->setSuccessUrl('https://YOUR.SITE/transaction?state=success');

$transaction    = $transactionService->create($spaceId, $transactionPayload);
$paymentPageUrl = $transactionPaymentPageService->paymentPageUrl($spaceId, $transaction->getId());

header('Location: '. $paymentPageUrl);
package com.wallee.sdk.test;

import com.wallee.sdk.ApiClient;
import com.wallee.sdk.model.*;
import com.wallee.sdk.service.*;

import java.math.BigDecimal;

/**
 * API tests for TransactionPaymentPageService
 */
public class TransactionPaymentPageServiceTest {

    // Credentials
    private Long spaceId = <:YOUR_SPACE_ID>;
    private Long applicationUserId = <:YOUR_USER_ID>;
    private String authenticationKey = <:YOUR_USER_SECRET>;

    // Services
    private ApiClient apiClient;
    private TransactionPaymentPageService transactionPaymentPageService;
    private TransactionService transactionService;

    // Models
    private TransactionCreate transactionPayload;

    public TransactionPaymentPageServiceTest() {
        this.apiClient = new ApiClient(applicationUserId, authenticationKey);
        this.transactionPaymentPageService = new TransactionPaymentPageService(this.apiClient);
        this.transactionService = new TransactionService(this.apiClient);
    }

    /**
     * Get transaction payload
     *
     * @return TransactionCreate
     */
    private TransactionCreate getTransactionPayload() {
        if (this.transactionPayload == null) {
            // Line item
            LineItemCreate lineItem = new LineItemCreate();
            lineItem.name("Red T-Shirt")
                .uniqueId("5412")
                .type(LineItemType.PRODUCT)
                .quantity(BigDecimal.valueOf(1))
                .amountIncludingTax(BigDecimal.valueOf(29.95))
                .sku("red-t-shirt-123");

            // Customer Billind Address
            AddressCreate billingAddress = new AddressCreate();
            billingAddress.city("Winterthur")
                .country("CH")
                .emailAddress("test@example.com")
                .familyName("Customer")
                .givenName("Good")
                .postcode("8400")
                .postalState("ZH")
                .organizationName("Test GmbH")
                .mobilePhoneNumber("+41791234567")
                .salutation("Ms");

            this.transactionPayload = new TransactionCreate();
            this.transactionPayload.autoConfirmationEnabled(true).currency("CHF").language("en-US");
            this.transactionPayload.setBillingAddress(billingAddress);
            this.transactionPayload.setShippingAddress(billingAddress);
            this.transactionPayload.addLineItemsItem(lineItem);
        }
        return this.transactionPayload;
    }

    /**
     * Build Payment Page URL
     *
     * This operation creates the URL to which the user should be redirected to when the payment page should be used.
     *
     */
    public void paymentPageUrl() {
        try {
            Transaction transaction = this.transactionService.create(this.spaceId, this.getTransactionPayload());
            String paymentPageUrl = this.transactionPaymentPageService.paymentPageUrl(spaceId, transaction.getId());
            // expect paymentPageUrl to be a URL beginning with https://
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

}
using System;
using System.IO;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Linq;
using System.Reflection;
using RestSharp;
using NUnit.Framework;

using Wallee.Model;
using Wallee.Service;
using Wallee.Client;

namespace Wallee.TransactionPaymentPageServiceExample
{
    /// <summary>
    ///  TransactionPaymentPageServiceExample
    /// </summary>
    public class TransactionPaymentPageServiceExample
    {
        private readonly long SpaceId = <:YOUR_SPACE_ID>;
        private readonly string ApplicationUserID = <:YOUR_USER_ID>;
        private readonly string AuthenticationKey = <:YOUR_USER_SECRET>;

        private Configuration Configuration;
        private TransactionPaymentPageService TransactionPaymentPageService;
        private TransactionCreate TransactionPayload;
        private TransactionService TransactionService;

        /// <summary>
        /// TransactionPaymentPageServiceExample
        /// </summary>
        public TransactionPaymentPageServiceExample()
        {
            this.Configuration = new Configuration(this.ApplicationUserID, this.AuthenticationKey);
            this.TransactionPaymentPageService = new TransactionPaymentPageService(this.Configuration);
            this.TransactionService = new TransactionService(this.Configuration);
        }

        // <summary>
        // Get transaction payload
        // <summary>
        private TransactionCreate GetTransactionPayload()
        {
            if (this.TransactionPayload == null)
            {
                // Line item
                LineItemCreate lineItem1 = new LineItemCreate(
                    name: "Red T-Shirt",
                    uniqueId: "5412",
                    type: LineItemType.PRODUCT,
                    quantity: 1,
                    amountIncludingTax: (decimal)29.95
                )
                {
                    Sku = "red-t-shirt-123"
                };

                // Customer Billind Address
                AddressCreate billingAddress = new AddressCreate
                {
                    City = "Winterthur",
                    Country = "CH",
                    EmailAddress = "test@example.com",
                    FamilyName = "Customer",
                    GivenName = "Good",
                    Postcode = "8400",
                    PostalState = "ZH",
                    OrganizationName = "Test GmbH",
                    MobilePhoneNumber = "+41791234567",
                    Salutation = "Ms"
                };

                this.TransactionPayload = new TransactionCreate(new List<LineItemCreate>() { lineItem1 })
                {
                    Currency = "CHF",
                    AutoConfirmationEnabled = true,
                    BillingAddress = billingAddress,
                    ShippingAddress = billingAddress,
                    Language = "en-US"
                };
            }
            return this.TransactionPayload;
        }

        /// <summary>
        /// PaymentPageUrl
        /// </summary>
        public void PaymentPageUrl()
        {
            Transaction transaction = this.TransactionService.Create(this.SpaceId, this.GetTransactionPayload());
            var response = TransactionPaymentPageService.PaymentPageUrl(this.SpaceId, transaction.Id);
        }
    }
}
'use strict';
import { Wallee } from 'wallee';
import http = require("http");

// config
let config: { space_id: number, user_id: number, api_secret: string } = {
    space_id: <:YOUR_SPACE_ID>,
    user_id: <:YOUR_USER_ID>,
    api_secret: <:YOUR_USER_SECRET>
};

// Services
let transactionPaymentPageService: Wallee.api.TransactionPaymentPageService = new Wallee.api.TransactionPaymentPageService(config);
let transactionService: Wallee.api.TransactionService = new Wallee.api.TransactionService(config);

// Models
let transactionPayload: Wallee.model.TransactionCreate;

/**
 * Get transaction payload
 */
function getTransactionPayload(): Wallee.model.TransactionCreate {
    if (!transactionPayload) {
        // Line item
        let lineItem: Wallee.model.LineItemCreate = new Wallee.model.LineItemCreate();
        lineItem.name = 'Red T-Shirt';
        lineItem.uniqueId = '5412';
        lineItem.type = Wallee.model.LineItemType.PRODUCT;
        lineItem.quantity = 1;
        lineItem.amountIncludingTax = 29.95;
        lineItem.sku = 'red-t-shirt-123';

        // Customer Billing Address
        let billingAddress: Wallee.model.AddressCreate = new Wallee.model.AddressCreate();
        billingAddress.city = "Winterthur";
        billingAddress.country = "CH";
        billingAddress.emailAddress = "test@example.com";
        billingAddress.familyName = "Customer";
        billingAddress.givenName = "Good";
        billingAddress.postcode = "8400";
        billingAddress.postalState = "ZH";
        billingAddress.organizationName = "Test GmbH";
        billingAddress.mobilePhoneNumber = "+41791234567";
        billingAddress.salutation = "Ms";

        // Payload
        transactionPayload = new Wallee.model.TransactionCreate();
        transactionPayload.lineItems = [lineItem];
        transactionPayload.autoConfirmationEnabled = true;
        transactionPayload.currency = 'CHF';
        transactionPayload.billingAddress = billingAddress;
        transactionPayload.shippingAddress = billingAddress;
    }

    return transactionPayload;
}

// Fetch Payment Page Url
transactionService.create(config.space_id, getTransactionPayload())
    .then((response: { response: http.IncomingMessage, body: Wallee.model.Transaction }) => {
        let transaction: Wallee.model.Transaction = response.body;
        return transactionPaymentPageService.paymentPageUrl(config.space_id, <number>transaction.id);
    })
    .done((response: { response: http.IncomingMessage, body: string }) => {
        let paymentPageUrl: string = response.body;
        // expect paymentPageUrl to be a string
        // expect paymentPageUrl to include https://
    });
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    String
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44Transaction Service

3.9.44.1Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/transaction/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The transaction object with the properties which should be updated.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.2Confirm

The confirm operation marks the transaction as confirmed. Once the transaction is confirmed no more changes can be applied.

POST /api/transaction/confirm View in Client
Examples
POST /api/transaction/confirm?spaceId={YOUR_SPACE_ID} HTTP/1.1
Host: app-wallee.com 
Content-Type: application/json;charset=utf-8
X-Mac-Version: 1
X-Mac-Userid: {YOUR_USER_ID}
X-Mac-Timestamp: {UNIX_TIMESTAMP}
X-Mac-Value: {CALCULATED_MAC_VALUE}

{
	"id": 109891
}
Query Parameters
  • spaceId
    *
    Long
Message Body *
The transaction JSON object to update and confirm.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.3getLatestSuccessfulTransactionLineItemVersion

GET /api/transaction/getLatestTransactionLineItemVersion View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction to get the latest line item version for.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.4Count

Counts the number of items in the database as restricted by the given filter.

POST /api/transaction/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.5Process Without User Interaction

This operation processes the transaction without requiring that the customer is present. Means this operation applies strategies to process the transaction without a direct interaction with the buyer. This operation is suitable for recurring transactions.

POST /api/transaction/processWithoutUserInteraction View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction which should be processed.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.6Read

Reads the entity with the given 'id' and returns it.

GET /api/transaction/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.7Export

Exports the transactions into a CSV file. The file will contain the properties defined in the request.

POST /api/transaction/export View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The request controls the entries which are exported.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    binary:
    text/csv
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.8Fetch One Click Tokens with Credentials

This operation returns the token version objects which references the tokens usable as one-click payment tokens for the provided transaction.

GET /api/transaction/fetchOneClickTokensWithCredentials View in Client
Query Parameters
  • credentials
    *
    The credentials identifies the transaction and contains the security details which grants the access this operation.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Token Version
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.9Fetch Possible Payment Methods with Credentials

This operation allows to get the payment method configurations which can be used with the provided transaction.

GET /api/transaction/fetch-payment-methods-with-credentials View in Client
Query Parameters
  • credentials
    *
    The credentials identifies the transaction and contains the security details which grants the access this operation.
    String
  • integrationMode
    *
    The integration mode defines the type of integration that is applied on the transaction.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.10Search

Searches for the entities as specified by the given query.

POST /api/transaction/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the transactions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Transaction
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.11Create

Creates the entity with the given properties.

POST /api/transaction/create View in Client
Examples
POST /api/transaction/create?spaceId={YOUR_SPACE_ID} HTTP/1.1
Host: app-wallee.com 
Content-Type: application/json;charset=utf-8
X-Mac-Version: 1
X-Mac-Userid: {YOUR_USER_ID}
X-Mac-Timestamp: {UNIX_TIMESTAMP}
X-Mac-Value: {CALCULATED_MAC_VALUE}

{
	"billingAddress": {
		"city": "Winterthur",
		"commercialRegisterNumber": "",
		"country": "CH",
		"dateOfBirth": "",
		"emailAddress": "some-buyer@test.com",
		"familyName": "Test",
		"gender": "",
		"givenName": "Sam",
		"mobilePhoneNumber": "",
		"organisationName": "Test Company Ltd",
		"phoneNumber": "",
		"postcode": "8400",
		"salesTaxNumber": "",
		"salutation": "",
		"socialSecurityNumber": "",
		"state": "",
		"street": "Sample Street 47"
	},
	"currency": "EUR",
	"language": "en-US",
	"lineItems": [{
		"amountIncludingTax": "11.87",
		"name": "Sample Product",
		"quantity": "1",
		"shippingRequired": "true",
		"sku": "sample-123",
		"type": "PRODUCT",
		"uniqueId": "sample-123",
		"attributes": {
			"test1": {
				"label": "My Test Label",
				"value": "Test Attribute Value"
			},
			"c2": {
				"label": "My Test Label 2",
				"value": "Test Attribute Value"
			}
		}
	}],
	"metaData": {
		"sampleKey": "Some value",
		"additionalDataItem": "Other value"
	},
	"merchantReference": "DEV-2630",
	"shippingAddress": {
		"city": "Winterthur",
		"commercialRegisterNumber": "",
		"country": "CH",
		"dateOfBirth": "",
		"emailAddress": "some-buyer@test.com",
		"familyName": "Test",
		"gender": "",
		"givenName": "Sam",
		"mobilePhoneNumber": "",
		"organisationName": "Test Company Ltd",
		"phoneNumber": "",
		"postcode": "8400",
		"salesTaxNumber": "",
		"salutation": "",
		"socialSecurityNumber": "",
		"state": "",
		"street": "Sample Street 47"
	}
}
Query Parameters
  • spaceId
    *
    Long
Message Body *
The transaction object which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.12Create Transaction Credentials

This operation allows to create transaction credentials to delegate temporarily the access to the web service API for this particular transaction.

POST /api/transaction/createTransactionCredentials View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    String
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.13getInvoiceDocument

Returns the PDF document for the transaction invoice with given id.

GET /api/transaction/getInvoiceDocument View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction to get the invoice document for.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.14getPackingSlip

Returns the packing slip for the transaction with given id.

GET /api/transaction/getPackingSlip View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction to get the packing slip for.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.15Fetch Possible Payment Methods

This operation allows to get the payment method configurations which can be used with the provided transaction.

GET /api/transaction/fetch-payment-methods View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction which should be returned.
    Long
  • integrationMode
    *
    The integration mode defines the type of integration that is applied on the transaction.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.16Delete One-Click Token with Credentials

This operation removes the given token.

POST /api/transaction/deleteOneClickTokenWithCredentials View in Client
Query Parameters
  • credentials
    *
    The credentials identifies the transaction and contains the security details which grants the access this operation.
    String
  • tokenId
    *
    The token ID will be used to find the token which should be removed.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.17Read With Credentials

Reads the transaction with the given 'id' and returns it. This method uses the credentials to authenticate and identify the transaction.

GET /api/transaction/readWithCredentials View in Client
Query Parameters
  • credentials
    *
    The credentials identifies the transaction and contains the security details which grants the access this operation.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.44.18Process One-Click Token with Credentials

This operation assigns the given token to the transaction and process it. This method will return an URL where the customer has to be redirect to complete the transaction.

POST /api/transaction/processOneClickTokenAndRedirectWithCredentials View in Client
Query Parameters
  • credentials
    *
    The credentials identifies the transaction and contains the security details which grants the access this operation.
    String
  • tokenId
    *
    The token ID is used to load the corresponding token and to process the transaction with it.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    String
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.45Transaction Terminal Service

3.9.45.1Create Till Connection Credentials

This operation creates a set of credentials to use within the WebSocket.

POST /api/transaction-terminal/till-connection-credentials View in Client
Query Parameters
  • spaceId
    *
    Long
  • transactionId
    *
    The ID of the transaction which is used to process with the terminal.
    Long
  • terminalId
    *
    The ID of the terminal which should be used to process the transaction.
    Long
  • language
    The language in which the messages should be rendered in.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    String
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.45.2Fetch Receipts

Returns all receipts for the requested terminal transaction.

POST /api/transaction-terminal/fetch-receipts View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.46Transaction Void Service

3.9.46.1voidOffline

This operation voids the transaction offline. The void is not forwarded to the processor. This implies the processor does not do anything. This method is only here to fix manually the transaction state.

POST /api/transaction-void/voidOffline View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction which should be voided.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.46.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/transaction-void/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.46.3Search

Searches for the entities as specified by the given query.

POST /api/transaction-void/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the transaction voids which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Transaction Void
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.46.4Read

Reads the entity with the given 'id' and returns it.

GET /api/transaction-void/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction voids which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.9.46.5voidOnline

This operation voids the transaction online. The void is forwarded to the processor. This implies that the processor may take some actions based on the void.

POST /api/transaction-void/voidOnline View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the transaction which should be voided.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10Shopify

3.10.1Shopify Recurring Order Service

3.10.1.1Count

Counts the number of items in the database as restricted by the given filter.

POST /api/shopify-recurring-order/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.1.2Read

Reads the entity with the given 'id' and returns it.

GET /api/shopify-recurring-order/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the Shopify recurring order which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.1.3Update

This operation allows to update a Shopify recurring order.

POST /api/shopify-recurring-order/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.1.4Search

Searches for the entities as specified by the given query.

POST /api/shopify-recurring-order/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the Shopify recurring orders which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.2Shopify Subscriber Service

3.10.2.1Read

Reads the entity with the given 'id' and returns it.

GET /api/shopify-subscriber/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the Shopify subscriber which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.2.2Search

Searches for the entities as specified by the given query.

POST /api/shopify-subscriber/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the Shopify subscribers which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Shopify Subscriber
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.2.3Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/shopify-subscriber/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The Shopify subscriber object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.2.4Count

Counts the number of items in the database as restricted by the given filter.

POST /api/shopify-subscriber/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.3Shopify Subscription Product Service

3.10.3.1Read

Reads the entity with the given 'id' and returns it.

GET /api/shopify-subscription-product/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the Shopify subscription product which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.3.2Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/shopify-subscription-product/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The Shopify subscription product object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.3.3Search

Searches for the entities as specified by the given query.

POST /api/shopify-subscription-product/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the Shopify subscription products which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.3.4Count

Counts the number of items in the database as restricted by the given filter.

POST /api/shopify-subscription-product/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.3.5Create

Creates the entity with the given properties.

POST /api/shopify-subscription-product/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The Shopify subscription product object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.4Shopify Subscription Service

3.10.4.1Create

This operation allows to create a Shopify subscription.

POST /api/shopify-subscription/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.4.2Read

Reads the entity with the given 'id' and returns it.

GET /api/shopify-subscription/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the Shopify subscription which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.4.3Update

This operation allows to update a Shopify subscription.

POST /api/shopify-subscription/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.4.4Terminate

This operation allows to terminate a Shopify subscription.

POST /api/shopify-subscription/terminate View in Client
Query Parameters
  • spaceId
    *
    Long
  • subscriptionId
    *
    The ID identifies the Shopify subscription which should be terminated.
    Long
  • respectTerminationPeriod
    *
    The respect termination period controls whether the termination period configured on the product version should be respected or if the operation should take effect immediately.
    Boolean
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.4.5Count

Counts the number of items in the database as restricted by the given filter.

POST /api/shopify-subscription/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.4.6Search

Searches for the entities as specified by the given query.

POST /api/shopify-subscription/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the Shopify subscriptions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.4.7Update Addresses

This operation allows to update a Shopify subscription addresses.

POST /api/shopify-subscription/update-addresses View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.5Shopify Subscription Suspension Service

3.10.5.1Suspend

This operation allows to suspend a Shopify subscription.

POST /api/shopify-subscription-suspension/suspend View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.5.2Search

Searches for the entities as specified by the given query.

POST /api/shopify-subscription-suspension/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the Shopify subscription suspensions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.5.3Read

Reads the entity with the given 'id' and returns it.

GET /api/shopify-subscription-suspension/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the Shopify subscription suspension which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.5.4Count

Counts the number of items in the database as restricted by the given filter.

POST /api/shopify-subscription-suspension/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.5.5Reactivate

This operation allows to reactivate a suspended Shopify subscription.

POST /api/shopify-subscription-suspension/reactivate View in Client
Query Parameters
  • spaceId
    *
    Long
  • subscriptionId
    *
    The ID identifies the suspended Shopify subscription which should be reactivated.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.6Shopify Subscription Version Service

3.10.6.1Count

Counts the number of items in the database as restricted by the given filter.

POST /api/shopify-subscription-version/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.6.2Search

Searches for the entities as specified by the given query.

POST /api/shopify-subscription-version/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the Shopify subscription versions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.6.3Read

Reads the entity with the given 'id' and returns it.

GET /api/shopify-subscription-version/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the Shopify subscription version which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.7Shopify Transaction Service

3.10.7.1Read

Reads the entity with the given 'id' and returns it.

GET /api/shopify-transaction/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the Shopify transaction which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.7.2Search

Searches for the entities as specified by the given query.

POST /api/shopify-transaction/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the Shopify transactions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Shopify Transaction
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.10.7.3Count

Counts the number of items in the database as restricted by the given filter.

POST /api/shopify-transaction/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11Subscription

3.11.1Subscriber Service

3.11.1.1Delete

Deletes the entity with the given id.

POST /api/subscriber/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.1.2Search

Searches for the entities as specified by the given query.

POST /api/subscriber/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the customer which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Subscriber
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.1.3Create

Creates the entity with the given properties.

POST /api/subscriber/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The customer object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.1.4Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscriber/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.1.5Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/subscriber/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The customer with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.1.6Read

Reads the entity with the given 'id' and returns it.

GET /api/subscriber/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the customer which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.2Subscription Affiliate Service

3.11.2.1Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/subscription-affiliate/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.2.2Create

Creates the entity with the given properties.

POST /api/subscription-affiliate/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The subscription affiliate object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.2.3Search

Searches for the entities as specified by the given query.

POST /api/subscription-affiliate/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the affiliates which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.2.4Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-affiliate/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.2.5Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-affiliate/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the subscription affiliate case which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.2.6Delete

Deletes the entity with the given id.

POST /api/subscription-affiliate/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.3Subscription Charge Service

3.11.3.1Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-charge/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the subscription charge which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.3.2discard

This operation allows to discard a scheduled charge.

POST /api/subscription-charge/discard View in Client
Query Parameters
  • spaceId
    *
    Long
  • chargeId
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.3.3Search

Searches for the entities as specified by the given query.

POST /api/subscription-charge/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the subscription charges which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Subscription Charge
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.3.4Create

The create operation creates a new subscription charge.

POST /api/subscription-charge/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.3.5Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-charge/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.4Subscription Metric Service

3.11.4.1Delete

Deletes the entity with the given id.

POST /api/subscription-metric/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The id of the metric which should be deleted.
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.4.2Create

Creates the entity with the given properties.

POST /api/subscription-metric/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The metric object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.4.3Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-metric/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the metric which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.4.4Search

Searches for the entities as specified by the given query.

POST /api/subscription-metric/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the metric which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Metric
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.4.5Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-metric/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.4.6Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/subscription-metric/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The products metric with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.5Subscription Metric Usage Report Service

3.11.5.1Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-metric-usage/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the usage report which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.5.2Create

This operation creates a new metric usage report.

POST /api/subscription-metric-usage/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The usage report which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.5.3Search

Searches for the entities as specified by the given query.

POST /api/subscription-metric-usage/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the usage reports which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Metric Usage Report
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.5.4Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-metric-usage/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.6Subscription Period Bill Service

3.11.6.1Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-period-bill/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the subscription period bill which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.6.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-period-bill/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.6.3Search

Searches for the entities as specified by the given query.

POST /api/subscription-period-bill/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the subscription period bills which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.7Subscription Product Component Group Service

3.11.7.1Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-product-component-group/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the product component group which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.7.2Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/subscription-product-component-group/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The product component group object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.7.3Delete

Deletes the entity with the given id.

POST /api/subscription-product-component-group/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.7.4Search

Searches for the entities as specified by the given query.

POST /api/subscription-product-component-group/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the product component groups which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.7.5Create

Creates the entity with the given properties.

POST /api/subscription-product-component-group/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The product component group object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.7.6Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-product-component-group/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.8Subscription Product Component Service

3.11.8.1Delete

Deletes the entity with the given id.

POST /api/subscription-product-component/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.8.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-product-component/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.8.3Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-product-component/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the product component which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.8.4Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/subscription-product-component/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The product component object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.8.5Create

Creates the entity with the given properties.

POST /api/subscription-product-component/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The product component object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.8.6Search

Searches for the entities as specified by the given query.

POST /api/subscription-product-component/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the product component which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Product Component
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.9Subscription Product Metered Fee Service

3.11.9.1Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/subscription-product-metered-fee/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The metered fee object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.9.2Create

Creates the entity with the given properties.

POST /api/subscription-product-metered-fee/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The metered fee object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.9.3Search

Searches for the entities as specified by the given query.

POST /api/subscription-product-metered-fee/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the metered fees which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Product Metered Fee
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.9.4Delete

Deletes the entity with the given id.

POST /api/subscription-product-metered-fee/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.9.5Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-product-metered-fee/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the metered fee which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.9.6Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-product-metered-fee/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.10Subscription Product Metered Tier Fee Service

3.11.10.1Search

Searches for the entities as specified by the given query.

POST /api/subscription-product-fee-tier/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the metered fee tiers which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.10.2Create

Creates the entity with the given properties.

POST /api/subscription-product-fee-tier/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The metered fee tier object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.10.3Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-product-fee-tier/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the metered fee tier which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.10.4Delete

Deletes the entity with the given id.

POST /api/subscription-product-fee-tier/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.10.5Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/subscription-product-fee-tier/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The metered fee tier object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.10.6Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-product-fee-tier/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.11Subscription Product Period Fee Service

3.11.11.1Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-product-period-fee/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the period fee which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.11.2Delete

Deletes the entity with the given id.

POST /api/subscription-product-period-fee/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.11.3Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/subscription-product-period-fee/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The period fee object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.11.4Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-product-period-fee/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.11.5Create

Creates the entity with the given properties.

POST /api/subscription-product-period-fee/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The period fee object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.11.6Search

Searches for the entities as specified by the given query.

POST /api/subscription-product-period-fee/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the period fees which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Product Period Fee
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.12Subscription Product Retirement Service

3.11.12.1Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-product-retirement/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the retirement which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.12.2Search

Searches for the entities as specified by the given query.

POST /api/subscription-product-retirement/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the product retirements which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Product Retirement
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.12.3Create

The create operation creates a new product retirement.

POST /api/subscription-product-retirement/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.12.4Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-product-retirement/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.13Subscription Product Service

3.11.13.1Search

Searches for the entities as specified by the given query.

POST /api/subscription-product/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the products which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Product
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.13.2Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/subscription-product/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The products object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.13.3Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-product/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.13.4Create

Creates the entity with the given properties.

POST /api/subscription-product/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The product object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.13.5Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-product/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the product which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.14Subscription Product Setup Fee Service

3.11.14.1Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-product-setup-fee/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.14.2Create

Creates the entity with the given properties.

POST /api/subscription-product-setup-fee/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The setup fee object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.14.3Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-product-setup-fee/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the setup fee which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.14.4Search

Searches for the entities as specified by the given query.

POST /api/subscription-product-setup-fee/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the setup fees which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Product Setup Fee
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.14.5Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/subscription-product-setup-fee/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The setup fee object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.14.6Delete

Deletes the entity with the given id.

POST /api/subscription-product-setup-fee/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.15Subscription Product Version Retirement Service

3.11.15.1Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-product-version-retirement/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the retirement which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.15.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-product-version-retirement/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.15.3Search

Searches for the entities as specified by the given query.

POST /api/subscription-product-version-retirement/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the product version retirements which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.15.4Create

The create operation creates a new product version retirement.

POST /api/subscription-product-version-retirement/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.16Subscription Product Version Service

3.11.16.1Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-product-version/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.16.2activate

This operation activates a new product version.

POST /api/subscription-product-version/activate View in Client
Query Parameters
  • spaceId
    *
    Long
  • productVersionId
    *
    The product version id identifies the product version which should be activated.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.16.3Create

Creates the entity with the given properties.

POST /api/subscription-product-version/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The product version object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.16.4Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-product-version/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the product version which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.16.5Search

Searches for the entities as specified by the given query.

POST /api/subscription-product-version/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the product versions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Product Version
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.16.6Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/subscription-product-version/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The product version object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.17Subscription Service

3.11.17.1Create

The create operation creates a new subscription and a corresponding subscription version.

POST /api/subscription/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.17.2Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the subscription which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.17.3Search Subscription Invoices

This operation allows to search for subscription invoices.

POST /api/subscription/searchSubscriptionInvoices View in Client
Query Parameters
  • spaceId
    *
    Long
  • subscriptionId
    *
    The id of the subscription for which the invoices should be searched for.
    Long
Message Body *
The query restricts the invoices which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Transaction Invoice
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.17.4update

This operation allows to update the subscription.

POST /api/subscription/update View in Client
Query Parameters
  • spaceId
    *
    Long
  • subscriptionId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.17.5initialize

The initialize operation initializes a subscription. This method uses charge flows to carry out the transaction.

POST /api/subscription/initialize View in Client
Query Parameters
  • spaceId
    *
    Long
  • subscriptionId
    *
    The provided subscription id will be used to lookup the subscription which should be initialized.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.17.6terminate

This operation allows to terminate a subscription.

POST /api/subscription/terminate View in Client
Query Parameters
  • spaceId
    *
    Long
  • subscriptionId
    *
    The subscription id identifies the subscription which should be terminated.
    Long
  • respectTerminationPeriod
    *
    The respect termination period controls whether the termination period configured on the product version should be respected or if the operation should take effect immediately.
    Boolean
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.17.7Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.17.8apply changes

This operation allows to apply changes on a subscription.

POST /api/subscription/applyChanges View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.17.9Search

Searches for the entities as specified by the given query.

POST /api/subscription/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the subscriptions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Subscription
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.17.10initializeSubscriberPresent

The initialize operation initializes a subscription when the subscriber is present. The method will initialize a transaction which has to be completed by using the transaction service.

POST /api/subscription/initializeSubscriberPresent View in Client
Query Parameters
  • spaceId
    *
    Long
  • subscriptionId
    *
    Long
  • successUrl
    The subscriber will be redirected to the success URL when the transaction is successful.
    String
  • failedUrl
    The subscriber will be redirected to the fail URL when the transaction fails.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.17.11update product version

The update product version operation updates the product version of the subscription to the latest active product version.

POST /api/subscription/updateProductVersion View in Client
Query Parameters
  • spaceId
    *
    Long
  • subscriptionId
    *
    The subscription id identifies the subscription which should be updated to the latest version.
    Long
  • respectTerminationPeriod
    *
    The subscription version may be retired. The respect termination period controls whether the termination period configured on the product version should be respected or if the operation should take effect immediately.
    Boolean
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.18Subscription Suspension Service

3.11.18.1Create

The create operation creates a new subscription suspension.

POST /api/subscription-suspension/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.18.2Search

Searches for the entities as specified by the given query.

POST /api/subscription-suspension/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the subscription suspensions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Suspension
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.18.3Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-suspension/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the suspension which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.18.4Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-suspension/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.18.5terminate

The create operation creates a new subscription suspension.

POST /api/subscription-suspension/terminate View in Client
Query Parameters
  • spaceId
    *
    Long
  • suspensionId
    *
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.19Subscription Version Service

3.11.19.1Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-version/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the subscription which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.19.2Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-version/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.19.3Search

Searches for the entities as specified by the given query.

POST /api/subscription-version/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the subscriptions which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.20Subscription ledger entry Service

3.11.20.1Create

The create operation creates a new subscription ledger entry.

POST /api/subscription-ledger-entry/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.20.2Search

Searches for the entities as specified by the given query.

POST /api/subscription-ledger-entry/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the subscription charges which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.20.3Read

Reads the entity with the given 'id' and returns it.

GET /api/subscription-ledger-entry/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the subscription charge which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.11.20.4Count

Counts the number of items in the database as restricted by the given filter.

POST /api/subscription-ledger-entry/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12User

3.12.1Application User Service

3.12.1.1Search

Searches for the entities as specified by the given query.

POST /api/application-user/search View in Client
Message Body *
The query restricts the application users which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Application User
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.1.2Delete

Deletes the entity with the given id.

POST /api/application-user/delete View in Client
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.1.3Count

Counts the number of items in the database as restricted by the given filter.

POST /api/application-user/count View in Client
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.1.4Create

Creates the application user with the given properties.

POST /api/application-user/create View in Client
Message Body *
The user object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.1.5Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/application-user/update View in Client
Message Body *
The application user entity with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.1.6Read

Reads the entity with the given 'id' and returns it.

GET /api/application-user/read View in Client
Query Parameters
  • id
    *
    The id of the application user which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.2Human User Service

3.12.2.1Delete

Deletes the entity with the given id.

POST /api/human-user/delete View in Client
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.2.2Search

Searches for the entities as specified by the given query.

POST /api/human-user/search View in Client
Message Body *
The query restricts the human users which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Human User
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.2.3Create

Creates the entity with the given properties.

POST /api/human-user/create View in Client
Message Body *
The human user object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.2.4Export

Exports the human users into a CSV file. The file will contain the properties defined in the request.

POST /api/human-user/export View in Client
Message Body *
The request controls the entries which are exported.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    binary:
    text/csv
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.2.5Read

Reads the entity with the given 'id' and returns it.

GET /api/human-user/read View in Client
Query Parameters
  • id
    *
    The id of the human user which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.2.6Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/human-user/update View in Client
Message Body *
The object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.2.7Count

Counts the number of items in the database as restricted by the given filter.

POST /api/human-user/count View in Client
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.3Permission Service

3.12.3.1All

This operation returns all entities which are available.

GET /api/permission/all View in Client
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Permission
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.3.2Read

Reads the entity with the given 'id' and returns it.

GET /api/permission/read View in Client
Query Parameters
  • id
    *
    The id of the permission which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.4User Account Role Service

3.12.4.1List Roles

List all the roles that are assigned to the given user in the given account.

POST /api/user-account-role/list View in Client
Query Parameters
  • userId
    *
    The id of the user to whom the role is assigned.
    Long
  • accountId
    *
    The account to which the role is mapped.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of User Account Role
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.4.2Remove Role

This operation removes the specified user account role.

POST /api/user-account-role/removeRole View in Client
Query Parameters
  • id
    *
    The id of user account role which should be removed
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.4.3Add Role

This operation grants the role to the given user with in the given account.

POST /api/user-account-role/addRole View in Client
Query Parameters
  • userId
    *
    The id of the user to whom the role is assigned.
    Long
  • accountId
    *
    The account to which the role is mapped.
    Long
  • roleId
    *
    The role which is mapped to the user and account.
    Long
  • appliesOnSubaccount
    Whether the role applies only on subaccount.
    Boolean
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.5User Space Role Service

3.12.5.1Remove Role

This operation removes the specified user space role.

POST /api/user-space-role/removeRole View in Client
Query Parameters
  • id
    *
    The id of user space role which should be removed
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.5.2Add Role

This operation grants the given role to the user in the given space.

POST /api/user-space-role/addRole View in Client
Query Parameters
  • userId
    *
    The id of the user to whom the role is assigned.
    Long
  • spaceId
    *
    The space to which the role is mapped.
    Long
  • roleId
    *
    The role which is mapped to the user and space.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.12.5.3List Roles

List all the roles that are assigned to the given user in the given space.

POST /api/user-space-role/list View in Client
Query Parameters
  • userId
    *
    The id of the user to whom the role is assigned.
    Long
  • spaceId
    *
    The space to which the role is mapped.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of User Space Role
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.13Webhook

3.13.1Webhook Encryption Service

3.13.1.1Read

Reads the entity with the given 'id' and returns it.

GET /api/webhook-encryption/read View in Client
Query Parameters
  • id
    *
    The ID of the key version.
    String
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.13.2Webhook Listener Service

3.13.2.1Read

Reads the entity with the given 'id' and returns it.

GET /api/webhook-listener/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the webhook listener which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.13.2.2Create

Creates the entity with the given properties.

POST /api/webhook-listener/create View in Client
Examples
use Wallee\Sdk\ApiClient;
use Wallee\Sdk\Model\CreationEntityState;
use Wallee\Sdk\Model\TransactionState;
use Wallee\Sdk\Model\WebhookUrlCreate;
use Wallee\Sdk\Model\WebhookListenerCreate;

$spaceId = <:YOUR_SPACE_ID>;
$userId = <:YOUR_USER_ID>;
$secret = <:YOUR_USER_SECRET>;

$apiClient = new ApiClient($userId, $secret);

$data = [
// Transaction entity id
    'id' => '1472041829003',
    'name' => 'Shopname::WebHook::Transaction',
    'states' => [
        TransactionState::DECLINE,
        TransactionState::FULFILL
    ],
    'notifyEveryChange' => false,
];

// Create webhook Url
$webHookName = 'Shopname: Webhook name';
$webHookUrl = 'https://yourdomain.com/webhook/action';

$entity = (new WebhookUrlCreate())
   ->setName($webHookName)
   ->setUrl($webHookUrl)
   ->setState(CreationEntityState::ACTIVE);

$webHookUrl = $apiClient->getWebhookUrlService()->create($spaceId, $entity);

// Create a transaction webhook for transactions
// Transaction state flow is documented here: https://app-wallee.com/en/doc/payment/transaction-process
$entity = (new WebhookListenerCreate())
    ->setName($data['name'])
    ->setEntity($data['id'])
    ->setNotifyEveryChange($data['notifyEveryChange'])
    ->setState(CreationEntityState::CREATE)
    ->setEntityStates($data['states'])
    ->setUrl($webhookUrl->getId());

$apiClient->getWebhookListenerService()->create($spaceId, $entity);
package com.wallee.walleesdk;

import com.wallee.sdk.ApiClient;
import com.wallee.sdk.model.WebhookListener;
import com.wallee.sdk.model.WebhookListenerCreate;
import com.wallee.sdk.model.WebhookUrl;
import com.wallee.sdk.model.WebhookUrlCreate;
import com.wallee.sdk.service.WebhookListenerService;
import com.wallee.sdk.service.WebhookUrlService;
import org.junit.Test;

import java.util.List;

/**
 * API tests for TransactionPaymentPageService
 */
public class WebhookListenerServiceTest {

    // Credentials
    private Long spaceId = <:YOUR_SPACE_ID>;
    private Long applicationUserId = <:YOUR_USER_ID>;
    private String authenticationKey = <:YOUR_USER_SECRET>;


    // Services
    private ApiClient apiClient;
    private WebhookUrlService webhookUrlService;
    private WebhookListenerService webhookListenerService;

    // Models
    private WebhookUrlCreate webhookUrlPayload;
    private WebhookListenerCreate webhookListenerPayload;

    public WebhookListenerServiceTest() {
        this.apiClient = new ApiClient(applicationUserId, authenticationKey);
        this.webhookUrlService = new WebhookUrlService(this.apiClient);
        this.webhookListenerService = new WebhookListenerService(this.apiClient);
    }

    /**
     * Get webhook url payload
     *
     * @return WebHookUrlCreate
     */
    private WebhookUrlCreate getWebhookUrlPayload() {
        if (this.webhookUrlPayload == null) {
            // Web url
            WebhookUrlCreate urlCreate = new WebhookUrlCreate();
            urlCreate
                    .name("Transaction webhook url")
                    .url("http://transactions.callback-url.com");

            this.webhookUrlPayload = urlCreate;
        }
        return this.webhookUrlPayload;
    }

    /**
     * Get webhook listener payload.
     * This specific example is for transactions.
     * Transaction state flow is documented here: <a href="https://app-wallee.com/en/doc/payment/transaction-process">Transactions</a>
     *
     * @param webhookUrlId - id of an existing webhook url
     * @return WebhookListener create
     */
    private WebhookListenerCreate getWebhookListenerPayload(Long webhookUrlId) {
        if (this.webhookListenerPayload == null) {
            // Webhook listener
            WebhookListenerCreate listenerCreate  = new WebhookListenerCreate();
            listenerCreate
                    .url(webhookUrlId)
                    // Transaction entity ID
                    .entity(1472041829003L)
                    .name("Transaction webhook listener")
                    .entityStates(List.of("FULFILL", "DECLINE"))
                    .notifyEveryChange(false);

            this.webhookListenerPayload = listenerCreate;
        }
        return this.webhookListenerPayload;
    }


    /**
     * create
     *
     *
     * This operation creates a listener entity, that will listen for state changes.
     */
    public void create() {
        try {
            final WebhookUrl webhookUrl = this.webhookUrlService.create(spaceId, getWebhookUrlPayload());
            final WebhookListener webhookListener = this.webhookListenerService.create(spaceId, getWebhookListenerPayload(webhookUrl.getId()));
            // expect webhookListener.getId() to not be null
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

}
Query Parameters
  • spaceId
    *
    Long
Message Body *
The webhook listener object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.13.2.3Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/webhook-listener/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The webhook listener object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.13.2.4Search

Searches for the entities as specified by the given query.

POST /api/webhook-listener/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the webhook listeners which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Webhook Listener
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.13.2.5Delete

Deletes the entity with the given id.

POST /api/webhook-listener/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.13.2.6Count

Counts the number of items in the database as restricted by the given filter.

POST /api/webhook-listener/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.13.3Webhook Url Service

3.13.3.1Update

This updates the entity with the given properties. Only those properties which should be updated can be provided. The 'id' and 'version' are required to identify the entity.

POST /api/webhook-url/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The webhook url object with all the properties which should be updated. The id and the version are required properties.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.13.3.2Create

Creates the entity with the given properties.

POST /api/webhook-url/create View in Client
Examples
use Wallee\Sdk\ApiClient;
use Wallee\Sdk\Model\CreationEntityState;
use Wallee\Sdk\Model\WebhookUrlCreate;

$spaceId = <:YOUR_SPACE_ID>;
$userId = <:YOUR_USER_ID>;
$secret = <:YOUR_USER_SECRET>;

$apiClient = new ApiClient($userId, $secret);


// Create webhook Url
$webHookName = 'Shopname: Webhook name';
$webHookUrl = 'https://yourdomain.com/webhook/action';

$entity = (new WebhookUrlCreate())
   ->setName($webHookName)
   ->setUrl($webHookUrl)
   ->setState(CreationEntityState::ACTIVE);

$apiClient->getWebhookUrlService()->create($spaceId, $entity);
package com.wallee.walleesdk;

import com.wallee.sdk.ApiClient;
import com.wallee.sdk.model.WebhookUrl;
import com.wallee.sdk.model.WebhookUrlCreate;
import com.wallee.sdk.service.WebhookUrlService;

/**
 * API tests for WebhookUrlService
 */
public class WebhookUrlServiceTest {

    // Credentials
    private Long spaceId = <:YOUR_SPACE_ID>;
    private Long applicationUserId = <:YOUR_USER_ID>;
    private String authenticationKey = <:YOUR_USER_SECRET>;


    // Services
    private ApiClient apiClient;
    private WebhookUrlService webhookUrlService;

    // Models
    private WebhookUrlCreate webhookUrlPayload;

    public WebhookUrlServiceTest() {
        this.apiClient = new ApiClient(applicationUserId, authenticationKey);
        this.webhookUrlService = new WebhookUrlService(this.apiClient);
    }

    /**
     * Get webhook url payload
     *
     * @return WebhookUrlCreate
     */
    private WebhookUrlCreate getWebhookUrlPayload() {
        if (this.webhookUrlPayload == null) {
            // Webhook url
            WebhookUrlCreate urlCreate = new WebhookUrlCreate();
            urlCreate
                    .name("Transaction webhook url")
                    .url("http://transactions.callback-url.com");

            this.webhookUrlPayload = urlCreate;
        }
        return this.webhookUrlPayload;
    }

    /**
     * create
     *
     *
     * This operation creates a webhook url entity, that will be used for posting.
     */
    public void create() {
        try {
            final WebhookUrl webhookUrl = this.webhookUrlService.create(spaceId, getWebhookUrlPayload());
            // expect webhookUrl.getUrl() to be a URL beginning with https://
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

}
Query Parameters
  • spaceId
    *
    Long
Message Body *
The webhook url object with the properties which should be created.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.13.3.3Search

Searches for the entities as specified by the given query.

POST /api/webhook-url/search View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The query restricts the webhook urls which are returned by the search.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Collection of Webhook URL
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.13.3.4Delete

Deletes the entity with the given id.

POST /api/webhook-url/delete View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    No Response Body
  • 409
    Error
    This status code indicates that there was a conflict with the current version of the data in the database and the provided data in the request.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.13.3.5Read

Reads the entity with the given 'id' and returns it.

GET /api/webhook-url/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the webhook url which should be returned.
    Long
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

3.13.3.6Count

Counts the number of items in the database as restricted by the given filter.

POST /api/webhook-url/count View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
  • 200
    OK
    This status code indicates that a client request was successfully received, understood, and accepted.
    Long
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
  • 542
    Error
    This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.

4Model Definitions

The service may return complex objects those objects are defined within this section.

Models may have references between each other. A reference means an object points to another object. Depending on the reference we serialize the referenced object directly or we only serialize the primary key (long) of the referenced object. This means depending on the use case the actual object needs to be loaded with the according service. In this case we indicate this by defining the type as a long and we provide a link to the actual model we reference.

4.1Analytics

4.1.1Analytics Query Details

Represents a query to be submitted for execution in Analytics.

Properties
  • accountId
    *
    The mandatory ID of an account in which the query shall be executed. Must be a valid account ID greater than 0.
    Long
  • externalId
    A client generated nonce which uniquely identifies the query to be executed. Subsequent submissions with the same external ID will not re-execute the query but instead return the existing execution with that ID. Either the External ID or a Maximal Cache Age greater than 0 must be specified. If both are specified the External ID will have precedence and the Maximal Cache Age will be ignored.
    String
  • maxCacheAge
    The maximal age in minutes of cached query executions to return. If an equivalent query execution with the same Query String, Account ID and Spaces parameters not older than the specified age is already available that execution will be returned instead of a newly started execution. Set to 0 or null (and set a unique, previously unused External ID) to force a new query execution irrespective of previous executions. Either the External ID or a Cache Duration greater than 0 must be specified. If both are specified, the External ID will be preferred (and the Maximal Cache Age ignored).
    Integer
  • queryString
    1 - 4,096 options
    The SQL statement which is being submitted for execution. Must be a valid PrestoDB/Athena SQL statement.
    String
  • scannedDataLimit
    The maximal amount of scanned data that this query is allowed to scan. After this limit is reached query will be canceled by the system.
    Decimal
  • spaceIds
    ≤ 5 options
    The IDs of the spaces in which the query shall be executed. At most 5 space IDs may be specified. All specified spaces must be owned by the account specified by the accountId property. The spaces property may be missing or empty to query all spaces of the specified account.
    Collection of Long

4.1.2Analytics Schema Column Info Details

Meta information about a column within a table.

Properties
  • aliasName
    The name of the alias defined for the column in the query or null if none is defined.
    String
  • columnName
    The name of the column in the table or null if this is a synthetic column which is the result of some SQL expression.
    String
  • description
    A human readable description of the property contained in this column or null if this is a synthetic column which is the result of some SQL expression.
    Map of String String
  • precision
    The precision (maximal number of digits) for decimal data types, otherwise 0.
    Integer
  • referencedTable
    The name of the referenced table if this column represents a foreign-key relation to the IDs of another table, otherwise null.
    String
  • scale
    The scale (maximal number number of digits in the fractional part) in case of a decimal data type, otherwise 0.
    Integer
  • tableName
    The name of the table which defines this column.
    String
  • type
    The ORC data type of the column value.
    String

4.1.3Analytics Schema Info Details

The schema of a single table in Analytics.

Properties
  • columns
    The schemas of all columns of this table.
  • description
    A human readable description of the entity type contained in this table.
    Map of String String
  • tableName
    The name of this table.
    String

4.1.4Query Execution Details

Represents the execution of a query which has been submitted to Analytics.

Properties
  • account
    The account in which the query has been executed.
  • errorMessage
    The error message if and only if the query has failed, otherwise null.
    String
  • externalId
    The External ID of the query if one had been specified; otherwise null.
    String
  • failureReason
    The reason of the failure if and only if the query has failed, otherwise null.
  • id
    A unique identifier for the object.
    Long
  • processingEndTime
    The time at which processing of the query has finished (either successfully or by failure or by cancelation). Will be null if the query execution has not finished yet.
    DateTime
  • processingStartTime
    The time at which processing of the query has started (never null).
    DateTime
  • queryString
    The SQL statement which has been submitted for execution.
    String
  • scannedDataInGb
    The amount of data scanned while processing the query (in GB). (Note that this amount may increase over time while the query is still being processed and not finished yet.)
    Decimal
  • scannedDataLimit
    The maximal amount of scanned data that this query is allowed to scan. After this limit is reached query will be canceled by the system.
    Decimal
  • spaces
    The spaces in which the query has been executed. May be empty if all spaces of the specified account have been queried.
    Collection of Long
  • state
    The current state of the query execution.

4.1.5Query Execution State

The state of a query execution.

Fields
  • PROCESSING
    Processing
    The query is being processed.
  • PROCESSED
    Processed
    The query has been successfully processed and the result is ready to be fetched. This is a final state.
  • FAILED
    Failed
    Processing of the query has failed. This is a final state.
  • CANCELED
    Canceled
    Processing of the query has been canceled. This is a final state.

4.1.6Query Result Batch Details

A batch of the result of a query executed in Analytics.

Properties
  • columns
    The schemas of the columns returned by the query (in order). Will be null if the results of the query are not (yet) available.
  • nextToken
    The token to be provided to fetch the next batch of results. May be null if no more result batches are available.
    String
  • queryExecution
    The query execution which produced the result.
  • rows
    The rows of the result set contained in this batch where each row is a list of column values (in order of the columns specified in the query). Will be null if the results of the query are not (yet) available.
    Collection of Collection of String

4.2Base

4.2.1Account Details

Properties
  • active
    Virtual
    Whether this account and all its parent accounts are active.
    Boolean
  • activeOrRestrictedActive
    Virtual
    Whether this account and all its parent accounts are active or restricted active.
    Boolean
  • createdBy
    The ID of the user the account was created by.
    Long
  • createdOn
    The date and time when the account was created.
    DateTime
  • deletedBy
    The ID of a user the account was deleted by.
    Long
  • deletedOn
    The date and time when the account was deleted.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • lastModifiedDate
    The date and time when the object was last modified.
    DateTime
  • name
    3 - 200 chars
    The name used to identify the account.
    String
  • parentAccount
    Virtual
    The parent account responsible for administering this account.
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • restrictedActive
    Virtual
    Whether this account and all its parent accounts are active or restricted active. There is at least one account that is restricted active.
    Boolean
  • scope
    The scope that the account belongs to.
    Long
  • state
    The object's current state.
  • subaccountLimit
    The number of sub-accounts that can be created within this account.
    Long
  • type
    The account's type which defines its role and capabilities.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.2.2Account State

Fields
  • CREATE
    Create
  • RESTRICTED_ACTIVE
    Restricted Active
  • ACTIVE
    Active
  • INACTIVE
    Inactive
  • DELETING
    Deleting
  • DELETED
    Deleted

4.2.3Account Type

Fields
  • MASTER
    Master
  • REGULAR
    Regular
  • SUBACCOUNT
    Subaccount

4.2.4Address Details

Properties
  • city
    ≤ 100 chars
    The city, town or village.
    String
  • commercialRegisterNumber
    ≤ 100 chars
    The commercial registration number of the organization.
    String
  • country
    The two-letter country code (ISO 3166 format).
    String
  • dateOfBirth
    The date of birth.
    Date
  • dependentLocality
    ≤ 100 chars
    The dependent locality which is a sub-division of the state.
    String
  • emailAddress
    Email
    ≤ 254 chars
    The email address.
    String
  • familyName
    ≤ 100 chars
    The family or last name.
    String
  • gender
    The gender.
  • givenName
    ≤ 100 chars
    The given or first name.
    String
  • legalOrganizationForm
    The legal form of the organization.
  • mobilePhoneNumber
    ≤ 100 chars
    The phone number of a mobile phone.
    String
  • organizationName
    ≤ 100 chars
    The organization's name.
    String
  • phoneNumber
    ≤ 100 chars
    The phone number.
    String
  • postalState
    The name of the region, typically a state, county, province or prefecture.
    String
  • postcode
    ≤ 40 chars
    The postal code, also known as ZIP, postcode, etc.
    String
  • salesTaxNumber
    ≤ 100 chars
    The sales tax number of the organization.
    String
  • salutation
    ≤ 20 chars
    The salutation e.g. Mrs, Mr, Dr.
    String
  • socialSecurityNumber
    ≤ 100 chars
    The social security number.
    String
  • sortingCode
    ≤ 100 chars
    The sorting code identifying the post office where the PO Box is located.
    String
  • street
    ≤ 300 chars
    The street or PO Box.
    String

4.2.5Creation Entity State

Fields
  • CREATE
    Create
  • ACTIVE
    Active
  • INACTIVE
    Inactive
  • DELETING
    Deleting
  • DELETED
    Deleted

4.2.6Criteria Operator

Fields
  • CONTAINS
    Contains
  • EQUALS
    Equals
  • EQUALS_IGNORE_CASE
    Equals Ignore Case
  • GREATER_THAN
    Greater Than
  • GREATER_THAN_OR_EQUAL
    Greater Than Or Equal
  • LESS_THAN
    Less Than
  • LESS_THAN_OR_EQUAL
    Less Than Or Equal
  • NOT_EQUALS
    Not Equals
  • NOT_EQUALS_IGNORE_CASE
    Not Equals Ignore Case
  • NOT_CONTAINS
    Not Contains
  • IS_NULL
    Is Null
  • IS_NOT_NULL
    Is Not Null

4.2.7Database Details

Properties
  • id
    A unique identifier for the object.
    Long
  • name
    ≤ 200 chars
    The name used to identify the database.
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.2.8Environment

Fields
  • LIVE
    Live
  • PREVIEW
    Preview

4.2.9Failure Category

Fields
  • TEMPORARY_ISSUE
    Temporary Issue
  • INTERNAL
    Internal
  • END_USER
    End User
  • CONFIGURATION
    Configuration
  • DEVELOPER
    Developer

4.2.10Failure Reason Details

Properties
  • category
  • description
    The localized description of the object.
    Map of String String
  • features
    Collection of Long
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.2.11Feature Details

Properties
  • beta
    Whether the feature is in beta stage and there may still be some issues.
    Boolean
  • category
    The category that the feature belongs to.
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • logoPath
    The path to the feature's logo image.
    String
  • name
    The localized name of the object.
    Map of String String
  • requiredFeatures
    The features that must be enabled for this feature to work properly.
    Collection of Long
  • sortOrder
    When listing features, they can be sorted by this number.
    Integer
  • visible
    Boolean

4.2.12Feature Category Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String
  • orderWeight
    When listing feature categories, they can be sorted by this number.
    Integer

4.2.13Gender

Fields
  • MALE
    Male
  • FEMALE
    Female

4.2.14Line Item Details

Properties
  • aggregatedTaxRate
    Virtual
    The aggregated tax rate is the sum of all tax rates of the line item.
    Decimal
  • amountExcludingTax
    Virtual
    Decimal
  • amountIncludingTax
    Virtual
    Decimal
  • attributes
    Map of String Line Item Attribute
  • discountExcludingTax
    Virtual
    Decimal
  • discountIncludingTax
    Decimal
  • name
    1 - 150 chars
    String
  • quantity
    Positive
    Decimal
  • shippingRequired
    Boolean
  • sku
    ≤ 200 chars
    String
  • taxAmount
    Virtual
    Decimal
  • taxAmountPerUnit
    Virtual
    Decimal
  • taxes
    Collection of Tax
  • type
  • undiscountedAmountExcludingTax
    Virtual
    Decimal
  • undiscountedAmountIncludingTax
    Virtual
    Decimal
  • undiscountedUnitPriceExcludingTax
    Virtual
    Decimal
  • undiscountedUnitPriceIncludingTax
    Virtual
    Decimal
  • uniqueId
    ≤ 200 chars
    The unique id identifies the line item within the set of line items associated with the transaction.
    String
  • unitPriceExcludingTax
    Virtual
    Decimal
  • unitPriceIncludingTax
    Virtual
    Decimal

4.2.15Line Item Attribute Details

Properties
  • label
    ≤ 512 chars
    String
  • value
    ≤ 512 chars
    String

4.2.16Line Item Reduction Details

Properties
  • lineItemUniqueId
    ≤ 200 chars
    The unique id identifies the line item on which the reduction is applied on.
    String
  • quantityReduction
    Positive
    Decimal
  • unitPriceReduction
    Decimal

4.2.17Line Item Type

Fields
  • SHIPPING
    Shipping
  • DISCOUNT
    Discount
  • FEE
    Fee
  • PRODUCT
    Product
  • TIP
    Tip

4.2.18Metric Usage Details

The metric usage provides details about the consumption of a particular metric.

Properties
  • consumedUnits
    The consumed units provide the value of how much has been consumed of the particular metric.
    Decimal
  • metricDescription
    The metric description describes the metric.
    Map of String String
  • metricId
    The metric ID identifies the metric for consumed units.
    Long
  • metricName
    The metric name defines the name of the consumed units.
    Map of String String

4.2.19Resource Path Details

Properties
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • path
    4 - 500 chars
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • spaceId
    Long
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.2.20Resource State

Fields
  • ACTIVE
    Active
  • DELETING
    Deleting
  • DELETED
    Deleted

4.2.21Scope Details

Properties
  • domainName
    ≤ 40 chars
    The domain name that belongs to the scope.
    String
  • features
    The list of features that are active in the scope.
    Collection of Feature
  • id
    A unique identifier for the object.
    Long
  • machineName
    ≤ 50 chars
    ([A-Z][A-Za-z0-9]+)(_([A-Z][A-Za-z0-9]+))*
    The name identifying the scope in e.g. URLs.
    String
  • name
    ≤ 50 chars
    The name used to identify the scope.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • port
    ≥ 1
    The port where the scope can be accessed.
    Integer
  • sslActive
    Whether the scope supports SSL.
    Boolean
  • state
    The object's current state.
  • themes
    The themes that determine the look and feel of the scope's user interface. A fall-through strategy is applied when building the actual theme.
    Collection of String
  • url
    Virtual
    The URL where the scope can be accessed.
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.2.22Space Details

Properties
  • account
    The account that the space belongs to.
  • active
    Virtual
    Whether this space and all its parent accounts are active.
    Boolean
  • activeOrRestrictedActive
    Virtual
    Whether this space and all its parent accounts are active or restricted active.
    Boolean
  • createdBy
    The ID of the user the space was created by.
    Long
  • createdOn
    The date and time when the space was created.
    DateTime
  • database
    The database the space is connected to and that holds the space's data.
  • deletedBy
    The ID of the user the space was deleted by.
    Long
  • deletedOn
    The date and time when the space was deleted.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • lastModifiedDate
    The date and time when the object was last modified.
    DateTime
  • name
    3 - 200 chars
    The name used to identify the space.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • postalAddress
    The address that is used in communication with clients for example in emails, documents, etc.
  • primaryCurrency
    The currency that is used to display aggregated amounts in the space.
    String
  • requestLimit
    The maximum number of API requests that are accepted within two minutes. This limit can only be changed with special privileges.
    Long
  • restrictedActive
    Virtual
    Whether this space and all its parent accounts are active or restricted active. There is least one parent account that is restricted active.
    Boolean
  • state
    The object's current state.
  • technicalContactAddresses
    The email address that will receive messages about technical issues and errors that occur in the space.
    Collection of String
  • timeZone
    The time zone that is used to schedule and run background processes. This does not affect the formatting of dates in the user interface.
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.2.23Space Address Details

Properties
  • city
    The city, town or village.
    String
  • country
    The two-letter country code (ISO 3166 format).
    String
  • dependentLocality
    ≤ 100 chars
    The dependent locality which is a sub-division of the state.
    String
  • emailAddress
    The email address used for communication with clients.
    String
  • familyName
    ≤ 100 chars
    The family or last name.
    String
  • givenName
    ≤ 100 chars
    The given or first name.
    String
  • mobilePhoneNumber
    ≤ 100 chars
    The phone number of a mobile phone.
    String
  • organizationName
    ≤ 100 chars
    The organization's name.
    String
  • phoneNumber
    ≤ 100 chars
    The phone number.
    String
  • postalState
    The name of the region, typically a state, county, province or prefecture.
    String
  • postcode
    The postal code, also known as ZIP, postcode, etc.
    String
  • salesTaxNumber
    ≤ 100 chars
    The sales tax number of the organization.
    String
  • salutation
    ≤ 20 chars
    The salutation e.g. Mrs, Mr, Dr.
    String
  • sortingCode
    ≤ 100 chars
    The sorting code identifying the post office where the PO Box is located.
    String
  • street
    The street or PO Box.
    String

4.2.24Space Reference Details

Properties
  • createdOn
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • spaceId
    Long
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.2.25Space Reference State

Fields
  • RESTRICTED_ACTIVE
    Restricted Active
  • ACTIVE
    Active
  • INACTIVE
    Inactive
  • DELETING
    Deleting
  • DELETED
    Deleted

4.2.26Space View Details

Properties
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    3 - 200 chars
    The space view name is used internally to identify the space view in administrative interfaces. For example it is used within search fields and hence it should be distinct and descriptive.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • space
    The space to which the view belongs to.
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.2.27Web App Confirmation Request Details

Properties
  • code
    ≤ 100 chars
    The user returns to the web app after granting the permission. The HTTP request contains the code. Provide it here to confirm the web app installation.
    String

4.2.28Web App Confirmation Response Details

The confirmation response provides the details about the installation of the web app.

Properties
  • access_token
    The access code grants permissions to the web service API according to the OAuth standard.
    String
  • scope
    The scope contains the permissions granted to the web app within the space.
    String
  • space
    This is the space into which the web app is installed into.
  • state
    The state contains the state parameter content provided when initiating the app installation.
    String
  • token_type
    The token type indicates the type of the access token. The type determines the authentication mechanism to use for accessing the web service API.
    String

4.3Customer

4.3.1Customer Details

Properties
  • createdOn
    The date and time when the object was created.
    DateTime
  • customerId
    ≤ 100 chars
    The customer's ID in the merchant's system.
    String
  • emailAddress
    Email
    ≤ 254 chars
    The customer's email address.
    String
  • familyName
    ≤ 100 chars
    The customer's family or last name.
    String
  • givenName
    ≤ 100 chars
    The customer's given or first name.
    String
  • id
    A unique identifier for the object.
    Long
  • language
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • metaData
    Virtual
    Allow to store additional information about the object.
    Map of String String
  • preferredCurrency
    The customer's preferred currency.
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.3.2Customer Address Details

Properties
  • address
    The actual postal address.
  • addressType
    Whether the address is for billing or shipping or both.
  • createdOn
    The date and time when the object was created.
    DateTime
  • customer
    The customer that the object belongs to.
  • defaultAddress
    Whether this is the customer's default address.
    Boolean
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.3.3Customer Address Type

Fields
  • BILLING
    Billing
  • SHIPPING
    Shipping
  • BOTH
    Both

4.3.4Customer Comment Details

Properties
  • content
    ≤ 262,144 chars
    The comment's actual content.
    String
  • createdBy
    The ID of the user the comment was created by.
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • customer
    The customer that the object belongs to.
  • editedBy
    The ID of the user the comment was last updated by.
    Long
  • editedOn
    The date and time when the comment was last updated.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • pinned
    Whether the comment is pinned to the top.
    Boolean
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.3.5Customer Postal Address Details

Properties
  • city
    ≤ 100 chars
    The city, town or village.
    String
  • commercialRegisterNumber
    ≤ 100 chars
    The commercial registration number of the organization.
    String
  • country
    The two-letter country code (ISO 3166 format).
    String
  • dateOfBirth
    The date of birth.
    Date
  • dependentLocality
    ≤ 100 chars
    The dependent locality which is a sub-division of the state.
    String
  • emailAddress
    Email
    ≤ 254 chars
    The email address.
    String
  • familyName
    ≤ 100 chars
    The family or last name.
    String
  • gender
    The gender.
  • givenName
    ≤ 100 chars
    The given or first name.
    String
  • legalOrganizationForm
    The legal form of the organization.
  • mobilePhoneNumber
    ≤ 100 chars
    The phone number of a mobile phone.
    String
  • organizationName
    ≤ 100 chars
    The organization's name.
    String
  • phoneNumber
    ≤ 100 chars
    The phone number.
    String
  • postalState
    The name of the region, typically a state, county, province or prefecture.
    String
  • postcode
    ≤ 40 chars
    The postal code, also known as ZIP, postcode, etc.
    String
  • salesTaxNumber
    ≤ 100 chars
    The sales tax number of the organization.
    String
  • salutation
    ≤ 20 chars
    The salutation e.g. Mrs, Mr, Dr.
    String
  • socialSecurityNumber
    ≤ 100 chars
    The social security number.
    String
  • sortingCode
    ≤ 100 chars
    The sorting code identifying the post office where the PO Box is located.
    String
  • street
    ≤ 300 chars
    The street or PO Box.
    String

4.4Debt Collection

4.4.1Condition Details

A condition controls under which circumstances a collector configuration is applied to a debt collection case.

Properties
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The condition name is used internally to identify the condition. For example the name is used within search fields and hence it should be distinct and descriptive.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • type
    The condition type determines the condition realization.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.4.2Debt Collection Case Details

The debt collection case represents a try to collect the money from the debtor.

Properties
  • amount
    The amount is the total amount of the not paid items. The amount cannot be change once the case is reviewed.
    Decimal
  • billingAddress
    The billing address of the case identifies the debtor.
  • closedOn
    The closed on date indicates when the case is closed on.
    DateTime
  • collectorConfiguration
    The collector configuration determines how the debt collection case is processed.
  • contractDate
    The contract date is the date on which the contract with the debtor was signed on.
    DateTime
  • createdOn
    The date and time when the object was created.
    DateTime
  • creator
    The creator references the user which has created the debt collection case.
    Long
  • currency
    The currency defines the billing currency of the debt collection case.
    String
  • dueDate
    The due date indicates the date on which the amount receivable was due. This date has to be always in the past.
    DateTime
  • environment
    The environment in which this case will be processed. There must be a debt collector configuration present which supports the chosen environment.
  • externalId
    A client generated nonce which identifies the entity to be created. Subsequent creation requests with the same external ID will not create new entities but return the initially created entity instead.
    String
  • failedOn
    The failed on date indicates when the case is failed on.
    DateTime
  • failureReason
  • id
    A unique identifier for the object.
    Long
  • labels
    Collection of Label
  • language
    The language indicates the language to be used in the communication with the debtor.
    String
  • lineItems
    The line items of the debt collection case will be shown on documents sent to the debtor and the total of them makes up total amount to collect.
    Collection of Line Item
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • nextAttemptOn
    DateTime
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • processingStartedOn
    The processing started on date indicates the date on which the processing of the case started on.
    DateTime
  • processingTimeoutOn
    DateTime
  • reference
    The case reference is used in the communication with the debtor. It should be unique and it should be linkable with the source of the debt collection case.
    String
  • reviewStartedOn
    DateTime
  • reviewedOn
    The reviewed on date indicates when the review of the case was conducted on.
    DateTime
  • reviewer
    The reviewer references the user which has reviewed the case.
    Long
  • source
    The source of the debt collection case indicates the origin of the amount receivable.
  • sourceEntityId
    The source entity ID points to the object which is the origin of the debt collection case. This ID is only set when the case was triggered by an internal process.
    Long
  • spaceViewId
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.4.3Debt Collection Case Document Details

Properties
  • createdOn
    The date and time when the object was created.
    DateTime
  • debtCollectionCase
  • fileName
    ≤ 100 chars
    String
  • id
    A unique identifier for the object.
    Long
  • labels
    Collection of Label
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • mimeType
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • storageId
    ≤ 100 chars
    String
  • uniqueId
    ≤ 500 chars
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.4.4Debt Collection Case Source Details

The debt collection case source represents the origin of the case. It allows to understand from where the amount receivable is coming from.

Properties
  • description
    The localized description of the object.
    Map of String String
  • forcedPreparingState
    Boolean
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.4.5Debt Collection Case State

Fields
  • CREATE
    Create
  • PREPARING
    Preparing
  • REVIEWING
    Reviewing
  • PENDING
    Pending
  • PROCESSING
    Processing
  • CLOSED
    Closed
  • FAILED
    Failed

4.4.6Debt Collection Condition Details

The debt collection condition type controls how a condition is applied to a case.

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.4.7Debt Collection Environment

Fields
  • PRODUCTION
    Production
  • TEST
    Test

4.4.8Debt Collection Receipt Details

Properties
  • amount
    Decimal
  • createdBy
    The created by field indicates the user which has created the receipt.
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • debtCollectionCase
  • externalId
    1 - 100 chars
    The external id is a unique identifier for the receipt. The external id has to be unique in combination with the debt collection case. When a receipt is sent with an existing external id the existing one is returned rather than a new one is created.
    String
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • source
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.4.9Debt Collection Receipt Source Details

The debt collection receipt source represents the origin of a particular part of the collected amount. It allows to understand from where the amount is coming from, e.g. if it was added manually or in some other way.

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.4.10Debt Collector Details

The debt collector connects to an external service to process the debt collection case and as such directs the debt collection process.

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.4.11Debt Collector Configuration Details

The debt collector configuration defines the behavior of the collection process for a particular collector.

Properties
  • collector
    The collector handles the debt collection case based on the settings of this configuration.
  • conditions
    The conditions applied to the collector configuration restricts the application of this configuration onto a particular debt collection case.
    Collection of Long
  • enabledSpaceViews
    The collector configuration is only enabled for the selected space views. In case the set is empty the collector configuration is enabled for all space views.
    Collection of Long
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The collector configuration name is used internally to identify a specific collector configuration. For example the name is used within search fields and hence it should be distinct and descriptive.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • priority
    The priority defines the order in which the collector configuration is tried to be applied onto a debt collection case. The higher the value the less likely the configuration is applied on a case.
    Integer
  • skipReviewEnabled
    When the review is skipped there will be no review for cases which use this configuration.
    Boolean
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.5Document

4.5.1Document Template Details

A document template contains the customizations for a particular document template type.

Properties
  • defaultTemplate
    The default document template is used whenever no specific template is specified for a particular template type.
    Boolean
  • deliveryEnabled
    Boolean
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • spaceId
    Long
  • state
    The object's current state.
  • templateResource
  • type
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.5.2Document Template Type Details

Properties

4.5.3Document Template Type Group Details

Properties
  • id
    A unique identifier for the object.
    Long
  • title
    Map of String String

4.5.4Rendered Document Details

Properties

4.6Entity Query

4.6.1Entity Export Request Details

The entity property export request contains the information required to create an export of a list of entities.

Properties
  • properties
    *
    The properties is a list of property paths which should be exported.
    Collection of String
  • query
    The query limits the returned entries. The query allows to restrict the entries to return and it allows to control the order of them.

4.6.2Entity Query Details

The entity query allows to search for specific entities by providing filters. This is similar to a SQL query.

Properties
  • filter
    The filter node defines the root filter node of the query. The root node may contain multiple sub nodes with different filters in it.
  • language
    The language is applied to the ordering of the entities returned. Some entity fields are language dependent and hence the language is required to order them.
    String
  • numberOfEntities
    The number of entities defines how many entities should be returned. There is a maximum of 100 entities.
    Integer
  • orderBys
    The order bys allows to define the ordering of the entities returned by the search.
  • startingEntity
    The 'starting entity' defines the entity number at which the returned result should start. The entity number is the consecutive number of the entity as returned and it is not the entity id.
    Integer

4.6.3Entity Query Filter Details

The query filter allows to restrict the entities which are returned.

Properties
  • children
    The 'children' can contain other filter nodes which are applied to the query. This property is only applicable on filter types 'OR' and 'AND'.
    Collection of Entity Query Filter
  • fieldName
    The 'fieldName' indicates the property on the entity which should be filtered. This property is only applicable on filter type 'LEAF'.
    String
  • operator
    The 'operator' indicates what kind of filtering on the 'fieldName' is executed on. This property is only applicable on filter type 'LEAF'.
  • type
    *
    The filter type controls how the query node is interpreted. I.e. if the node acts as leaf node or as a filter group.
  • value
    The 'value' is used to compare with the 'fieldName' as defined by the 'operator'. This property is only applicable on filter type 'LEAF'.
    Object

4.6.4Entity Query Filter Type

The filter type defines how the filter is interpreted. Depending of the type different properties are relevant on the filter itself.

Fields
  • LEAF
    Leaf
    The leaf node defines a restriction on the result set.
  • OR
    OR
    The OR node defines a group of nodes which are combined with a logical OR.
  • AND
    AND
    The AND node defines a group of nodes which are combined with a logical AND.

4.6.5Entity Query Order By Details

The 'order by' allows to order the returned entities.

Properties

4.6.6Order By Type

The 'order by' type specifies how the result is sorted.

Fields
  • DESC
    Descending
    Sorts the result descending.
  • ASC
    Ascending
    Sorts the result ascending.

4.7Error

4.7.1Client Error Details

An error that is returned as the result of a bad user request or a misconfiguration.

Properties
  • date
    Date when an error has occurred.
    String
  • defaultMessage
    The error message which is translated into the default language (i.e. English).
    String
  • id
    Unique identifier of an error.
    String
  • message
    The error message which is translated in into the language of the client.
    String
  • type
    The type of the client error.

4.7.2Client Error Type

The type of Client Errors which can be returned by a service.

Fields
  • END_USER_ERROR
    User Error
    User error is the result of a direct user input.
  • CONFIGURATION_ERROR
    Configuration Error
    A configuration Error indicates that there is an application configuration which is configured incorrectly.
  • DEVELOPER_ERROR
    Developer Error
    A developer Error indicates that there is a bad API request.

4.7.3Server Error Details

This error is thrown when something unexpected happens on our side.

Properties
  • date
    Date when an error has occurred.
    String
  • id
    Unique identifier of an error.
    String
  • message
    This message describes an error.
    String

4.8Installment

4.8.1Installment Calculated Plan Details

Properties

4.8.2Installment Calculated Slice Details

Properties
  • amountIncludingTax
    Decimal
  • dueOn
    DateTime
  • lineItems
    Collection of Line Item

4.8.3Installment Payment Details

An installment payment represents a payment paid in multiple slices.

Properties
  • createdOn
    The date and time when the object was created.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • initialTransaction
  • lineItems
    Collection of Line Item
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • planConfiguration
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.8.4Installment Payment Slice Details

An installment payment slice represents a single transaction of money from the buyer to the merchant.

Properties
  • chargeOn
    DateTime
  • createdOn
    The date and time when the object was created.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • installmentPayment
  • lineItems
    Collection of Line Item
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • transaction
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.8.5Installment Payment Slice State

Fields
  • CREATE
    Create
  • SCHEDULED
    Scheduled
  • CANCELED
    Canceled
  • PREPARE_PROCESSING
    Prepare Processing
  • PROCESSING
    Processing
  • FAILED
    Failed
  • SUCCESSFUL
    Successful

4.8.6Installment Payment State

Fields
  • CREATE
    Create
  • CONFIRMED
    Confirmed
  • AUTHORIZED
    Authorized
  • REJECTED
    Rejected
  • COMPLETED
    Completed
  • RUNNING
    Running
  • DONE
    Done
  • DEFAULTED
    Defaulted

4.8.7Installment Plan Details

The installment plan allows to setup a template for an installment.

Properties
  • baseCurrency
    The base currency in which the installment fee and minimal amount are defined.
    String
  • conditions
    If a transaction meets all selected conditions the installment plan will be available to the customer to be selected.
    Collection of Long
  • id
    A unique identifier for the object.
    Long
  • installmentFee
    The installment fee is a fixed amount that is charged additionally when applying this installment plan.
    Decimal
  • interestRate
    The interest rate is a percentage of the total amount that is charged additionally when applying this installment plan.
    Decimal
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • minimalAmount
    The installment plan can only be applied if the orders total is at least the defined minimal amount.
    Decimal
  • name
    ≤ 100 chars
    The installment plan name is used internally to identify the plan in administrative interfaces.For example it is used within search fields and hence it should be distinct and descriptive.
    String
  • paymentMethodConfigurations
    A installment plan can be enabled only for specific payment method configurations. Other payment methods will not be selectable by the buyer.
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • sortOrder
    The sort order controls in which order the installation plans are listed. The sort order is used to order the plans in ascending order.
    Integer
  • spaceReference
  • state
    The object's current state.
  • taxClass
    The tax class determines the taxes which are applicable on all fees linked to the installment plan.
  • termsAndConditions
    The terms and conditions will be displayed to the customer when he or she selects this installment plan.
  • title
    The title of the installment plan is used within the payment process. The title is visible to the buyer.
    Map of String String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.8.8Installment Plan Slice Details

The installment plan slice defines a single slice of an installment plan.

Properties
  • id
    A unique identifier for the object.
    Long
  • lineItemTitle
    The title of this slices line items. The title is visible to the buyer.
    Map of String String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • period
    The period defines how much time passes between the last slice and this slice. The charge is triggered at the end of the period. When the slice should be charged immediately the period needs to be zero.
    String
  • plan
    The installment plan this slice belongs to.
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • priority
    The priority controls in which order the slices are applied. The lower the value the higher the precedence.
    Integer
  • proportion
    ≥ 1
    The proportion defines how much of the total installment payment has to be paid in this slice. The value is summed up with the other slices and the ratio of all proportions compared to proportion of this slice determines how much the buyer has to pay in this slice.
    Decimal
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.9Internationalization

4.9.1Address Format Details

Properties
  • postCodeExamples
    A list of sample post codes.
    Collection of String
  • postCodeRegex
    The regular expression to validate post codes.
    String
  • requiredFields
    The fields that are required in the address format.
    Collection of Address Format Field
  • usedFields
    The fields that are used in the address format.
    Collection of Address Format Field

4.9.2Address Format Field

Fields
  • GIVEN_NAME
    Given Name
  • FAMILY_NAME
    Family Name
  • ORGANIZATION_NAME
    Organization Name
  • STREET
    Street
  • DEPENDENT_LOCALITY
    Dependent Locality
  • CITY
    City
  • POSTAL_STATE
    Postal State
  • POST_CODE
    Post Code
  • SORTING_CODE
    Sorting Code
  • COUNTRY
    Country

4.9.3Country Details

Properties
  • addressFormat
    Specifies the country's way of formatting addresses.
  • isoCode2
    The country's two-letter code (ISO 3166-1 alpha-2 format).
    String
  • isoCode3
    The country's three-letter code (ISO 3166-1 alpha-3 format).
    String
  • name
    The name of the country.
    String
  • numericCode
    The country's three-digit code (ISO 3166-1 numeric format).
    String
  • stateCodes
    The codes of all regions (e.g. states, provinces) of the country (ISO 3166-2 format).
    Collection of String

4.9.4Currency Details

Properties
  • currencyCode
    The currency's three-letter code (ISO 4217 format).
    String
  • fractionDigits
    The currency's number of decimals. When calculating amounts in this currency, the fraction digits determine the accuracy.
    Integer
  • name
    The name of the currency.
    String
  • numericCode
    The currency's three-digit code (ISO 4217 format).
    Integer

4.9.5Language Details

Properties
  • countryCode
    The two-letter code of the language's region (ISO 3166-1 alpha-2 format).
    String
  • ietfCode
    The language's IETF tag consisting of the two-letter ISO code and region e.g. en-US, de-CH.
    String
  • iso2Code
    The language's two-letter code (ISO 639-1 format).
    String
  • iso3Code
    The language's three-letter code (ISO 639-2/T format).
    String
  • name
    The name of the language.
    String
  • pluralExpression
    The expression to determine the plural index for a given number of items used to find the proper plural form for translations.
    String
  • primaryOfGroup
    Whether this is the primary language in a group of languages.
    Boolean

4.9.6Legal Organization Form Details

Properties
  • country
    The two-letter code of the country the legal organization form is used in (ISO 3166-1 alpha-2 format).
    String
  • description
    The localized descriptions of the legal organization form.
    Collection of Localized String
  • englishDescription
    The English name of the legal organization form.
    String
  • id
    A unique identifier for the object.
    Long
  • shortcut
    The localized shortcuts of the legal organization form.
    Collection of Localized String

4.9.7Localized String Details

Properties
  • language
    The term's language.
    String
  • string
    The localized term.
    String

4.9.8Persistable Currency Amount Details

Properties
  • amount
    Decimal
  • currency
    String

4.9.9State Details

Properties
  • code
    The state's code used within addresses.
    String
  • country
    String
  • countryCode
    The two-letter code of the state's country (ISO 3166-1 alpha-2 format).
    String
  • id
    The state's code in ISO 3166-2 format.
    String
  • name
    The name of the state.
    String

4.10Label

4.10.1Label Details

Properties
  • content
    Object
  • contentAsString
    String
  • descriptor
  • id
    A unique identifier for the object.
    Long
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.10.2Label Descriptor Details

Properties
  • category
    The label's category.
  • description
    The localized description of the object.
    Map of String String
  • features
    The features that this label belongs to.
    Collection of Long
  • group
    The group that this label belongs to.
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String
  • type
    The type of the label's value.
  • weight
    When listing labels, they can be sorted by this number.
    Integer

4.10.3Label Descriptor Category

Fields
  • HUMAN
    Human
  • APPLICATION
    Application

4.10.4Label Descriptor Group Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String
  • weight
    When listing label groups, they can be sorted by this number.
    Integer

4.10.5Label Descriptor Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.10.6Static Value Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • features
    Collection of Long
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.11Manual Task

4.11.1Manual Task Details

A manual task requires the manual intervention of a human.

Properties
  • actions
    The actions that can be triggered to handle the manual task.
    Collection of Long
  • contextEntityId
    The ID of the entity the manual task is linked to.
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • expiresOn
    The date and time until when the manual task has to be handled.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • type
    The manual task's type.

4.11.2Manual Task Action Details

Properties
  • id
    A unique identifier for the object.
    Long
  • label
    The action's label.
    Map of String String
  • style
    The action's style.
  • taskType
    The type of manual tasks this action belongs to.

4.11.3Manual Task Action Style

Fields
  • DEFAULT
    Default
  • PRIMARY
    Primary
  • DANGER
    Danger

4.11.4Manual Task State

Fields
  • OPEN
    Open
  • DONE
    Done
  • EXPIRED
    Expired

4.11.5Manual Task Type Details

The manual task type indicates what kind of manual task is required to be executed by the human.

Properties
  • description
    The localized description of the object.
    Map of String String
  • features
    The features that this type belongs to.
    Collection of Long
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.12Payment

4.12.1Address Handling Mode

The address handling mode controls if the address is required and how it is enforced to be provided.

Fields
  • NOT_REQUIRED
    Not Required
  • REQUIRED_IN_URL
    Required In Url
  • REQUIRED_ON_PAYMENT_PAGE
    Required On Payment Page

4.12.2Authenticated Card Data Details

This model holds the card data and optional cardholder authentication details.

Properties
  • cardHolderName
    ≤ 100 chars
    The card holder name is the name printed onto the card. It identifies the person who owns the card.
    String
  • cardVerificationCode
    3 - 4 chars
    ([0-9 ]+)
    The card verification code (CVC) is a 3 to 4 digit code typically printed on the back of the card. It helps to ensure that the card holder is authorizing the transaction. For card not-present transactions this field is optional.
    String
  • cardholderAuthentication
    The cardholder authentication information. The authentication is optional and can be provided if the cardholder has been already authenticated (e.g. in 3-D Secure system).
  • cryptogram
    The additional authentication value used to secure the tokenized card transactions.
  • expiryDate
    ([0-9]{4})\-(11|12|10|0[1-9]{1})
    The card expiry date indicates when the card expires. The format is the format yyyy-mm where yyyy is the year (e.g. 2019) and the mm is the month (e.g. 09).
    String
  • primaryAccountNumber
    *
    10 - 30 chars
    ([0-9 ]+)
    The primary account number (PAN) identifies the card. The number is numeric and typically printed on the front of the card.
    String
  • recurringIndicator
  • schemeTransactionReference
    ≤ 100 chars
    String
  • tokenRequestorId
    String

4.12.3Authenticated Card Data Details

This model holds the card data and optional cardholder authentication details.

Properties
  • cardHolderName
    ≤ 100 chars
    The card holder name is the name printed onto the card. It identifies the person who owns the card.
    String
  • cardVerificationCode
    3 - 4 chars
    ([0-9 ]+)
    The card verification code (CVC) is a 3 to 4 digit code typically printed on the back of the card. It helps to ensure that the card holder is authorizing the transaction. For card not-present transactions this field is optional.
    String
  • cardholderAuthentication
    The cardholder authentication information. The authentication is optional and can be provided if the cardholder has been already authenticated (e.g. in 3-D Secure system).
  • cryptogram
    The additional authentication value used to secure the tokenized card transactions.
  • expiryDate
    ([0-9]{4})\-(11|12|10|0[1-9]{1})
    The card expiry date indicates when the card expires. The format is the format yyyy-mm where yyyy is the year (e.g. 2019) and the mm is the month (e.g. 09).
    String
  • primaryAccountNumber
    10 - 30 chars
    ([0-9 ]+)
    The primary account number (PAN) identifies the card. The number is numeric and typically printed on the front of the card.
    String
  • recurringIndicator
  • schemeTransactionReference
    ≤ 100 chars
    String
  • tokenRequestorId
    String

4.12.4Bank Account Details

Properties
  • description
    ≤ 100 chars
    The optional description is shown along the identifier. The intention of the description is to give an alternative name to the bank account.
    String
  • id
    A unique identifier for the object.
    Long
  • identifier
    ≤ 100 chars
    The bank account identifier is responsible to uniquely identify the bank account.
    String
  • linkedSpaceId
    The ID of the space this object belongs to.
    Long
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • type
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.5Bank Account Environment

Fields
  • PRODUCTION
    Production
  • TEST
    Test

4.12.6Bank Account State

Fields
  • CREATE
    Create
  • ACTIVE
    Active
  • DELETING
    Deleting
  • DELETED
    Deleted

4.12.7Bank Account Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • identifierName
    Map of String String
  • name
    The localized name of the object.
    Map of String String

4.12.8Bank Transaction Details

Properties
  • adjustments
    The adjustments applied on this bank transaction.
    Collection of Payment Adjustment
  • createdBy
    The created by indicates the user which has created the bank transaction.
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • currencyBankAccount
    The currency bank account which is used to handle money flow.
  • externalId
    1 - 100 chars
    String
  • flowDirection
    Virtual
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    The ID of the space this object belongs to.
    Long
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • postingAmount
    The posting amount indicates the amount including adjustments.
    Decimal
  • reference
    String
  • source
  • state
    The object's current state.
  • totalAdjustmentAmountIncludingTax
    Virtual
    Decimal
  • type
  • valueAmount
    Decimal
  • valueDate
    The value date describes the date the amount is effective on the account.
    DateTime
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.9Bank Transaction Flow Direction

Fields
  • INFLOW
    Inflow
  • OUTFLOW
    Outflow

4.12.10Bank Transaction Source Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.12.11Bank Transaction State

Fields
  • UPCOMING
    Upcoming
  • SETTLED
    Settled

4.12.12Bank Transaction Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.12.13Card Authentication Response

Fields
  • FULLY_AUTHENTICATED
    Fully Authenticated
  • AUTHENTICATION_NOT_REQUIRED
    Authentication Not Required
  • NOT_ENROLLED
    Not Enrolled
  • ENROLLMENT_ERROR
    Enrollment Error
  • AUTHENTICATION_ERROR
    Authentication Error

4.12.14Card Authentication Version

This model defines the card authentication versions.

Fields
  • V1
    V1
  • V2
    V2

4.12.15Card Cryptogram Details

This model holds the additional card authentication.

Properties

4.12.16Card Cryptogram Details

This model holds the additional card authentication.

Properties

4.12.17Card Cryptogram Type

This model defines the card cryptogram types.

Fields
  • SCHEME_TOKEN
    Scheme Token

4.12.18Cardholder Authentication Details

This model holds the cardholder authentication data (e.g. 3-D Secure authentication).

Properties
  • authenticationIdentifier
    The authentication identifier as assigned by authentication system (e.g. XID or DSTransactionID).
    String
  • authenticationResponse
    *
  • authenticationValue
    The cardholder authentication value. Also known as Cardholder Authentication Verification Value (CAVV).
    String
  • electronicCommerceIndicator
    The Electronic Commerce Indicator (ECI) value. The ECI is returned by authentication system and indicates the outcome/status of authentication.
    String

4.12.19Cardholder Authentication Details

This model holds the cardholder authentication data (e.g. 3-D Secure authentication).

Properties
  • authenticationIdentifier
    The authentication identifier as assigned by authentication system (e.g. XID or DSTransactionID).
    String
  • authenticationResponse
  • authenticationValue
    The cardholder authentication value. Also known as Cardholder Authentication Verification Value (CAVV).
    String
  • electronicCommerceIndicator
    The Electronic Commerce Indicator (ECI) value. The ECI is returned by authentication system and indicates the outcome/status of authentication.
    String
  • version

4.12.20Charge Details

Properties
  • createdOn
    The date on which the charge was created on.
    DateTime
  • failureReason
  • id
    A unique identifier for the object.
    Long
  • language
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • spaceViewId
  • state
    The object's current state.
  • timeZone
    String
  • timeoutOn
    DateTime
  • transaction
  • type
  • userFailureMessage
    The failure message describes for an end user why the charge is failed in the language of the user. This is only provided when the charge is marked as failed.
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.21Charge Attempt Details

Properties
  • charge
  • completionBehavior
  • connectorConfiguration
  • createdOn
    The date and time when the object was created.
    DateTime
  • customersPresence
    The customers presence indicates which kind of customer interaction was used during the charge attempt.
  • environment
  • failedOn
    DateTime
  • failureReason
  • id
    A unique identifier for the object.
    Long
  • initializingTokenVersion
    Boolean
  • invocation
  • labels
    Collection of Label
  • language
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • nextUpdateOn
    DateTime
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • redirectionUrl
    String
  • salesChannel
  • spaceViewId
  • state
    The object's current state.
  • succeededOn
    DateTime
  • terminal
  • timeZone
    String
  • timeoutOn
    DateTime
  • tokenVersion
  • userFailureMessage
    ≤ 2,000 chars
    The user failure message contains the message for the user in case the attempt failed. The message is localized into the language specified on the transaction.
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer
  • wallet

4.12.22Charge Attempt Environment

Fields
  • PRODUCTION
    Production
  • TEST
    Test

4.12.23Charge Attempt State

Fields
  • PROCESSING
    Processing
  • FAILED
    Failed
  • SUCCESSFUL
    Successful

4.12.24Charge Bank Transaction Details

Properties
  • bankTransaction
  • completion
  • id
    A unique identifier for the object.
    Long
  • language
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • spaceViewId
  • transaction
  • transactionCurrencyAmount
    Specify the posting amount in the transaction's currency.
    Decimal
  • transactionCurrencyValueAmount
    Virtual
    Decimal
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.25Charge Flow Details

Properties
  • conditions
    If a transaction meets all selected conditions, the charge flow will be used to process the transaction. If the conditions are not met the next charge flow in line will be chosen according to the priorities.
    Collection of Long
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    The charge flow name is used internally to identify the configuration in administrative interfaces. For example it is used within search fields and hence it should be distinct and descriptive.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • priority
    The priority orders the charge flows. As such the priority determines together with the conditions the charge flow the selection mechanism for a particular transaction. A change of the priority affects all future selections.
    Integer
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.26Charge Flow Level Details

Properties
  • asynchronousCharge
  • configuration
  • createdOn
    The date and time when the object was created.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • synchronousCharge
  • timeoutOn
    DateTime
  • tokenCharge
  • transaction
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.27Charge Flow Level Configuration Details

Properties
  • flow
    The charge flow level configuration to which the flow is associated.
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The charge flow level configuration name is used internally to identify the charge flow level configuration. For example the name is used within search fields and hence it should be distinct and descriptive.
    String
  • period
    The duration of the level before switching to the next one.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • priority
    The priority indicates the sort order of the level configurations. A low value indicates that the level configuration is executed before any level with a higher value. Any change to this value affects future level configuration selections.
    Integer
  • state
    The object's current state.
  • type
    The type determines how the payment link is delivered to the customer. Once the type is defined it cannot be changed anymore.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.28Charge Flow Level Configuration Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • label
    Map of String String
  • name
    The localized name of the object.
    Map of String String

4.12.29Charge Flow Level Payment Link Details

Properties
  • chargeFlowLevel
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • paymentLink
    Virtual
    String

4.12.30Charge Flow Level State

Fields
  • PENDING
    Pending
  • FAILED
    Failed
  • SUCCESSFUL
    Successful

4.12.31Charge State

Fields
  • PENDING
    Pending
  • FAILED
    Failed
  • SUCCESSFUL
    Successful

4.12.32Charge Type

Fields
  • ASYNCHRONOUS
    Asynchronous
  • SYNCHRONOUS
    Synchronous
  • TOKEN
    Token
  • TERMINAL
    Terminal

4.12.33Completion Line Item Details

Properties
  • amount
    The total amount of the line item including any tax.
    Decimal
  • quantity
    Positive
    The quantity of the line item which should be completed.
    Decimal
  • uniqueId
    ≤ 200 chars
    The unique id identifies the line item on which the capture is applied on.
    String

4.12.34Condition Details

A condition configuration controls under which condition a payment connector is applied to a transaction.

Properties
  • conditionType
    The selected condition type defines how the configuration is applied to the transactions.
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The condition name is used internally to identify the condition. For example the name is used within search fields and hence it should be distinct and descriptive.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.35Condition Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.12.36Connector Configuration Details

Properties
  • applicableForTransactionProcessing
    Virtual
    This property indicates if the connector is currently used for processing transactions. In case either the payment method configuration or the processor configuration is not active the connector will not be used even though the connector state is active.
    Boolean
  • conditions
    If a transaction meet all selected conditions the connector configuration will be used to process the transaction otherwise the next connector configuration in line will be chosen according to the priorities.
    Collection of Long
  • connector
  • enabledSalesChannels
    Defines the sales channels the connector configuration is enabled for. In case the set is empty, the connector configuration is enabled for all sales channels.
    Collection of Sales Channel
  • enabledSpaceViews
    The connector configuration is only enabled for the selected space views. In case the set is empty the connector configuration is enabled for all space views.
    Collection of Long
  • id
    A unique identifier for the object.
    Long
  • imagePath
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The connector configuration name is used internally to identify the configuration in administrative interfaces. For example it is used within search fields and hence it should be distinct and descriptive.
    String
  • paymentMethodConfiguration
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • priority
    The priority will define the order of choice of the connector configurations. The lower the value, the higher the priority is going to be. This value can also be a negative number in case you are adding a new configuration that you want to have a high priority and you dont want to change the priority of all the other configurations.
    Integer
  • processorConfiguration
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.37Connector Invocation Details

Properties
  • createdOn
    The date and time when the object was created.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • stage
  • timeTookInMilliseconds
    Long
  • transaction
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.38Connector Invocation Stage

Fields
  • PAYMENT_METHOD_LIST
    Payment Method List
  • FORM_GENERATION
    Form Generation
  • VALIDATION
    Validation
  • AUTHORIZATION
    Authorization

4.12.39Currency Bank Account Details

Properties
  • bankAccount
  • currency
    String
  • environment
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    The ID of the space this object belongs to.
    Long
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.40Customers Presence

Fields
  • NOT_PRESENT
    Not Present
  • VIRTUAL_PRESENT
    Virtual Present
  • PHYSICAL_PRESENT
    Physical Present

4.12.41Data Collection Type

Fields
  • ONSITE
    Onsite
  • OFFSITE
    Offsite

4.12.42Delivery Indication Details

Properties
  • automaticDecisionReason
  • automaticallyDecidedOn
    DateTime
  • completion
  • createdOn
    The date and time when the object was created.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • manualDecisionTimeoutOn
    DateTime
  • manuallyDecidedBy
    Long
  • manuallyDecidedOn
    DateTime
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • timeoutOn
    DateTime
  • transaction

4.12.43Delivery Indication Decision Reason Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.12.44Delivery Indication State

Fields
  • PENDING
    Pending
  • NOT_SUITABLE
    Not Suitable
  • MANUAL_CHECK_REQUIRED
    Manual Check Required
  • SUITABLE
    Suitable

4.12.45External Transfer Bank Transaction Details

Properties
  • bankTransaction
  • externalAccountIdentifier
    String
  • externalAccountType
    String
  • externalBankName
    String
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    The ID of the space this object belongs to.
    Long
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.46Final Balance Transaction Sums Details

Properties
  • brand
    String
  • dccTipAmount
    Decimal
  • dccTransactionAmount
    Decimal
  • dccTransactionCount
    Integer
  • id
    A unique identifier for the object.
    Long
  • product
    String
  • transactionAmount
    Decimal
  • transactionCount
    Integer
  • transactionCurrency
    String
  • transactionTipAmount
    Decimal
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.47Internal Transfer Bank Transaction Details

Properties
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    The ID of the space this object belongs to.
    Long
  • sourceBankTransaction
  • targetBankTransaction
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.48Invoice Reconciliation Record Details

Properties

4.12.49Invoice Reconciliation Record Details

Properties
  • address
    String
  • amount
    Decimal
  • city
    String
  • country
    String
  • createdOn
    The date and time when the object was created.
    DateTime
  • currency
    String
  • discardedBy
    Long
  • discardedOn
    The discarded on date indicates when the bank transaction has been discarded.
    DateTime
  • environment
  • familyName
    String
  • givenName
    String
  • iban
    ≤ 100 chars
    String
  • id
    A unique identifier for the object.
    Long
  • lastResolutionFailure
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • participantNumber
    ≤ 100 chars
    String
  • paymentFeeAmount
    Decimal
  • paymentFeeCurrency
    String
  • paymentReason
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • postCode
    String
  • referenceNumber
    ≤ 255 chars
    String
  • rejectionStatus
  • resolvedBy
    Long
  • resolvedOn
    The resolved on date indicates when the bank transaction has been resolved.
    DateTime
  • senderBankAccount
    String
  • state
    The object's current state.
  • street
    String
  • type
  • uniqueId
    ≤ 500 chars
    String
  • valueDate
    DateTime
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.50Invoice Reconciliation Record Rejection Status

Fields
  • NONE
    None
  • REJECTED
    Rejected
  • BULK_REJECTED
    Bulk Rejected

4.12.51Invoice Reconciliation Record State

Fields
  • CREATE
    Create
  • PENDING
    Pending
  • UNRESOLVED
    Unresolved
  • RESOLVED
    Resolved
  • DISCARDED
    Discarded

4.12.52Invoice Reconciliation Record Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.12.53Invoice Reimbursement Details

Properties
  • amount
    Decimal
  • createdOn
    The date and time when the object was created.
    DateTime
  • currency
    String
  • discardedBy
    Long
  • discardedOn
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    The ID of the space this object belongs to.
    Long
  • paymentConnectorConfiguration
  • paymentInitiationAdviceFile
  • processedBy
    Long
  • processedOn
    DateTime
  • recipientCity
    String
  • recipientCountry
    String
  • recipientFamilyName
    String
  • recipientGivenName
    String
  • recipientIban
    String
  • recipientPostcode
    String
  • recipientStreet
    String
  • senderIban
    String
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.54Invoice Reimbursement Details

Properties
  • amount
    Decimal
  • createdOn
    The date and time when the object was created.
    DateTime
  • currency
    String
  • discardedBy
    Long
  • discardedOn
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    The ID of the space this object belongs to.
    Long
  • paymentConnectorConfiguration
  • paymentInitiationAdviceFile
  • processedBy
    Long
  • processedOn
    DateTime
  • recipientCity
    String
  • recipientCountry
    String
  • recipientFamilyName
    String
  • recipientGivenName
    String
  • recipientIban
    String
  • recipientPostcode
    String
  • recipientStreet
    String
  • refundMerchantReference
    String
  • senderIban
    String
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.55Invoice Reimbursement State

Fields
  • PENDING
    Pending
  • MANUAL_REVIEW
    Manual Review
  • PROCESSING
    Processing
  • PROCESSED
    Processed
  • DISCARDED
    Discarded

4.12.56One Click Payment Mode

Fields
  • DISABLED
    Disabled
  • ALLOW
    Allow
  • FORCE
    Force

4.12.57Payment Adjustment Details

Properties
  • amountExcludingTax
    Virtual
    Decimal
  • amountIncludingTax
    The total amount of this adjustment including taxes.
    Decimal
  • rateInPercentage
    ≤ 100
    The rate in percentage is the rate on which the adjustment amount was calculated with.
    Decimal
  • tax
  • type

4.12.58Payment Adjustment Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.12.59Payment App Charge Attempt Target State

The target state indicates the state that should be set on the charge attempt.

Fields
  • SUCCESSFUL
    Successful
  • FAILED
    Failed

4.12.60Payment App Charge Attempt Update Request Details

The charge attempt update request allows to change the state of a charge attempt. The charge attempt must be linked with a processor that was created by the payment Web App that invokes the operation.

Properties
  • chargeAttemptId
    This is the ID of the charge attempt that should be updated.
  • endUserFailureMessage
    ≤ 2,000 chars
    The end user failure message indicates to the end user (buyer) why the payment failed. The message has to be in the language of the end user. The language is provided within the payment page invocation URL.
    String
  • failureReasonId
    The failure reason indicates why the charge attempt failed. It is required when the target state is FAILED.
  • reference
    ≤ 100 chars
    The reference identifies the charge attempt within the systems of the external service provider. It is required when the target state is SUCCESSFUL.
    String
  • targetState
    The target state defines the state into which the charge attempt should be switched into. Once the charge attempt changed the state it will not be possible to change it again.

4.12.61Payment App Completion Configuration Details

Properties
  • completionEndpoint
    URL
    The completion endpoint is invoked to request the payment service provider to execute a completion.
    String
  • completionTimeoutInMinutes
    When the completion or the void is triggered we expect a feedback about the state of it. This timeout defines after how long we consider the void resp. completion as failed without receiving a final state update.
    Integer
  • maximalCompletionDelayInDays
    The completion resp. the void can be triggered a while after the authorization of the transaction has been executed. This delay defines how many days after the authorization the void resp. completion must be triggered at the latest.
    Integer
  • multipleCompletionsSupported
    This flag indicates whether the connector supports multiple completions for a single transaction or not.
    Boolean
  • voidEndpoint
    URL
    The void endpoint is invoked to request the payment service provider to execute a void.
    String

4.12.62Payment App Completion Target State

The target state indicates the state that should be set on the completion.

Fields
  • SUCCESSFUL
    Successful
  • FAILED
    Failed

4.12.63Payment App Completion Update Request Details

The completion update request allows to change the state of a completion. The completion must be linked with a processor that was created by the payment Web App that invokes the operation.

Properties
  • completionId
    This is the ID of the completion that should be updated.
  • failureReasonId
    The failure reason indicates why the completion failed. It is required when the target state is FAILED.
  • reference
    ≤ 100 chars
    The reference identifies the completion within the systems of the external service provider. It is required when the target state is SUCCESSFUL.
    String
  • targetState
    The target state defines the state into which the completion should be switched into. Once the completion changed the state it will not be possible to change it again.

4.12.64Payment App Connector Details

Properties
  • authorizationTimeout
    String
  • completionConfiguration
    The completion configuration defines how the deferred completion is processed. If it is not present it means that deferred completion is not supported by this connector.
  • connectorConfiguration
    The connector configuration references the configuration that was created as part of this connector within the space. The connector configuration is referenced within transactions created with this connector.
  • createdOn
    The created on date indicates when the connector was added.
    DateTime
  • externalId
    ≤ 40 chars
    The external ID corresponds to the ID provided during inserting of the processor.
    String
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The name of the connector will be displayed within the user interfaces that the merchant is interacting with.
    String
  • paymentPageEndpoint
    The payment page endpoint is invoked to process the transaction. The endpoint is defined by the external service provider.
    String
  • processor
    The processor references the app processor to which this connector belongs to. The relationship is established during the creation of the connector.
  • refundConfiguration
    The refund configuration defines how refunds are processed. If it is not present it means that refunds are not supported by this connector.
  • state
    The object's current state.
  • updatedOn
    The updated on date indicates when the last time the connector was updated on.
    DateTime
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.65Payment App Connector Creation Request Details

Properties
  • authorizationTimeoutInMinutes
    *
    When the transaction is not authorized within this timeout the transaction is considered as failed.
    Integer
  • completionConfiguration
    The completion configuration allows the connector to support deferred completions on a transaction. If it is not provided the connector will not process transactions in deferred mode.
  • connector
    *
    The ID of the connector identifies which connector that should be linked with this web app connector. The connector defines the payment method.
  • externalId
    *
    1 - 40 chars
    The external ID identifies the connector within the external system. It has to be unique per processor external ID and for any subsequent update the same ID must be sent.
    String
  • name
    *
    ≤ 100 chars
    The name of the connector will be displayed within the user interfaces that the merchant is interacting with.
    String
  • paymentPageEndpoint
    *
    URL
    The payment page endpoint URL will be invoked by the buyer to carry out the authorization of the payment.
    String
  • processorExternalId
    *
    1 - 40 chars
    The external ID of the processor identifies the processor to which this connector belongs to. The processor cannot be changed once it has been set on a connector.
    String
  • refundConfiguration
    The refund configuration allows the connector to support refunds on transactions. In case no refund configuration is provided the connector will not support refunds.

4.12.66Payment App Connector State

Fields
  • ACTIVE
    Active
  • DELETED
    Deleted

4.12.67Payment App Processor Details

Properties
  • configuredEnvironment
  • createdOn
    The created on date is the date when this processor has been added.
    DateTime
  • documentationUrl
    The documentation URL points to a web site that describes how to configure and use the processor.
    String
  • externalId
    ≤ 40 chars
    The external ID corresponds to the ID that was provided during creation of the processor.
    String
  • id
    A unique identifier for the object.
    Long
  • installationId
    The installation ID identifies the Web App installation.
    Long
  • linkedSpaceId
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The name of the processor will be displayed within the user interfaces that the merchant is interacting with.
    String
  • processorConfiguration
    This processor configuration is created as part of the app processor. Any transaction created with the processor is linked with this processor configuration.
  • productionModeUrl
    When the user sets the processor into the production mode the user will be forwarded to this URL to configure the production environment. When no URL is provided no redirection will happen.
    String
  • state
    The object's current state.
  • svgIcon
    ≤ 10,000 chars
    String
  • updatedOn
    The updated on date indicates when the last update on the processor occurred.
    DateTime
  • usableInProduction
    When the processor is ready to be used for transactions in the production environment this flag is set to true.
    Boolean
  • usableInProductionSince
    DateTime
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.68Payment App Processor Creation Request Details

Properties
  • documentationUrl
    *
    URL
    The documentation URL has to point to a description of how to configure and use the processor.
    String
  • externalId
    *
    1 - 40 chars
    The external ID identifies the processor within the external system. It has to be unique per space and for any subsequent update the same ID must be sent.
    String
  • name
    *
    ≤ 100 chars
    The name of the processor will be displayed within the user interfaces that the merchant is interacting with.
    String
  • productionModeUrl
    URL
    The production mode URL has to point to a site on which the merchant can set up the production mode for the processor.
    String
  • svgIcon
    *
    ≤ 10,000 chars
    The SVG icon will be displayed to the user to represent this processor.
    String

4.12.69Payment App Processor State

Fields
  • ACTIVE
    Active
  • DELETED
    Deleted

4.12.70Payment App Refund Configuration Details

Properties
  • multipleRefundsSupported
    This flag indicates whether the connector supports multiple refunds for a single transaction or not.
    Boolean
  • refundEndpoint
    URL
    The refund endpoint is invoked to request the payment service provider to execute a refund.
    String
  • refundTimeoutInMinutes
    When the refund is triggered we expect a feedback about the state of it. This timeout defines after how long we consider the refund as failed without receiving a final state update.
    Integer

4.12.71Payment App Refund Target State

The target state indicates the state that should be set on the refund.

Fields
  • SUCCESSFUL
    Successful
  • FAILED
    Failed

4.12.72Payment App Refund Update Request Details

The refund update request allows to change the state of a refund. The refund must be linked with a processor that was created by the payment Web App that invokes the operation.

Properties
  • failureReasonId
    The failure reason indicates why the refund failed. It is required when the target state is FAILED.
  • reference
    ≤ 100 chars
    The reference identifies the refund within the systems of the external service provider. It is required when the target state is SUCCESSFUL.
    String
  • refundId
    This is the ID of the refund that should be updated.
  • targetState
    The target state defines the state into which the refund should be switched into. Once the refund changed the state it will not be possible to change it again.

4.12.73Payment App Void Target State

The target state indicates the state that should be set on the void.

Fields
  • SUCCESSFUL
    Successful
  • FAILED
    Failed

4.12.74Payment App Void Update Request Details

The void update request allows to change the state of a void. The void must be linked with a processor that was created by the payment Web App that invokes the operation.

Properties
  • failureReasonId
    The failure reason indicates why the void failed. It is required when the target state is FAILED.
  • reference
    ≤ 100 chars
    The reference identifies the void within the systems of the external service provider. It is required when the target state is SUCCESSFUL.
    String
  • targetState
    The target state defines the state into which the void should be switched into. Once the void changed the state it will not be possible to change it again.
  • voidId
    This is the ID of the void that should be updated.

4.12.75Payment Connector Details

Properties

4.12.76Payment Connector Feature Details

Properties
  • displayName
    String
  • feature
  • id
    A unique identifier for the object.
    Long

4.12.77Payment Contract Details

Properties
  • account
  • activatedOn
    DateTime
  • contractIdentifier
    String
  • contractType
  • createdBy
  • createdOn
    The date and time when the object was created.
    DateTime
  • externalId
    A client generated nonce which identifies the entity to be created. Subsequent creation requests with the same external ID will not create new entities but return the initially created entity instead.
    String
  • id
    A unique identifier for the object.
    Long
  • lastModifiedDate
    The date and time when the object was last modified.
    DateTime
  • rejectedOn
    DateTime
  • rejectionReason
  • startTerminatingOn
    DateTime
  • state
    The object's current state.
  • terminatedBy
  • terminatedOn
    DateTime
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.78Payment Contract State

Fields
  • PENDING
    Pending
  • ACTIVE
    Active
  • TERMINATING
    Terminating
  • TERMINATED
    Terminated
  • REJECTED
    Rejected

4.12.79Payment Contract Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • feature
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.12.80Payment Information Hash Details

A payment information hash is calculated based on the information entered by the user. The same input leads to the same hash. The hash is collision free.

Properties

4.12.81Payment Information Hash Type Details

Properties
  • id
    A unique identifier for the object.
    Long
  • name
    Map of String String

4.12.82Payment Initiation Advice File Details

Properties
  • createdOn
    The created on date indicates the date on which the entity was stored into the database.
    DateTime
  • failureMessage
    String
  • fileGeneratedOn
    DateTime
  • forwardedOn
    The shipping date indicates the date on which the pain file was transferred to an external processing system.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    The ID of the space this object belongs to.
    Long
  • name
    String
  • processedOn
    DateTime
  • processor
  • state
    The object's current state.

4.12.83Payment Initiation Advice File State

Fields
  • CREATING
    Creating
  • FAILED
    Failed
  • CREATED
    Created
  • OVERDUE
    Overdue
  • UPLOADED
    Uploaded
  • DOWNLOADED
    Downloaded
  • PROCESSED
    Processed

4.12.84Payment Link Details

The payment link defines an URL to automatically create transactions.

Properties
  • allowedPaymentMethodConfigurations
    The allowed payment method configurations restrict the payment methods which can be used with this payment link.
  • appliedSpaceView
    The payment link can be conducted in a specific space view. The space view may apply a specific design to the payment page.
    Long
  • availableFrom
    The available from date defines the earliest date on which the payment link can be used. When no date is specified there will be no restriction.
    DateTime
  • availableUntil
    The available from date defines the latest date on which the payment link can be used to initialize a transaction. When no date is specified there will be no restriction.
    DateTime
  • billingAddressHandlingMode
    The billing address handling mode controls if the address is collected or not and how it is collected.
  • currency
    The currency defines in which currency the payment is executed in. If no currency is defined it has to be specified within the request parameter 'currency'.
    String
  • externalId
    A client generated nonce which identifies the entity to be created. Subsequent creation requests with the same external ID will not create new entities but return the initially created entity instead.
    String
  • id
    A unique identifier for the object.
    Long
  • language
    The language defines the language of the payment page. If no language is provided it can be provided through the request parameter.
    String
  • lineItems
    The line items allows to define the line items for this payment link. When the line items are defined they cannot be overridden through the request parameters. If no amount for the payment link is defined, the additional checkout page to enter the amount is shown to the consumer.
    Collection of Line Item
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • maximalNumberOfTransactions
    The maximal number of transactions limits the number of transactions which can be created with this payment link.
    Integer
  • name
    ≤ 100 chars
    The payment link name is used internally to identify the payment link. For example the name is used within search fields and hence it should be distinct and descriptive.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • protectionMode
    The protection mode determines if the payment link is protected against tampering and in what way.
  • shippingAddressHandlingMode
    The shipping address handling mode controls if the address is collected or not and how it is collected.
  • state
    The object's current state.
  • url
    Virtual
    The URL defines the URL to which the user has to be forwarded to initialize the payment.
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.85Payment Link Protection Mode

Fields
  • NO_PROTECTION
    No Protection
  • ACCESS_KEY
    Access Key

4.12.86Payment Method Details

Properties
  • dataCollectionTypes
    Collection of Data Collection Type
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • imagePath
    String
  • merchantDescription
    Map of String String
  • name
    The localized name of the object.
    Map of String String
  • supportedCurrencies
    Collection of String

4.12.87Payment Method Brand Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • grayImagePath
    String
  • id
    A unique identifier for the object.
    Long
  • imagePath
    String
  • name
    The localized name of the object.
    Map of String String
  • paymentMethod

4.12.88Payment Method Configuration Details

The payment method configuration builds the base to connect with different payment method connectors.

Properties
  • dataCollectionType
    The data collection type determines who is collecting the payment information. This can be done either by the processor (offsite) or by our application (onsite).
  • description
    The payment method configuration description can be used to show a text during the payment process. Choose an appropriate description as it will be displayed to your customer.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • imageResourcePath
    The image of the payment method configuration overrides the default image of the payment method.
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The payment method configuration name is used internally to identify the payment method configuration. For example the name is used within search fields and hence it should be distinct and descriptive.
    String
  • oneClickPaymentMode
    When the buyer is present on the payment page or within the iFrame the payment details can be stored automatically. The buyer will be able to use the stored payment details for subsequent transactions. When the transaction already contains a token one-click payments are disabled anyway
  • paymentMethod
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • resolvedDescription
    Virtual
    The resolved description uses the specified description or the default one when it is not overridden.
    Map of String String
  • resolvedImageUrl
    Virtual
    The resolved URL of the image to use with this payment method.
    String
  • resolvedTitle
    Virtual
    The resolved title uses the specified title or the default one when it is not overridden.
    Map of String String
  • sortOrder
    The sort order of the payment method determines the ordering of the methods shown to the user during the payment process.
    Integer
  • spaceId
    ≥ 1
    Long
  • state
    The object's current state.
  • title
    The title of the payment method configuration is used within the payment process. The title is visible to the customer.
    Map of String String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.89Payment Processor Details

Properties
  • companyName
    Map of String String
  • description
    The localized description of the object.
    Map of String String
  • feature
  • headquartersLocation
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • logoPath
    String
  • name
    The localized name of the object.
    Map of String String
  • productName
    Map of String String

4.12.90Payment Terminal Details

Properties
  • configurationVersion
  • defaultCurrency
    Virtual
    String
  • deviceSerialNumber
    String
  • externalId
    A client generated nonce which identifies the entity to be created. Subsequent creation requests with the same external ID will not create new entities but return the initially created entity instead.
    String
  • id
    A unique identifier for the object.
    Long
  • identifier
    The identifier uniquely identifies the terminal. Normally it is visible on the device or in the display of the device.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • locationVersion
  • name
    ≤ 100 chars
    The terminal name is used internally to identify the terminal in administrative interfaces. For example it is used within search fields and hence it should be distinct and descriptive.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • type
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.91Payment Terminal Address Details

Properties
  • city
    The city, town or village.
    String
  • country
    The two-letter country code (ISO 3166 format).
    String
  • dependentLocality
    ≤ 100 chars
    The dependent locality which is a sub-division of the state.
    String
  • emailAddress
    Email
    ≤ 254 chars
    The email address.
    String
  • familyName
    The family or last name.
    String
  • givenName
    The given or first name.
    String
  • mobilePhoneNumber
    ≤ 100 chars
    The phone number of a mobile phone.
    String
  • organizationName
    The organization's name.
    String
  • phoneNumber
    The phone number.
    String
  • postalState
    The name of the region, typically a state, county, province or prefecture.
    String
  • postcode
    The postal code, also known as ZIP, postcode, etc.
    String
  • salutation
    ≤ 20 chars
    The salutation e.g. Mrs, Mr, Dr.
    String
  • sortingCode
    ≤ 100 chars
    The sorting code identifying the post office where the PO Box is located.
    String
  • street
    The street or PO Box.
    String

4.12.92Payment Terminal Configuration Details

Properties
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The terminal configuration name is used internally to identify the terminal in administrative interfaces. For example it is used within search fields and hence it should be distinct and descriptive.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • type
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.93Payment Terminal Configuration State

Fields
  • CREATE
    Create
  • ACTIVE
    Active
  • DELETING
    Deleting
  • DELETED
    Deleted

4.12.94Payment Terminal Configuration Version Details

Properties
  • configuration
  • connectorConfigurations
    Collection of Long
  • createdBy
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • defaultCurrency
    The currency is derived by default from the terminal location. By setting a specific currency the derived currency is overridden.
    String
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • maintenanceWindowDuration
    String
  • maintenanceWindowStart
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • timeZone
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer
  • versionAppliedImmediately
    Boolean

4.12.95Payment Terminal Configuration Version State

Fields
  • PENDING
    Pending
  • SCHEDULING
    Scheduling
  • ACTIVE
    Active
  • DELETING
    Deleting
  • DELETED
    Deleted

4.12.96Payment Terminal Location Details

Properties
  • externalId
    A client generated nonce which identifies the entity to be created. Subsequent creation requests with the same external ID will not create new entities but return the initially created entity instead.
    String
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The terminal location name is used internally to identify the terminal in administrative interfaces. For example it is used within search fields and hence it should be distinct and descriptive.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.97Payment Terminal Location State

Fields
  • CREATE
    Create
  • ACTIVE
    Active
  • DELETING
    Deleting
  • DELETED
    Deleted

4.12.98Payment Terminal Location Version Details

Properties
  • address
  • contactAddress
  • createdBy
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • location
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer
  • versionAppliedImmediately
    Boolean

4.12.99Payment Terminal Location Version State

Fields
  • PENDING
    Pending
  • SCHEDULING
    Scheduling
  • ACTIVE
    Active
  • DELETING
    Deleting
  • DELETED
    Deleted

4.12.100Payment Terminal Receipt Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.12.101Payment Terminal State

Fields
  • CREATE
    Create
  • PREPARING
    Preparing
  • ACTIVE
    Active
  • INACTIVE
    Inactive
  • DECOMMISSIONING
    Decommissioning
  • DECOMMISSIONED
    Decommissioned

4.12.102Payment Terminal Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.12.103Primary Risk Taker

The primary risk taker will have the main loss when one party of the contract does not fulfill the contractual duties.

Fields
  • CUSTOMER
    Customer
  • MERCHANT
    Merchant
  • THIRD_PARTY
    Third Party

4.12.104Processor Configuration Details

Properties
  • applicationManaged
    The configuration is managed by the application and cannot be changed via the user interface.
    Boolean
  • contractId
    The contract links the processor configuration with the contract that is used to process payments.
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The processor configuration name is used internally to identify a specific processor configuration. For example the name is used within search fields and hence it should be distinct and descriptive.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • processor
    A processor handles the connection to a third part company (a Payment Service Provider) that technically manages the transaction and therefore processes the payment. For the same processor multiple processor configuration can be setup.
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.105Receipt Format

Fields
  • PDF
    Pdf
  • TXT
    Txt

4.12.106Recurring Indicator

Fields
  • REGULAR_TRANSACTION
    Regular Transaction
  • INITIAL_RECURRING_TRANSACTION
    Initial Recurring Transaction
  • MERCHANT_INITIATED_RECURRING_TRANSACTION
    Merchant Initiated Recurring Transaction
  • CUSTOMER_INITIATED_RECURRING_TRANSACTION
    Customer Initiated Recurring Transaction

4.12.107Refund Details

The refund represents a credit back to the customer. It can be issued by the merchant or by the customer (reversal).

Properties
  • amount
    Decimal
  • baseLineItems
    Collection of Line Item
  • completion
  • createdBy
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • environment
  • externalId
    1 - 100 chars
    The external id helps to identify duplicate calls to the refund service. As such the external ID has to be unique per transaction.
    String
  • failedOn
    DateTime
  • failureReason
  • id
    A unique identifier for the object.
    Long
  • labels
    Collection of Label
  • language
    The language that is linked to the object.
    String
  • lineItems
    Virtual
    Collection of Line Item
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • merchantReference
    ≤ 100 chars
    String
  • nextUpdateOn
    DateTime
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • processingOn
    DateTime
  • processorReference
    ≤ 150 chars
    String
  • reducedLineItems
    Collection of Line Item
  • reductions
    Collection of Line Item Reduction
  • state
    The object's current state.
  • succeededOn
    DateTime
  • taxes
    Collection of Tax
  • timeZone
    String
  • timeoutOn
    DateTime
  • totalAppliedFees
    The total applied fees is the sum of all fees that have been applied so far.
    Decimal
  • totalSettledAmount
    The total settled amount is the total amount which has been settled so far.
    Decimal
  • transaction
  • type
  • updatedInvoice
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.108Refund Bank Transaction Details

Properties
  • bankTransaction
  • id
    A unique identifier for the object.
    Long
  • language
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • refund
  • refundCurrencyAmount
    Specify the posting amount in the refund's currency.
    Decimal
  • refundCurrencyValueAmount
    Virtual
    Decimal
  • spaceViewId
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.109Refund Comment Details

Properties
  • content
    ≤ 262,144 chars
    The comment's actual content.
    String
  • createdBy
    The ID of the user the comment was created by.
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • editedBy
    The ID of the user the comment was last updated by.
    Long
  • editedOn
    The date and time when the comment was last updated.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • pinned
    Whether the comment is pinned to the top.
    Boolean
  • refund
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.110Refund Recovery Bank Transaction Details

Properties
  • bankTransaction
  • id
    A unique identifier for the object.
    Long
  • language
    The language that is linked to the object.
    String
  • lineItems
    The line items contain the items which could be recovered.
    Collection of Line Item
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • refund
  • refundCurrencyAmount
    Specify the posting amount in the refund's currency.
    Decimal
  • refundCurrencyValueAmount
    Virtual
    Decimal
  • spaceViewId
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.111Refund State

Fields
  • CREATE
    Create
  • SCHEDULED
    Scheduled
  • PENDING
    Pending
  • MANUAL_CHECK
    Manual Check
  • FAILED
    Failed
  • SUCCESSFUL
    Successful

4.12.112Refund Type

Fields
  • MERCHANT_INITIATED_ONLINE
    Merchant Initiated Online
  • MERCHANT_INITIATED_OFFLINE
    Merchant Initiated Offline
  • CUSTOMER_INITIATED_AUTOMATIC
    Customer Initiated Automatic
  • CUSTOMER_INITIATED_MANUAL
    Customer Initiated Manual

4.12.113Rendered Terminal Receipt Details

Properties
  • data
    The data property contains the binary data of the receipt document encoded as base 64 encoded string.
    Collection of Byte
  • mimeType
    The mime type indicates the format of the receipt document. The mime type depends on the requested receipt format.
    String
  • printed
    The terminal might or might not print the receipt. This property is set to true when the configuration of the terminal forces the printing and the device supports the receipt printing.
    Boolean
  • receiptType
    Each receipt has a different usage. The receipt type indicates for what resp. for whom the document is for.

4.12.114Rendered Terminal Transaction Summary Details

Properties
  • data
    The data property contains the binary data of the receipt document encoded as base 64 encoded string.
    Collection of Byte
  • mimeType
    The mime type indicates the format of the receipt document. The mime type depends on the requested receipt format.
    String

4.12.115Sales Channel Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • icon
    String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String
  • parent
  • sortOrder
    Integer

4.12.116Terminal Receipt Fetch Request Details

The receipt fetch request allows to retrieve the receipt documents for a terminal transaction.

Properties
  • format
    *
    The format determines in what format the receipt will be returned in.
  • summaryId
    *
    The id of the transaction summary receipt whose content should be returned.
    Long
  • width
    The width controls how width the document will be rendered. In case of the PDF format the width is in mm. In case of the text format the width is in the number of chars per line.
    Integer

4.12.117Terminal Receipt Fetch Request Details

The receipt fetch request allows to retrieve the receipt documents for a terminal transaction.

Properties
  • format
    *
    The format determines in what format the receipts will be returned in.
  • transaction
    *
    Provide here the ID of the transaction for which the receipts should be fetched.
  • width
    The width controls how width the document will be rendered. In case of the PDF format the width is in mm. In case of the text format the width is in the number of chars per line.
    Integer

4.12.118Token Details

Properties
  • createdOn
    The date and time when the object was created.
    DateTime
  • customerEmailAddress
    ≤ 150 chars
    The customer email address is the email address of the customer.
    String
  • customerId
    The customer ID identifies the customer in the merchant system. In case the customer ID has been provided it has to correspond with the customer ID provided on the transaction. The customer ID will not be changed automatically. The merchant system has to provide it.
    String
  • enabledForOneClickPayment
    When a token is enabled for one-click payments the buyer will be able to select the token within the iFrame or on the payment page to pay with the token. The usage of the token will reduce the number of steps the buyer has to go through. The buyer is linked via the customer ID on the transaction with the token. Means the token will be visible for buyers with the same customer ID. Additionally the payment method has to be configured to allow the one-click payments.
    Boolean
  • externalId
    A client generated nonce which identifies the entity to be created. Subsequent creation requests with the same external ID will not create new entities but return the initially created entity instead.
    String
  • id
    A unique identifier for the object.
    Long
  • language
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • timeZone
    The time zone defines in which time zone the customer is located in. The time zone may affects how dates are formatted when interacting with the customer.
    String
  • tokenReference
    ≤ 100 chars
    Use something that it is easy to identify and may help you find the token (e.g. customer id, email address).
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.119Token Version Details

Properties
  • activatedOn
    DateTime
  • billingAddress
  • createdOn
    The date and time when the object was created.
    DateTime
  • environment
  • expiresOn
    The expires on date indicates when token version expires. Once this date is reached the token version is marked as obsolete.
    DateTime
  • iconUrl
    Virtual
    String
  • id
    A unique identifier for the object.
    Long
  • labels
    Collection of Label
  • language
    Virtual
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 150 chars
    String
  • obsoletedOn
    DateTime
  • paymentConnectorConfiguration
  • paymentInformationHashes
    The payment information hash set contains hashes of the payment information represented by this token version.
  • paymentMethod
  • paymentMethodBrand
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • processorToken
    ≤ 150 chars
    String
  • shippingAddress
  • state
    The object's current state.
  • token
  • type
    The token version type determines what kind of token it is and by which payment connector the token can be processed by.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.120Token Version State

Fields
  • UNINITIALIZED
    Uninitialized
  • ACTIVE
    Active
  • OBSOLETE
    Obsolete

4.12.121Token Version Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • feature
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.12.122Tokenization Mode

The tokenization mode controls how the tokenization of payment information is applied on the transaction.

Fields
  • FORCE_UPDATE
    Force Update
  • FORCE_CREATION
    Force Creation
  • FORCE_CREATION_WITH_ONE_CLICK_PAYMENT
    Force Creation With One Click Payment
  • ALLOW_ONE_CLICK_PAYMENT
    Allow One Click Payment

4.12.123Tokenized Card Data Details

This model holds the card data in plain.

Properties
  • cardHolderName
    ≤ 100 chars
    The card holder name is the name printed onto the card. It identifies the person who owns the card.
    String
  • cardVerificationCode
    3 - 4 chars
    ([0-9 ]+)
    The card verification code (CVC) is a 3 to 4 digit code typically printed on the back of the card. It helps to ensure that the card holder is authorizing the transaction. For card not-present transactions this field is optional.
    String
  • cryptogram
    The additional authentication value used to secure the tokenized card transactions.
  • expiryDate
    ([0-9]{4})\-(11|12|10|0[1-9]{1})
    The card expiry date indicates when the card expires. The format is the format yyyy-mm where yyyy is the year (e.g. 2019) and the mm is the month (e.g. 09).
    String
  • primaryAccountNumber
    *
    10 - 30 chars
    ([0-9 ]+)
    The primary account number (PAN) identifies the card. The number is numeric and typically printed on the front of the card.
    String
  • recurringIndicator
  • schemeTransactionReference
    ≤ 100 chars
    String
  • tokenRequestorId
    String

4.12.124Tokenized Card Data Details

This model holds the card data in plain.

Properties
  • cardHolderName
    ≤ 100 chars
    The card holder name is the name printed onto the card. It identifies the person who owns the card.
    String
  • cardVerificationCode
    3 - 4 chars
    ([0-9 ]+)
    The card verification code (CVC) is a 3 to 4 digit code typically printed on the back of the card. It helps to ensure that the card holder is authorizing the transaction. For card not-present transactions this field is optional.
    String
  • cryptogram
    The additional authentication value used to secure the tokenized card transactions.
  • expiryDate
    ([0-9]{4})\-(11|12|10|0[1-9]{1})
    The card expiry date indicates when the card expires. The format is the format yyyy-mm where yyyy is the year (e.g. 2019) and the mm is the month (e.g. 09).
    String
  • primaryAccountNumber
    10 - 30 chars
    ([0-9 ]+)
    The primary account number (PAN) identifies the card. The number is numeric and typically printed on the front of the card.
    String
  • recurringIndicator
  • schemeTransactionReference
    ≤ 100 chars
    String
  • tokenRequestorId
    String

4.12.125Transaction Details

Properties
  • acceptHeader
    String
  • acceptLanguageHeader
    The accept language contains the header which indicates the language preferences of the buyer.
    String
  • allowedPaymentMethodBrands
    Collection of Long
  • allowedPaymentMethodConfigurations
  • authorizationAmount
    Decimal
  • authorizationEnvironment
    The environment in which this transaction was successfully authorized.
  • authorizationSalesChannel
    The sales channel through which the transaction was placed.
  • authorizationTimeoutOn
    This is the time on which the transaction will be timed out when it is not at least authorized. The timeout time may change over time.
    DateTime
  • authorizedOn
    DateTime
  • autoConfirmationEnabled
    When auto confirmation is enabled the transaction can be confirmed by the user and does not require an explicit confirmation through the web service API.
    Boolean
  • billingAddress
  • chargeRetryEnabled
    When the charging of the customer fails we can retry the charging. This implies that we redirect the user back to the payment page which allows the customer to retry. By default we will retry.
    Boolean
  • completedAmount
    The completed amount is the total amount which has been captured so far.
    Decimal
  • completedOn
    DateTime
  • completionBehavior
    The completion behavior controls when the transaction is completed.
  • completionTimeoutOn
    DateTime
  • confirmedBy
    Long
  • confirmedOn
    DateTime
  • createdBy
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • currency
    String
  • customerEmailAddress
    ≤ 254 chars
    The customer email address is the email address of the customer. If no email address is provided on the shipping or billing address this address is used.
    String
  • customerId
    String
  • customersPresence
    The customer's presence indicates what kind of authentication method was finally used during authorization of the transaction. If no value is provided, 'Virtually Present' is used by default.
  • deliveryDecisionMadeOn
    This date indicates when the decision has been made if a transaction should be delivered or not.
    DateTime
  • deviceSessionIdentifier
    10 - 40 chars
    ([[a-z][A-Z][0-9]-_])*
    The device session identifier links the transaction with the session identifier provided in the URL of the device data JavaScript. This allows to link the transaction with the collected device data of the buyer.
    String
  • emailsDisabled
    Flag indicating whether email sending is disabled for this particular transaction. Defaults to false.
    Boolean
  • endOfLife
    The transaction's end of life indicates the date from which on no operation can be carried out anymore.
    DateTime
  • environment
  • environmentSelectionStrategy
    The environment selection strategy determines how the environment (test or production) for processing the transaction is selected.
  • failedOn
    DateTime
  • failedUrl
    9 - 2,000 options
    URL
    Virtual
    The user will be redirected to failed URL when the transaction could not be authorized or completed. In case no failed URL is specified a default failed page will be displayed.
    String
  • failureReason
    The failure reason describes why the transaction failed. This is only provided when the transaction is marked as failed.
  • group
  • id
    A unique identifier for the object.
    Long
  • internetProtocolAddress
    The Internet Protocol (IP) address identifies the device of the buyer.
    String
  • internetProtocolAddressCountry
    String
  • invoiceMerchantReference
    ≤ 100 chars
    String
  • javaEnabled
    Boolean
  • language
    The language that is linked to the object.
    String
  • lineItems
    Collection of Line Item
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • merchantReference
    ≤ 100 chars
    String
  • metaData
    Virtual
    Allow to store additional information about the object.
    Map of String String
  • parent
  • paymentConnectorConfiguration
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • processingOn
    DateTime
  • refundedAmount
    The refunded amount is the total amount which has been refunded so far.
    Decimal
  • screenColorDepth
    String
  • screenHeight
    String
  • screenWidth
    String
  • shippingAddress
  • shippingMethod
    ≤ 200 chars
    String
  • spaceViewId
  • state
    The object's current state.
  • successUrl
    9 - 2,000 options
    URL
    Virtual
    The user will be redirected to success URL when the transaction could be authorized or completed. In case no success URL is specified a default success page will be displayed.
    String
  • terminal
    The terminal on which the payment was processed.
  • timeZone
    The time zone defines in which time zone the customer is located in. The time zone may affects how dates are formatted when interacting with the customer.
    String
  • token
  • tokenizationMode
    The tokenization mode controls if and how the tokenization of payment information is applied to the transaction.
  • totalAppliedFees
    The total applied fees is the sum of all fees that have been applied so far.
    Decimal
  • totalSettledAmount
    The total settled amount is the total amount which has been settled so far.
    Decimal
  • userAgentHeader
    The user agent header provides the exact string which contains the user agent of the buyer.
    String
  • userFailureMessage
    The failure message describes for an end user why the transaction is failed in the language of the user. This is only provided when the transaction is marked as failed.
    String
  • userInterfaceType
    The user interface type defines through which user interface the transaction has been processed resp. created.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer
  • windowHeight
    String
  • windowWidth
    String
  • yearsToKeep
    The number of years the transaction will be stored after it has been authorized.
    Integer

4.12.126Transaction Aware Entity Details

Properties
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual

4.12.127Transaction Comment Details

Properties
  • content
    ≤ 262,144 chars
    The comment's actual content.
    String
  • createdBy
    The ID of the user the comment was created by.
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • editedBy
    The ID of the user the comment was last updated by.
    Long
  • editedOn
    The date and time when the comment was last updated.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • pinned
    Whether the comment is pinned to the top.
    Boolean
  • transaction
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.128Transaction Completion Details

Properties
  • amount
    The amount which is captured. The amount represents sum of line items including taxes.
    Decimal
  • baseLineItems
    The base line items on which the completion is applied on.
    Collection of Line Item
  • createdBy
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • externalId
    1 - 100 chars
    The external ID helps to identify the entity and a subsequent creation of an entity with the same ID will not create a new entity.
    String
  • failedOn
    DateTime
  • failureReason
  • id
    A unique identifier for the object.
    Long
  • invoiceMerchantReference
    ≤ 100 chars
    String
  • labels
    Collection of Label
  • language
    The language that is linked to the object.
    String
  • lastCompletion
    Indicates if this is the last completion. After the last completion is created the transaction cannot be completed anymore.
    Boolean
  • lineItemVersion
  • lineItems
    The line items which are captured.
    Collection of Line Item
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • mode
  • nextUpdateOn
    DateTime
  • paymentInformation
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • processingOn
    DateTime
  • processorReference
    String
  • remainingLineItems
    Virtual
    Collection of Line Item
  • spaceViewId
  • state
    The object's current state.
  • statementDescriptor
    ≤ 80 options
    [a-zA-Z0-9\s\.\,\_\-\?\+\/]*
    The statement descriptor explain charges or payments on bank statements.
    String
  • succeededOn
    DateTime
  • taxAmount
    The total sum of all taxes of line items.
    Decimal
  • timeZone
    String
  • timeoutOn
    DateTime
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.129Transaction Completion Behavior

Fields
  • COMPLETE_IMMEDIATELY
    Complete Immediately
  • COMPLETE_DEFERRED
    Complete Deferred
  • USE_CONFIGURATION
    Use Configuration

4.12.130Transaction Completion Mode

Fields
  • DIRECT
    Direct
  • ONLINE
    Online
  • OFFLINE
    Offline

4.12.131Transaction Completion Request Details

Properties
  • externalId
    *
    1 - 100 chars
    The external ID helps to identify the entity and a subsequent creation of an entity with the same ID will not create a new entity.
    String
  • invoiceMerchantReference
    ≤ 100 chars
    String
  • lastCompletion
    *
    The last completion flag indicates if this is the last completion. After the last completion is created no further completions can be issued.
    Boolean
  • lineItems
    The line items which will be used to complete the transaction.
  • statementDescriptor
    ≤ 80 options
    [a-zA-Z0-9\s\.\,\_\-\?\+\/]*
    The statement descriptor explain charges or payments on bank statements.
    String
  • transactionId
    *
    The ID of the transaction which should be completed.
    Long

4.12.132Transaction Completion State

Fields
  • CREATE
    Create
  • SCHEDULED
    Scheduled
  • PENDING
    Pending
  • FAILED
    Failed
  • SUCCESSFUL
    Successful

4.12.133Transaction Environment Selection Strategy

Fields
  • FORCE_TEST_ENVIRONMENT
    Force Test Environment
  • FORCE_PRODUCTION_ENVIRONMENT
    Force Production Environment
  • USE_CONFIGURATION
    Use Configuration

4.12.134Transaction Group Details

Properties
  • beginDate
    DateTime
  • customerId
    ≤ 100 chars
    String
  • endDate
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.135Transaction Group State

Fields
  • PENDING
    Pending
  • FAILED
    Failed
  • SUCCESSFUL
    Successful

4.12.136Transaction Invoice Details

The transaction invoice represents the invoice document for a particular transaction.

Properties
  • amount
    Decimal
  • billingAddress
  • completion
  • createdOn
    The date on which the invoice is created on.
    DateTime
  • derecognizedBy
    The id of the user which marked the invoice as derecognized.
    Long
  • derecognizedOn
    The date on which the invoice is marked as derecognized.
    DateTime
  • dueOn
    The date on which the invoice should be paid on.
    DateTime
  • environment
  • externalId
    1 - 100 chars
    The external id helps to identify the entity and a subsequent creation of an entity with the same ID will not create a new entity.
    String
  • id
    A unique identifier for the object.
    Long
  • language
    The language that is linked to the object.
    String
  • lineItems
    Collection of Line Item
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • merchantReference
    ≤ 100 chars
    String
  • outstandingAmount
    The outstanding amount indicates how much the buyer owes the merchant. A negative amount indicates that the invoice is overpaid.
    Decimal
  • paidOn
    The date on which the invoice is marked as paid. Eventually this date lags behind of the actual paid date.
    DateTime
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • spaceViewId
  • state
    The object's current state.
  • taxAmount
    Decimal
  • timeZone
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.137Transaction Invoice Comment Details

Properties
  • content
    ≤ 262,144 chars
    The comment's actual content.
    String
  • createdBy
    The ID of the user the comment was created by.
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • editedBy
    The ID of the user the comment was last updated by.
    Long
  • editedOn
    The date and time when the comment was last updated.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • pinned
    Whether the comment is pinned to the top.
    Boolean
  • transactionInvoice
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.138Transaction Invoice Replacement Details

Properties
  • billingAddress
  • dueOn
    The date on which the invoice should be paid on.
    DateTime
  • externalId
    *
    1 - 100 chars
    The external id helps to identify the entity and a subsequent creation of an entity with the same ID will not create a new entity.
    String
  • lineItems
    *
    Collection of Line Item Create
  • merchantReference
    ≤ 100 chars
    String
  • sentToCustomer
    When the connector is configured to send the invoice to the customer and this property is true the customer will receive an email with the updated invoice. When this property is false no invoice is sent.
    Boolean

4.12.139Transaction Invoice State

Fields
  • CREATE
    Create
  • OPEN
    Open
  • OVERDUE
    Overdue
  • CANCELED
    Canceled
  • PAID
    Paid
  • DERECOGNIZED
    Derecognized
  • NOT_APPLICABLE
    Not Applicable

4.12.140Transaction Line Item Version Details

Properties
  • amount
    Decimal
  • createdBy
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • externalId
    A client generated nonce which identifies the entity to be created. Subsequent creation requests with the same external ID will not create new entities but return the initially created entity instead.
    String
  • failedOn
    DateTime
  • failureReason
  • id
    A unique identifier for the object.
    Long
  • labels
    Collection of Label
  • language
    The language that is linked to the object.
    String
  • lineItems
    Collection of Line Item
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • nextUpdateOn
    DateTime
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • processingOn
    DateTime
  • spaceViewId
  • state
    The object's current state.
  • succeededOn
    DateTime
  • taxAmount
    Decimal
  • timeoutOn
    DateTime
  • transaction
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.141Transaction Line Item Version . Create Details

Properties
  • externalId
    *
    A client generated nonce which identifies the entity to be created. Subsequent creation requests with the same external ID will not create new entities but return the initially created entity instead.
    String
  • lineItems
    *
    Collection of Line Item Create
  • transaction
    *

4.12.142Transaction Line Item Version State

Fields
  • CREATE
    Create
  • SCHEDULED
    Scheduled
  • PENDING
    Pending
  • SUCCESSFUL
    Successful
  • FAILED
    Failed

4.12.143Transaction State

Fields
  • CREATE
    Create
  • PENDING
    Pending
  • CONFIRMED
    Confirmed
  • PROCESSING
    Processing
  • FAILED
    Failed
  • AUTHORIZED
    Authorized
  • VOIDED
    Voided
  • COMPLETED
    Completed
  • FULFILL
    Fulfill
  • DECLINE
    Decline

4.12.144Transaction Summary DCC Transaction Sums Details

Properties
  • brand
    String
  • dccAmount
    Decimal
  • dccCurrency
    String
  • id
    A unique identifier for the object.
    Long
  • transactionAmount
    Decimal
  • transactionCount
    Integer
  • transactionCurrency
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.145Transaction User Interface Type

Fields
  • IFRAME
    Iframe
  • LIGHTBOX
    Lightbox
  • PAYMENT_PAGE
    Payment Page
  • MOBILE_SDK
    Mobile Sdk
  • TERMINAL
    Terminal

4.12.146Transaction Void Details

Properties
  • createdBy
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • failedOn
    DateTime
  • failureReason
  • id
    A unique identifier for the object.
    Long
  • labels
    Collection of Label
  • language
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • mode
  • nextUpdateOn
    DateTime
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • processorReference
    String
  • spaceViewId
  • state
    The object's current state.
  • succeededOn
    DateTime
  • timeoutOn
    DateTime
  • transaction
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.12.147Transaction Void Mode

Fields
  • ONLINE
    Online
  • OFFLINE
    Offline

4.12.148Transaction Void State

Fields
  • CREATE
    Create
  • PENDING
    Pending
  • FAILED
    Failed
  • SUCCESSFUL
    Successful

4.12.149Transaction summary Details

Properties

4.12.150Wallet Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.13Shopify

4.13.1Shopify Additional Line Item Data

Fields
  • VENDOR
    Vendor
  • WEIGHT
    Weight

4.13.2Shopify Integration Details

A Shopify Integration allows to connect a Shopify shop.

Properties
  • additionalLineItemData
  • allowInvoiceDownload
    Boolean
  • allowedPaymentMethodConfigurations
  • currency
    String
  • id
    A unique identifier for the object.
    Long
  • integratedPaymentFormEnabled
    Enabling the integrated payment form will embed the payment form in the Shopify shop. The app needs to be installed for this to be possible.
    Boolean
  • language
    The checkout language forces a specific language in the checkout. Without a checkout language the browser setting of the buyer is used to determine the language.
    String
  • loginName
    ≤ 100 chars
    The login name is used to link a specific Shopify payment gateway to this integration.This login name is to be filled into the appropriate field in the shops payment gateway configuration.
    String
  • name
    ≤ 100 chars
    The integration name is used internally to identify a specific integration.For example the name is used withinsearch fields and hence it should be distinct and descriptive.
    String
  • paymentAppVersion
  • paymentInstalled
    Boolean
  • paymentProxyPath
    [A-Za-z0-9-_/]*
    Define the path of the proxy URL. This only needs to be changed if the apps proxy URL is overwritten in the Shopify store.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • replacePaymentMethodImage
    Boolean
  • shopName
    ≤ 100 chars
    ([^\p{C}\p{Cn}\p{Zl}\p{Zp}.]|[ ])*
    The store address is used to link a specific Shopify shop to this integration. This is the name used in the Shopifys admin URL: [storeAddress].myshopify.com
    String
  • showPaymentInformation
    Boolean
  • showSubscriptionInformation
    Boolean
  • spaceId
    ≥ 1
    Long
  • spaceViewId
  • state
    The object's current state.
  • subscriptionAppVersion
  • subscriptionInstalled
    Boolean
  • subscriptionProxyPath
    [A-Za-z0-9-_/]*
    Define the path of the proxy URL. This only needs to be changed if the apps proxy URL is overwritten in the Shopify store.
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.13.3Shopify Integration Payment App Version

Fields
  • API_2019_07
    Api 2019 07

4.13.4Shopify Integration Subscription App Version

Fields
  • BASIC
    Basic
  • SUBSCRIPTION
    Subscription
  • API_2019_07
    Api 2019 07

4.13.5Shopify Recurring Order Details

Properties
  • billedOn
    DateTime
  • checkoutToken
    String
  • createdOn
    DateTime
  • failureReason
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • orderId
    String
  • orderName
    String
  • plannedExecutionDate
    DateTime
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • recurrenceNumber
    Integer
  • shop
  • startedProcessingOn
    DateTime
  • state
    The object's current state.
  • subscriptionVersion
  • transaction

4.13.6Shopify Recurring Order State

Fields
  • PENDING
    Pending
  • ONHOLD
    Onhold
  • PROCESSING
    Processing
  • CANCELED
    Canceled
  • BILLED
    Billed
  • FAILED
    Failed

4.13.7Shopify Recurring Order Update Request Details

Properties
  • executionDate
    DateTime
  • recurringOrderId
    Long

4.13.8Shopify Subscriber Details

Properties
  • createdOn
    DateTime
  • emailAddress
    Email
    ≤ 254 chars
    String
  • externalId
    A client generated nonce which identifies the entity to be created. Subsequent creation requests with the same external ID will not create new entities but return the initially created entity instead.
    String
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • phoneNumber
    ≤ 254 chars
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • shop
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.13.9Shopify Subscriber Creation Details

Properties
  • emailAddress
    String
  • phoneNumber
    String
  • shopifyCustomerId
    *
    The customer ID has to correspond to the ID assigned to the customer by Shopify. When the subscriber already exists no new subscriber will be created.
    String

4.13.10Shopify Subscriber State

Fields
  • ACTIVE
    Active
  • DELETING
    Deleting
  • DELETED
    Deleted

4.13.11Shopify Subscription Details

Properties
  • createdBy
    Long
  • createdOn
    DateTime
  • externalId
    1 - 100 chars
    The external id helps to identify the entity and a subsequent creation of an entity with the same ID will not create a new entity.
    String
  • id
    A unique identifier for the object.
    Long
  • initialExecutionDate
    DateTime
  • initialPaymentTransaction
  • initialShopifyTransaction
  • language
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • orderRecurrenceNumber
    Integer
  • shop
  • state
    The object's current state.
  • subscriber
  • terminatedBy
    Long
  • terminatedOn
    DateTime
  • terminationRequestDate
    DateTime
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.13.12Shopify Subscription Address Details

Properties
  • city
    The city, town or village.
    String
  • commercialRegisterNumber
    ≤ 100 chars
    The commercial registration number of the organization.
    String
  • country
    The two-letter country code (ISO 3166 format).
    String
  • dateOfBirth
    The date of birth.
    Date
  • dependentLocality
    ≤ 100 chars
    The dependent locality which is a sub-division of the state.
    String
  • emailAddress
    Email
    ≤ 254 chars
    The email address.
    String
  • familyName
    The family or last name.
    String
  • gender
    The gender.
  • givenName
    ≤ 100 chars
    The given or first name.
    String
  • legalOrganizationForm
    The legal form of the organization.
  • mobilePhoneNumber
    ≤ 100 chars
    The phone number of a mobile phone.
    String
  • organizationName
    ≤ 100 chars
    The organization's name.
    String
  • phoneNumber
    ≤ 100 chars
    The phone number.
    String
  • postalState
    The name of the region, typically a state, county, province or prefecture.
    String
  • postcode
    The postal code, also known as ZIP, postcode, etc.
    String
  • salesTaxNumber
    ≤ 100 chars
    The sales tax number of the organization.
    String
  • salutation
    ≤ 20 chars
    The salutation e.g. Mrs, Mr, Dr.
    String
  • socialSecurityNumber
    ≤ 100 chars
    The social security number.
    String
  • sortingCode
    ≤ 100 chars
    The sorting code identifying the post office where the PO Box is located.
    String
  • street
    The street or PO Box.
    String

4.13.13Shopify Subscription Billing Configuration Details

Properties
  • billingDayOfMonth
    ≥ 1
    ≤ 31
    Define the day of the month on which the recurring orders should be created.
    Integer
  • billingIntervalAmount
    ≥ 1
    Integer
  • billingIntervalUnit
    Define how frequently recurring orders should be created.
  • billingReferenceDate
    This date will be used as basis to calculate the dates of recurring orders.
    DateTime
  • billingWeekday
    Define the weekday on which the recurring orders should be created.
  • maximalBillingCycles
    Positive
    Define the maximum number of orders the subscription will run for.
    Integer
  • maximalSuspendableCycles
    Positive
    Define the maximum number of orders the subscription can be suspended for at a time.
    Integer
  • minimalBillingCycles
    Positive
    Define the minimal number of orders the subscription will run for.
    Integer
  • terminationBillingCycles
    Positive
    Define the number of orders the subscription will keep running for after its termination has been requested.
    Integer

4.13.14Shopify Subscription Billing Interval Unit

Fields
  • MINUTES
    Minutes
  • HOURS
    Hours
  • DAYS
    Days
  • WEEKS
    Weeks
  • MONTHS
    Months
  • YEARS
    Years

4.13.15Shopify Subscription Creation Request Details

Properties

4.13.16Shopify Subscription Item Details

Properties

4.13.17Shopify Subscription Product Details

Properties
  • absolutePriceAdjustment
    Decimal
  • billingDayOfMonth
    ≥ 1
    ≤ 31
    Define the day of the month on which the recurring orders should be created.
    Integer
  • billingIntervalAmount
    ≥ 1
    Integer
  • billingIntervalUnit
    Define how frequently recurring orders should be created.
  • billingWeekday
    Define the weekday on which the recurring orders should be created.
  • fixedPrice
    Decimal
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • maximalBillingCycles
    Positive
    Define the maximum number of orders the subscription will run for.
    Integer
  • maximalSuspendableCycles
    Positive
    Define the maximum number of orders the subscription can be suspended for at a time.
    Integer
  • minimalBillingCycles
    Positive
    Define the minimal number of orders the subscription will run for.
    Integer
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • pricingOption
  • productId
    The ID of the Shopify product that is enabled to be ordered as subscription.
    String
  • productName
    String
  • productPrice
    Decimal
  • productSku
    String
  • productVariantId
    String
  • productVariantName
    String
  • relativePriceAdjustment
    Decimal
  • shippingRequired
    Boolean
  • shop
  • state
    The object's current state.
  • stockCheckRequired
    Boolean
  • storeOrderConfirmationEmailEnabled
    Define whether the order confirmation email of the Shopify shop is sent to the customer for recurring orders.
    Boolean
  • subscriberSuspensionAllowed
    Define whether the customer is allowed to suspend subscriptions.
    Boolean
  • terminationBillingCycles
    Positive
    Define the number of orders the subscription will keep running for after its termination has been requested.
    Integer
  • updatedAt
    DateTime
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.13.18Shopify Subscription Product Pricing Option

Fields
  • CURRENT_PRICE
    Current Price
  • ORIGINAL_PRICE
    Original Price
  • FIXED_PRICE
    Fixed Price
  • RELATIVE_ADJUSTMENT
    Relative Adjustment
  • ABSOLUTE_ADJUSTMENT
    Absolute Adjustment

4.13.19Shopify Subscription Product State

Fields
  • CREATE
    Create
  • ACTIVE
    Active
  • INACTIVE
    Inactive
  • OBSOLETE
    Obsolete
  • DELETING
    Deleting
  • DELETED
    Deleted

4.13.20Shopify Subscription State

Fields
  • INITIATING
    Initiating
  • FAILED
    Failed
  • ACTIVE
    Active
  • SUSPENDED
    Suspended
  • TERMINATING
    Terminating
  • TERMINATED
    Terminated

4.13.21Shopify Subscription Suspension Details

Properties

4.13.22Shopify Subscription Suspension Initiator

Fields
  • MERCHANT
    Merchant
  • CUSTOMER
    Customer

4.13.23Shopify Subscription Suspension State

Fields
  • ACTIVE
    Active
  • ENDED
    Ended

4.13.24Shopify Subscription Suspension Type

Fields
  • REACTIVATE
    Reactivate
  • TERMINATE
    Terminate

4.13.25Shopify Subscription Tax Line Details

Properties
  • rate
    Decimal
  • title
    String

4.13.26Shopify Subscription Update Addresses Request Details

Properties

4.13.27Shopify Subscription Update Request Details

Properties

4.13.28Shopify Subscription Version Details

Properties

4.13.29Shopify Subscription Version Item Details

Properties

4.13.30Shopify Subscription Version Item Price Strategy

Fields
  • INITIALLY_CALCULATED
    Initially Calculated
  • RECALCULATE
    Recalculate

4.13.31Shopify Subscription Version State

Fields
  • CREATE
    Create
  • ACTIVE
    Active
  • DISCHARGED
    Discharged

4.13.32Shopify Subscription Weekday

Fields
  • MONDAY
    Monday
  • TUESDAY
    Tuesday
  • WEDNESDAY
    Wednesday
  • THURSDAY
    Thursday
  • FRIDAY
    Friday
  • SATURDAY
    Saturday
  • SUNDAY
    Sunday

4.13.33Shopify Tax Line Details

Properties
  • fractionRate
    Decimal
  • id
    A unique identifier for the object.
    Long
  • rate
    Decimal
  • title
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.13.34Shopify Transaction Details

Properties
  • checkoutId
    String
  • createdOn
    The date and time when the object was created.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • integration
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • orderId
    String
  • orderName
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
  • transaction
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.13.35Shopify Transaction State

Fields
  • PENDING
    Pending
  • AUTHORIZED
    Authorized
  • COMPLETED
    Completed
  • FAILED
    Failed
  • CONFLICTING
    Conflicting

4.14Subscription

4.14.1Metric Details

A metric represents the usage of a resource that can be measured.

Properties
  • description
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    Map of String String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • type
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.2Metric Usage Report Details

The metric usage is the actual usage of a metric for a particular subscription as collected by an external application.

Properties
  • consumedUnits
    The consumed units describe the amount of resources consumed. Those consumed units will be billed in the next billing cycle.
    Decimal
  • createdByUserId
    Long
  • createdOn
    DateTime
  • description
    ≤ 100 chars
    The metric usage report description describe the reported usage. This description may be shown to the end user.
    String
  • externalId
    The external id identifies the metric usage uniquely.
    String
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • metric
    The metric usage report is linked to the metric for which the usage should be recorded.
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • subscription
    The subscription to which the usage is added to.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.3Product Details

A subscription product represents a product to which a subscriber can subscribe to. A product defines how much the subscription costs and in what cycles the subscribe is charged.

Properties
  • allowedPaymentMethodConfigurations
    The allowed payment method configurations control which payment methods can be used with this product. When none is selected all methods will be allowed.
  • failedPaymentSuspensionPeriod
    When a payment fails, the subscription to which the payment belongs to will be suspended. When the suspension is not removed within the specified period the subscription will be terminated. A payment is considered as failed when the subscriber issues a refund or when a subscription charge fails.
    String
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The product name is used internally to identify the configuration in administrative interfaces. For example it is used within search fields and hence it should be distinct and descriptive.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • productLocked
    Marks the product as locked. Meaning that customer can not change away from this product or change to this product later on.
    Boolean
  • reference
    ≤ 100 chars
    The product reference identifies the product for external systems. This field may contain the product's SKU.
    String
  • sortOrder
    The sort order controls in which order the product is listed. The sort order is used to order the products in ascending order.
    Integer
  • spaceId
    Long
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.4Product Component Details

Properties
  • componentChangeWeight
    If a product component changes from one with a lower product component tier (e.g. 1) to one with a higher product component tier (e.g. 3), it is considered an upgrade and a one-time fee could be applied.
    Integer
  • componentGroup
  • defaultComponent
    When a component is marked as a 'default' component it is used as the default component in its group and will be preselected in the product configuration.
    Boolean
  • description
    The component description may contain a longer description which gives the subscriber a better understanding of what the component contains.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • maximalQuantity
    The maximum quantity defines the maximum value which must be entered for the quantity.
    Decimal
  • minimalQuantity
    The minimal quantity defines the minimum value which must be entered for the quantity.
    Decimal
  • name
    The component name is shown to the subscriber. It should describe in few words what the component does contain.
    Map of String String
  • quantityStep
    The quantity step defines at which interval the quantity can be increased.
    Decimal
  • reference
    The component reference is used to identify the component by external systems and it marks components to represent the same component within different product versions.
  • sortOrder
    The sort order controls in which order the component is listed. The sort order is used to order the components in ascending order.
    Integer
  • taxClass
    The tax class of the component determines the taxes which are applicable on all fees linked with the component.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.5Product Component Group Details

Properties
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    The component group name will be shown when the components are selected. This can be visible to the subscriber.
    Map of String String
  • optional
    The component group can be optional. This means no component has to be selected by the subscriber.
    Boolean
  • productVersion
  • sortOrder
    The sort order controls in which order the component group is listed. The sort order is used to order the component groups in ascending order.
    Integer
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.6Product Component Reference Details

The product component reference binds components from different product versions together. By binding them together the product version migration can be realized.

Properties
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The component reference name is used internally to identify the reference. For example the name is used within search fields and hence it should be distinct and descriptive.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • spaceId
    Long
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.7Product Fee Type

Fields
  • METERED_FEE
    Metered Fee
  • SETUP_FEE
    Setup Fee
  • PERIOD_FEE
    Period Fee

4.14.8Product Metered Fee Details

Properties
  • component
  • description
    The description of a component fee describes the fee to the subscriber. The description may be shown in documents or on certain user interfaces.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • metric
  • name
    The name of the fee should describe for the subscriber in few words for what the fee is for.
    Map of String String
  • tierPricing
    The tier pricing determines the calculation method of the tiers. The prices of the different tiers can be applied in different ways. The tier pricing controls this calculation.
  • type
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.9Product Metered Tier Fee Details

Properties
  • fee
    The fee determines the amount which is charged. The consumed metric is multiplied by the defined fee. The resulting amount is charged at the end of the period.
  • id
    A unique identifier for the object.
    Long
  • meteredFee
  • startRange
    The start range defines the metered consumption of the metric from which on the defined fee gets applied. This means when a subscription consumes a value of 10 or more and the start range is set to 10 the fee defined on the tier will be applied.
    Decimal
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.10Product Metered Tier Pricing

Fields
  • CHEAPEST_TIER_PRICING
    Cheapest Tier Pricing
  • INCREMENTAL_DISCOUNT_PRICING
    Incremental Discount Pricing

4.14.11Product Period Fee Details

Properties
  • component
  • description
    The description of a component fee describes the fee to the subscriber. The description may be shown in documents or on certain user interfaces.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • ledgerEntryTitle
    The ledger entry title will be used for the title in the ledger entry and in the invoice.
    Map of String String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    The name of the fee should describe for the subscriber in few words for what the fee is for.
    Map of String String
  • numberOfFreeTrialPeriods
    Positive
    The number of free trial periods specify how many periods are free of charge at the begining of the subscription.
    Integer
  • periodFee
    The period fee is charged for every period of the subscription except for those periods which are trial periods.
  • type
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.12Product Retirement Details

Properties
  • createdOn
    The date and time when the object was created.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • product
  • respectTerminiationPeriodsEnabled
    Boolean
  • targetProduct
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.13Product Setup Fee Details

Properties
  • component
  • description
    The description of a component fee describes the fee to the subscriber. The description may be shown in documents or on certain user interfaces.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    The name of the fee should describe for the subscriber in few words for what the fee is for.
    Map of String String
  • onDowngradeCreditedAmount
    ≥ 1 options
    When the subscription is changed and the change is considered as a downgrade the amount defined by this property will be credited to the subscriber.
  • onUpgradeCreditedAmount
    ≥ 1 options
    When the subscription is changed and the change is considered as a upgrade the amount defined by this property will be credited to the subscriber.
  • setupFee
    ≥ 1 options
    The setup fee is charged when the subscriber subscribes to this component. The setup fee is debited with the first charge for the subscriptions.
  • type
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.14Product Version Details

Properties
  • activatedOn
    DateTime
  • billingCycle
    The billing cycle determines the rhythm with which the subscriber is billed. The charging may have different rhythm.
    String
  • comment
    The comment allows to provide a internal comment for the version. It helps to document why a product was changed. The comment is not disclosed to the subscriber.
    String
  • createdOn
    DateTime
  • defaultCurrency
    The default currency has to be used in all fees.
    String
  • enabledCurrencies
    The currencies which are enabled can be selected to define component fees. Currencies which are not enabled cannot be used to define fees.
    Collection of String
  • id
    A unique identifier for the object.
    Long
  • incrementNumber
    The increment number represents the version number incremented whenever a new version is activated.
    Integer
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • minimalNumberOfPeriods
    The minimal number of periods determines how long the subscription has to run before the subscription can be terminated.
    Integer
  • name
    The product version name is the name of the product which is shown to the user for the version. When the visible product name should be changed for a particular product a new version has to be created which contains the new name of the product.
    Map of String String
  • numberOfNoticePeriods
    The number of notice periods determines the number of periods which need to be paid between the request to terminate the subscription and the final period.
    Integer
  • obsoletedOn
    DateTime
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • product
    Each product version is linked to a product.
  • reference
    ≤ 125 chars
    The product version reference helps to identify the version. The reference is generated out of the product reference.
    String
  • retiringFinishedOn
    DateTime
  • retiringStartedOn
    DateTime
  • state
    The object's current state.
  • taxCalculation
    Strategy that is used for tax calculation in fees.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.15Product Version Retirement Details

Properties
  • createdOn
    The date and time when the object was created.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • productVersion
  • respectTerminiationPeriodsEnabled
    Boolean
  • targetProduct
    When a target product is not chosen, all customers with the retired product will be terminated.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.16Subscriber Details

A subscriber represents everyone who is subscribed to a product.

Properties
  • additionalAllowedPaymentMethodConfigurations
    Those payment methods which are allowed additionally will be available even when the product does not allow those methods.
  • billingAddress
  • description
    ≤ 200 chars
    The subscriber description can be used to add a description to the subscriber. This is used in the back office to identify the subscriber.
    String
  • disallowedPaymentMethodConfigurations
    Those payment methods which are disallowed will not be available to the subscriber even if the product allows those methods.
  • emailAddress
    ≤ 254 chars
    The email address is used to communicate with the subscriber. There can be only one subscriber per space with the same email address.
    String
  • externalId
    A client generated nonce which identifies the entity to be created. Subsequent creation requests with the same external ID will not create new entities but return the initially created entity instead.
    String
  • id
    A unique identifier for the object.
    Long
  • language
    The subscriber language determines the language which is used to communicate with the subscriber in emails and documents (e.g. invoices).
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • metaData
    Virtual
    Allow to store additional information about the object.
    Map of String String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • reference
    ≤ 100 chars
    The subscriber reference identifies the subscriber in administrative interfaces (e.g. customer id).
    String
  • shippingAddress
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.17Subscription Details

Properties
  • activatedOn
    DateTime
  • affiliate
  • createdOn
    DateTime
  • currentProductVersion
  • description
    ≤ 200 chars
    String
  • id
    A unique identifier for the object.
    Long
  • initializedOn
    DateTime
  • language
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • plannedTerminationDate
    DateTime
  • reference
    ≤ 100 chars
    String
  • state
    The object's current state.
  • subscriber
  • terminatedBy
    Long
  • terminatedOn
    DateTime
  • terminatingOn
    DateTime
  • terminationScheduledOn
    DateTime
  • token
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.18Subscription Affiliate Details

Properties
  • externalId
    A client generated nonce which identifies the entity to be created. Subsequent creation requests with the same external ID will not create new entities but return the initially created entity instead.
    String
  • id
    A unique identifier for the object.
    Long
  • language
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • metaData
    Virtual
    Allow to store additional information about the object.
    Map of String String
  • name
    3 - 255 chars
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • reference
    3 - 100 chars
    String
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.19Subscription Change Request Details

The subscription change request allows to change a subscription.

Properties
  • componentConfigurations
  • currency
    *
    String
  • product
    *
    The subscription has to be linked with a product.
    ID of Product
  • respectTerminationPeriod
    The subscription version may be retired. The respect termination period controls whether the termination period configured on the product version should be respected or if the operation should take effect immediately.
    Boolean
  • selectedComponents
    Collection of ID of Product Component Reference
  • subscription
    *

4.14.20Subscription Charge Details

The subscription charge represents a single charge carried out for a particular subscription.

Properties
  • createdOn
    DateTime
  • discardedBy
    Long
  • discardedOn
    DateTime
  • externalId
    A client generated nonce which identifies the entity to be created. Subsequent creation requests with the same external ID will not create new entities but return the initially created entity instead.
    String
  • failedOn
    DateTime
  • failedUrl
    9 - 500 options
    URL
    Virtual
    The user will be redirected to failed URL when the transaction could not be authorized or completed. In case no failed URL is specified a default failed page will be displayed.
    String
  • id
    A unique identifier for the object.
    Long
  • language
    The language that is linked to the object.
    String
  • ledgerEntries
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • plannedExecutionDate
    DateTime
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • processingType
  • reference
    ≤ 100 chars
    String
  • state
    The object's current state.
  • subscription
    The field subscription indicates the subscription to which the charge belongs to.
  • succeedOn
    DateTime
  • successUrl
    9 - 500 options
    URL
    Virtual
    The user will be redirected to success URL when the transaction could be authorized or completed. In case no success URL is specified a default success page will be displayed.
    String
  • transaction
  • type
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.21Subscription Charge Processing Type

Fields
  • SYNCHRONOUS
    Synchronous
  • CHARGE_FLOW
    Charge Flow

4.14.22Subscription Charge State

Fields
  • SCHEDULED
    Scheduled
  • DISCARDED
    Discarded
  • PROCESSING
    Processing
  • SUCCESSFUL
    Successful
  • FAILED
    Failed

4.14.23Subscription Charge Type

Fields
  • MANUAL
    Manual
  • AUTOMATIC
    Automatic

4.14.24Subscription Component Configuration Details

Properties
  • component
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    The ID of the space this object belongs to.
    Long
  • quantity
    Decimal
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.25Subscription Component Reference Configuration Details

The component reference configuration adjusts the product component for a particular subscription.

Properties
  • productComponentReferenceId
    Long
  • quantity
    Decimal

4.14.26Subscription Create Request Details

The subscription create request holds all the data required to create a new subscription.

Properties

4.14.27Subscription Ledger Entry Details

The subscription ledger entry represents a single change on the subscription balance.

Properties
  • aggregatedTaxRate
    Decimal
  • amountExcludingTax
    Decimal
  • amountIncludingTax
    Decimal
  • createdBy
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • discountIncludingTax
    Decimal
  • externalId
    A client generated nonce which identifies the entity to be created. Subsequent creation requests with the same external ID will not create new entities but return the initially created entity instead.
    String
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • quantity
    Decimal
  • state
    The object's current state.
  • subscriptionVersion
  • taxAmount
    Decimal
  • taxes
    Collection of Tax
  • title
    1 - 150 chars
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.28Subscription Ledger Entry State

Fields
  • OPEN
    Open
  • SCHEDULED
    Scheduled
  • PAID
    Paid

4.14.29Subscription Metric Type Details

The subscription metric type identifies the type of the metric.

Properties
  • description
    The localized description of the object.
    Map of String String
  • feature
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.14.30Subscription Period Bill Details

Properties
  • createdOn
    DateTime
  • effectivePeriodEndDate
    DateTime
  • id
    A unique identifier for the object.
    Long
  • language
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • periodStartDate
    DateTime
  • plannedPeriodEndDate
    DateTime
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • subscriptionVersion
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.31Subscription Period Bill State

Fields
  • PENDING
    Pending
  • BILLED
    Billed

4.14.32Subscription Product Component Reference State

Fields
  • CREATE
    Create
  • ACTIVE
    Active
  • DELETING
    Deleting
  • DELETED
    Deleted

4.14.33Subscription Product State

Fields
  • CREATE
    Create
  • ACTIVE
    Active
  • INACTIVE
    Inactive
  • RETIRING
    Retiring
  • RETIRED
    Retired

4.14.34Subscription Product Version State

Fields
  • PENDING
    Pending
  • ACTIVE
    Active
  • OBSOLETE
    Obsolete
  • RETIRING
    Retiring
  • RETIRED
    Retired

4.14.35Subscription State

Fields
  • PENDING
    Pending
  • INITIALIZING
    Initializing
  • FAILED
    Failed
  • ACTIVE
    Active
  • SUSPENDED
    Suspended
  • TERMINATION_SCHEDULED
    Termination Scheduled
  • TERMINATING
    Terminating
  • TERMINATED
    Terminated

4.14.36Subscription Suspension Action

Fields
  • TERMINATE
    Terminate
  • REACTIVATE
    Reactivate

4.14.37Subscription Suspension Reason

Fields
  • FAILED_CHARGE
    Failed Charge
  • SUBSCRIBER_INITIATED_REFUND
    Subscriber Initiated Refund
  • MANUAL
    Manual

4.14.38Subscription Suspension State

Fields
  • RUNNING
    Running
  • ENDED
    Ended

4.14.39Subscription Update Request Details

The subscription update request allows to change a subscription properites.

Properties
  • description
    ≤ 200 chars
    String

4.14.40Subscription Version Details

Properties
  • activatedOn
    DateTime
  • billingCurrency
    The subscriber is charged in the billing currency. The billing currency has to be one of the enabled currencies on the subscription product.
    String
  • componentConfigurations
  • createdOn
    DateTime
  • expectedLastPeriodEnd
    The expected last period end is the date on which the projected end date of the last period is. This is only a projection and as such the actual date may be different.
    DateTime
  • failedOn
    DateTime
  • id
    A unique identifier for the object.
    Long
  • language
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • plannedTerminationDate
    DateTime
  • productVersion
  • selectedComponents
    Collection of Product Component
  • state
    The object's current state.
  • subscription
  • terminatedOn
    DateTime
  • terminatingOn
    DateTime
  • terminationIssuedOn
    DateTime
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.41Subscription Version State

Fields
  • PENDING
    Pending
  • INITIALIZING
    Initializing
  • FAILED
    Failed
  • ACTIVE
    Active
  • TERMINATING
    Terminating
  • TERMINATED
    Terminated

4.14.42Suspension Details

Properties
  • createdOn
    The date and time when the object was created.
    DateTime
  • effectiveEndDate
    DateTime
  • endAction
    When the suspension reaches the planned end date the end action will be carried out. This action is only executed when the suspension is ended automatically based on the end date.
  • id
    A unique identifier for the object.
    Long
  • language
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • note
    ≤ 300 chars
    The note may contain some internal information for the suspension. The note will not be disclosed to the subscriber.
    String
  • periodBill
  • plannedEndDate
    The planned end date of the suspension identifies the date on which the suspension will be ended automatically.
    DateTime
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • reason
    The suspension reason indicates why a suspension has been created.
  • state
    The object's current state.
  • subscription
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.14.43Tax Calculation

Fields
  • TAX_INCLUDED
    Tax Included
  • TAX_NOT_INCLUDED
    Tax Not Included

4.15Tax

4.15.1Tax Details

Properties
  • rate
    ≤ 100
    Decimal
  • title
    2 - 40 chars
    String

4.15.2Tax Class Details

Properties
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The tax class name is used internally to identify the tax class in administrative interfaces. For example it is used within search fields and hence it should be distinct and descriptive.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • spaceId
    ≥ 1
    Long
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.16User

4.16.1Application User Details

Properties
  • id
    A unique identifier for the object.
    Long
  • name
    ≤ 256 chars
    The name used to identify the application user.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • primaryAccount
    The primary account that the user belongs to.
  • requestLimit
    The maximum number of API requests that are accepted every 2 minutes.
    Long
  • scope
    The scope that the user belongs to.
    Long
  • state
    The object's current state.
  • userType
    Virtual
    The user's type which defines its role and capabilities.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.16.2Human User Details

Properties
  • emailAddress
    Email
    ≤ 128 chars
    The user's email address.
    String
  • emailAddressVerified
    Whether the user's email address has been verified.
    Boolean
  • firstname
    ≤ 100 chars
    The user's first name.
    String
  • id
    A unique identifier for the object.
    Long
  • language
    The user's preferred language.
    String
  • lastname
    ≤ 100 chars
    The user's last name.
    String
  • mobilePhoneNumber
    ≤ 30 chars
    The user's mobile phone number.
    String
  • mobilePhoneVerified
    Whether the user's mobile phone number has been verified.
    Boolean
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • primaryAccount
    The primary account that the user belongs to.
  • scope
    The scope that the user belongs to.
    Long
  • state
    The object's current state.
  • timeZone
    The user's time zone. If none is specified, the one provided by the browser will be used.
    String
  • twoFactorEnabled
    Whether two-factor authentication is enabled for this user.
    Boolean
  • twoFactorType
    The type of two-factor authentication that is enabled for the user.
  • userType
    Virtual
    The user's type which defines its role and capabilities.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.16.3Permission Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • feature
    The feature that this permission belongs to.
  • group
    Whether this is a permission group.
    Boolean
  • id
    A unique identifier for the object.
    Long
  • leaf
    Whether this is a leaf in the tree of permissions, and not a group.
    Boolean
  • name
    The localized name of the object.
    Map of String String
  • parent
    The group that this permission belongs to.
  • pathToRoot
    All parents of this permission up to the root of the permission tree.
    Collection of Long
  • title
    The localized name of the object.
    Map of String String
  • twoFactorRequired
    Whether users with this permission are required to enable two-factor authentication.
    Boolean
  • webAppEnabled
    Boolean

4.16.4Role Details

Properties
  • account
    The account the role belongs to. The role can only be assigned within this account.
  • id
    A unique identifier for the object.
    Long
  • name
    The name used to identify the role.
    Map of String String
  • permissions
    The permissions granted to users with this role.
    Collection of Permission
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • twoFactorRequired
    Whether users with this role are required to use two-factor authentication.
    Boolean
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.16.5Role State

Fields
  • CREATE
    Create
  • ACTIVE
    Active
  • DELETING
    Deleting
  • DELETED
    Deleted

4.16.6Two Factor Authentication Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • feature
    The feature that this type belongs to.
  • icon
    The identifier of the icon representing this type.
    String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.16.7User Details

Properties
  • id
    A unique identifier for the object.
    Long
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • scope
    The scope that the user belongs to.
    Long
  • state
    The object's current state.
  • userType
    Virtual
    The user's type which defines its role and capabilities.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.16.8User Account Role Details

Properties
  • account
  • appliesOnSubAccount
    Boolean
  • id
    A unique identifier for the object.
    Long
  • role
    Long
  • user
    Long
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.16.9User Space Role Details

Properties
  • id
    A unique identifier for the object.
    Long
  • role
    Long
  • space
    Long
  • user
    Long
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.16.10User Type

Fields
  • HUMAN_USER
    Human User
  • SINGLE_SIGNON_USER
    Single Signon User
  • APPLICATION_USER
    Application User
  • ANONYMOUS_USER
    Anonymous User
  • SERVER_USER
    Server User

4.17Webhook

4.17.1Webhook Encryption Public Key Details

The webhook encryption public key is used to verify the webhook content signature.

Properties
  • id
    The ID of encryption key
    String
  • publicKey
    The BASE64 encoded public key
    String

4.17.2Webhook Identity Details

The webhook identity represents a set of keys that will be used to sign the webhook messages.

Properties
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 50 chars
    The name used to identify the webhook identity.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.17.3Webhook Listener Details

Properties
  • enablePayloadSignatureAndState
    Whether signature header and state property are enabled in webhook payload.
    Boolean
  • entity
    The entity that is to be monitored.
  • entityStates
    The entity's target states that are to be monitored.
    Collection of String
  • id
    A unique identifier for the object.
    Long
  • identity
    The identity used to sign messages.
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 50 chars
    The name used to identify the webhook listener.
    String
  • notifyEveryChange
    Whether every update of the entity or only state changes are to be monitored.
    Boolean
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • url
    The URL where notifications about entity changes are sent to.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.17.4Webhook Listener Entity Details

Properties
  • id
    A unique identifier for the object.
    Long
  • name
    The name used to identify the webhook listener entity.
    Map of String String
  • technicalName
    The name used to programmatically identify the webhook listener entity.
    String

4.17.5Webhook URL Details

Properties
  • applicationManaged
    Whether the webhook URL is managed by the application, and therefore cannot be changed via the user interface.
    Boolean
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 50 chars
    The name used to identify the webhook URL.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • url
    9 - 500 options
    URL
    The actual URL where notifications about entity changes are sent to.
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer