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: /space/1/payment/transaction/987/iframe?paymentMeanConfigurationId=123

  6. Authentication-Key: OWOMg2gnaSx1nukAM6SN2vxedfY1yLPONvcTKbhDv7I

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

1|2481632|1425387916|GET|/space/1/payment/transaction/987/iframe?paymentMeanConfigurationId=123

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, 0x73, 0x70, 0x61, 0x63, 0x65, 0x2f,
0x31, 0x2f, 0x70, 0x61, 0x79, 0x6d, 0x65, 0x6e, 0x74, 0x2f, 0x74, 0x72, 0x61, 0x6e, 0x73, 0x61,
0x63, 0x74, 0x69, 0x6f, 0x6e, 0x2f, 0x39, 0x38, 0x37, 0x2f, 0x69, 0x66, 0x72, 0x61, 0x6d, 0x65,
0x3f, 0x70, 0x61, 0x79, 0x6d, 0x65, 0x6e, 0x74, 0x4d, 0x65, 0x61, 0x6e, 0x43, 0x6f, 0x6e, 0x66,
0x69, 0x67, 0x75, 0x72, 0x61, 0x74, 0x69, 0x6f, 0x6e, 0x49, 0x64, 0x3d, 0x31, 0x32, 0x33

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:

0x1c, 0x71, 0x91, 0xd8, 0x34, 0x2a, 0xaa, 0x37, 0x7f, 0x3f, 0x97, 0x06, 0x9d, 0xa5, 0x7c, 0x03,
0x62, 0xbb, 0x69, 0x31, 0x05, 0xa7, 0xed, 0xfd, 0xd6, 0x1e, 0x74, 0x03, 0x26, 0x83, 0xd5, 0x88,
0x70, 0x35, 0xa3, 0xe3, 0xbf, 0x0f, 0xeb, 0xef, 0x4c, 0x11, 0xdf, 0x15, 0x81, 0xe7, 0xd3, 0x53,
0x83, 0x1d, 0xc5, 0x88, 0x04, 0x14, 0x77, 0x2f, 0xaf, 0x2d, 0xef, 0x20, 0xe1, 0x3e, 0x3c, 0x0e

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

HHGR2DQqqjd/P5cGnaV8A2K7aTEFp+391h50AyaD1YhwNaPjvw/r70wR3xWB59NTgx3FiAQUdy+vLe8g4T48Dg==

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|/space/1/payment/transaction/987/iframe?paymentMeanConfigurationId=123", $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|/space/1/payment/transaction/987/iframe?paymentMeanConfigurationId=123";

		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", "/space/1/payment/transaction/987/iframe?paymentMeanConfigurationId=123", 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.2Search

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.3Delete

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.4Create

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.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/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.6Count

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.2Metric Usage Service

The metric usage service allows to query used resources.

3.1.2.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.3Space Service

3.1.3.1Read

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.3.2Search

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.3.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.3.4Create

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.3.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/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.3.6Count

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.2Debt Collection

3.2.1Debt Collection Case Service

3.2.1.1Documents

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.2.1.2Mark 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.2.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.2.1.4Add 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.2.1.5Attach 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.2.1.6Read

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.2.1.7Close

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.2.1.8Search

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.2.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.2.1.10Create

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.2.1.11Update

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.2.1.12Count

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.2.2Debt Collector Configuration Service

3.2.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.2.2.2Search

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.2.2.3Count

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.2.3Debt Collector Service

3.2.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.2.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.3Document

3.3.1Document Template Service

3.3.1.1Read

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.3.1.2Search

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.3.1.3Count

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.3.2Document Template Type

3.3.2.1Read

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.3.2.2All

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.4Installment

3.4.1Installment Payment Service

3.4.1.1Create 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.4.1.2Count

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.4.1.3Read

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.4.1.4Search

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.4.2Installment Payment Slice Service

3.4.2.1Count

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.4.2.2Read

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.4.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.4.3Installment Plan Calculation Service

3.4.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.4.4Installment Plan Configuration Service

3.4.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.4.4.2Read

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.4.4.3Search

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.4.5Installment Plan Slice Configuration

3.4.5.1Count

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.4.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.4.5.3Search

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.5Internationalization

3.5.1Country Service

3.5.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.5.2Country State Service

3.5.2.1Find 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.5.2.2All

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.5.3Currency Service

3.5.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.5.4Language Service

3.5.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}
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}
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.5.5Legal Organization Form Service

3.5.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.5.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.5.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.6Label

3.6.1Label Descriptor Group Service

3.6.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.6.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.6.2Label Descriptor Service

3.6.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.6.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.6.3Static Value Service

3.6.3.1Read

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.6.3.2All

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.7Manual Task

3.7.1Manual Task Service

3.7.1.1Read

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.7.1.2Search

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.7.1.3Count

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.8Payment

3.8.1Card 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.8.1.1Process

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.8.1.2Process 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.8.2Charge Attempt Service

3.8.2.1Read

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.8.2.2Search

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.8.2.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.8.3Charge Flow Level Service

3.8.3.1Send 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.8.3.2Read

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.8.3.3Search

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.8.3.4Count

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.8.4Charge Flow Service

3.8.4.1applyFlow

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.8.4.2updateRecipient

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.8.4.3Read

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.8.4.4Search

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.8.4.5Count

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.8.5Condition Type Service

3.8.5.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.8.5.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.8.6Delivery Indication Service

3.8.6.1markAsSuitable

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.8.6.2markAsNotSuitable

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.8.6.3Read

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.8.6.4Search

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.8.6.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.8.7Payment Connector Configuration Service

3.8.7.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.8.7.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.8.7.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.8.8Payment Connector Service

3.8.8.1Read

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.8.8.2All

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.8.9Payment Link Service

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

3.8.9.1Read

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.8.9.2Search

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.8.9.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.8.9.4Create

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.8.9.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/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.8.9.6Count

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.8.10Payment Method Configuration Service

3.8.10.1Read

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.8.10.2Search

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.8.10.3Count

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.8.11Payment Method Service

3.8.11.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.8.11.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.8.12Payment Processor Configuration Service

3.8.12.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.8.12.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.8.12.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.8.13Payment Processor Service

3.8.13.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.8.13.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.8.14Refund Service

3.8.14.1fail

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.8.14.2succeed

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.8.14.3getRefundDocumentWithTargetMediaType

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.8.14.4getRefundDocument

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.8.14.5Read

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.8.14.6create

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

POST /api/refund/refund View in Client
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.8.14.7Search

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.8.14.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.8.15Token Service

3.8.15.1Create 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.8.15.2Read

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.8.15.3Search

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.8.15.4Delete

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.8.15.5Create

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.8.15.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/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.8.15.7Count

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.8.16Token Version Service

3.8.16.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.8.16.2Read

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.8.16.3Search

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.8.16.4Count

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.8.17Transaction Completion Service

3.8.17.1completeOffline

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
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.8.17.2completeOnline

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
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.8.17.3Read

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.8.17.4Search

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.8.17.5Count

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.8.18Transaction Invoice Service

3.8.18.1Mark 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.8.18.2Mark 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.8.18.3isReplacementPossible

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.8.18.4getInvoiceDocumentWithTargetMediaType

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.8.18.5getInvoiceDocument

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.8.18.6replace

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.8.18.7Read

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.8.18.8Search

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.8.18.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.8.19Transaction Service

3.8.19.1Export

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.8.19.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.8.19.3getInvoiceDocument

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.8.19.4getPackingSlip

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.8.19.5Create 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.8.19.6Build 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/buildPaymentPageUrl 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.8.19.7Build JavaScript URL

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

GET /api/transaction/buildJavaScriptUrl 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.8.19.8Fetch Possible Payment Methods

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

GET /api/transaction/fetchPossiblePaymentMethods 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.8.19.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/fetchPossiblePaymentMethodsWithCredentials 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.8.19.10Build Mobile SDK URL with Credentials

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/buildMobileSdkUrlWithCredentials 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.8.19.11Fetch 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.8.19.12Delete 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.8.19.13Process One-Click Token with Credentials

This operation assigns the given token to the transaction and process it.

POST /api/transaction/processOneClickTokenWithCredentials 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.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a 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.19.14Read 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.8.19.15Process 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.8.19.16getLatestTransactionLineItemVersion

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.8.19.17updateTransactionLineItems

POST /api/transaction/updateTransactionLineItems 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.8.19.18Read

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.8.19.19Search

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.8.19.20Create

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.8.19.21Update

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.8.19.22Count

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.8.20Transaction Void Service

3.8.20.1voidOnline

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.8.20.2voidOffline

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.8.20.3Read

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.8.20.4Search

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.8.20.5Count

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.9Subscription

3.9.1Subscriber Service

3.9.1.1Read

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.9.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.9.1.3Delete

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.9.1.4Create

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.9.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.9.1.6Count

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.9.2Subscription Affiliate Service

3.9.2.1Read

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.9.2.2Search

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.9.2.3Delete

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.9.2.4Create

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.9.2.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-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.9.2.6Count

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.9.3Subscription Charge Service

3.9.3.1discard

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.9.3.2Read

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.9.3.3Create

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.9.3.4Search

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.9.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.9.4Subscription Metric Service

3.9.4.1Read

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.9.4.2Delete

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.9.4.3Search

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.9.4.4Create

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.9.4.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-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.9.4.6Count

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.9.5Subscription Metric Usage Report Service

3.9.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.9.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.9.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.9.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.9.6Subscription Period Bill Service

3.9.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.9.6.2Search

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.9.6.3Count

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.9.7Subscription Product Component Group Service

3.9.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.9.7.2Search

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.9.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.9.7.4Create

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.9.7.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-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.9.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.9.8Subscription Product Component Service

3.9.8.1Read

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.9.8.2Search

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.9.8.3Delete

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.9.8.4Create

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.9.8.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-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.9.8.6Count

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.9.9Subscription Product Metered Fee Service

3.9.9.1Read

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.9.9.2Search

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.9.9.3Delete

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.9.9.4Create

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.9.9.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-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.9.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.9.10Subscription Product Metered Tier Fee Service

3.9.10.1Read

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.9.10.2Search

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.9.10.3Delete

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.9.10.4Create

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.9.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.9.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.9.11Subscription Product Period Fee Service

3.9.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.9.11.2Search

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.9.11.3Delete

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.9.11.4Create

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.9.11.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-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.9.11.6Count

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.9.12Subscription Product Retirement Service

3.9.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.9.12.2Create

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.9.12.3Search

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.9.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.9.13Subscription Product Service

3.9.13.1Read

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.9.13.2Search

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.9.13.3Create

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.9.13.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/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.9.13.5Count

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.9.14Subscription Product Setup Fee Service

3.9.14.1Read

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.9.14.2Search

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.9.14.3Delete

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.9.14.4Create

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.9.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.9.14.6Count

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.9.15Subscription Product Version Retirement Service

3.9.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.9.15.2Create

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.9.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.9.15.4Count

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.9.16Subscription Product Version Service

3.9.16.1activate

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.9.16.2Read

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.9.16.3Search

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.9.16.4Create

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.9.16.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-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.9.16.6Count

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.9.17Subscription Service

3.9.17.1terminate

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.9.17.2apply 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.9.17.3initializeSubscriberPresent

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.9.17.4update 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.9.17.5Read

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.9.17.6Create

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.9.17.7Search

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.9.17.8initialize

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.9.17.9Count

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.9.18Subscription Suspension Service

3.9.18.1terminate

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.9.18.2Read

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.9.18.3Create

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.9.18.4Search

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.9.18.5Count

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.9.19Subscription Version Service

3.9.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.9.19.2Search

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.9.19.3Count

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.9.20Subscription ledger entry Service

3.9.20.1Read

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.9.20.2Create

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.9.20.3Search

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.9.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.10User

3.10.1Application User Service

3.10.1.1Read

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.10.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.10.1.3Create

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.10.1.4Search

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.10.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.10.1.6Count

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.10.2Human User Service

3.10.2.1Export

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.10.2.2Read

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.10.2.3Search

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.10.2.4Delete

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.10.2.5Create

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.10.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.10.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.10.3Permission Service

3.10.3.1Read

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.10.3.2All

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.10.4User Account Role Service

3.10.4.1Add 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.10.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.10.4.3List 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.10.5User Space Role Service

3.10.5.1Add 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.10.5.2Remove 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.10.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.11Webhook

3.11.1Webhook Listener Service

3.11.1.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.11.1.2Search

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.11.1.3Delete

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.11.1.4Create

Creates the entity with the given properties.

POST /api/webhook-listener/create View in Client
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.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/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.11.1.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.11.2Webhook Url Service

3.11.2.1Read

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.11.2.2Search

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.11.2.3Delete

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.11.2.4Create

Creates the entity with the given properties.

POST /api/webhook-url/create View in Client
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.11.2.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/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.11.2.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.1Base

4.1.1Account Details

Properties
  • active
    Virtual
    Active means that this account and all accounts in the hierarchy are active.
    Boolean
  • activeOrRestrictedActive
    Virtual
    This property is true when all accounts in the hierarchy are active or restricted active.
    Boolean
  • id
    The ID is the primary key of the entity. The ID identifies the entity uniquely.
    Long
  • name
    3 to 200 characters
    Printable characters, no line breaks
    The name of the account identifies the account within the administrative interface.
    String
  • parentAccount
    Virtual
    The account which is responsible for administering the account.
  • plannedPurgeDate
    The planned purge date indicates when the entity is permanently removed. When the date is null the entity is not planned to be removed.
    DateTime
  • restrictedActive
    Virtual
    Restricted active means that at least one account in the hierarchy is only restricted active, but all are either restricted active or active.
    Boolean
  • scope
    This is the scope to which the account belongs to.
    Long
  • state
  • subaccountLimit
    This property restricts the number of subaccounts which can be created within this account.
    Long
  • type
    The account type defines which role and capabilities it has.
  • version
    The version number indicates the version of the entity. The version is incremented whenever the entity is changed.
    Integer

4.1.2Account State

Fields
  • CREATE
    Create
  • RESTRICTED_ACTIVE
    Restricted Active
  • ACTIVE
    Active
  • INACTIVE
    Inactive
  • DELETING
    Deleting
  • DELETED
    Deleted

4.1.3Account Type

Fields
  • MASTER
    Master
  • REGULAR
    Regular
  • SUBACCOUNT
    Subaccount

4.1.4Address Details

Properties
  • city
    Max. 100 characters
    Printable characters, no line breaks
    String
  • commercialRegisterNumber
    Max. 100 characters
    Printable characters, no line breaks
    String
  • country
    String
  • dateOfBirth
    Date
  • dependentLocality
    Max. 100 characters
    Printable characters, no line breaks
    String
  • emailAddress
    Email address
    Max. 254 characters
    Printable characters, no line breaks
    String
  • familyName
    Max. 100 characters
    Printable characters, no line breaks
    String
  • gender
  • givenName
    Max. 100 characters
    Printable characters, no line breaks
    String
  • legalOrganizationForm
  • mobilePhoneNumber
    Max. 100 characters
    String
  • organizationName
    Max. 100 characters
    Printable characters, no line breaks
    String
  • phoneNumber
    Max. 100 characters
    String
  • postCode
    Max. 40 characters
    Printable characters, no line breaks
    String
  • postalState
    String
  • salesTaxNumber
    Max. 100 characters
    Printable characters, no line breaks
    String
  • salutation
    Max. 20 characters
    Printable characters, no line breaks
    String
  • socialSecurityNumber
    Max. 100 characters
    Printable characters, no line breaks
    String
  • sortingCode
    Max. 100 characters
    Printable characters, no line breaks
    The sorting code identifies the post office at which the post box is located in.
    String
  • street
    Max. 300 characters
    Printable characters
    String

4.1.5Creation Entity State

Fields
  • CREATE
    Create
  • ACTIVE
    Active
  • INACTIVE
    Inactive
  • DELETING
    Deleting
  • DELETED
    Deleted

4.1.6Criteria Operator

Fields
  • EQUALS
    Equals
  • GREATER_THAN
    Greater Than
  • GREATER_THAN_OR_EQUAL
    Greater Than Or Equal
  • LESS_THAN
    Less Than
  • LESS_THAN_OR_EQUAL
    Less Than Or Equal
  • CONTAINS
    Contains
  • NOT_EQUALS
    Not Equals
  • NOT_CONTAINS
    Not Contains
  • IS_NULL
    Is Null
  • IS_NOT_NULL
    Is Not Null

4.1.7Database Details

Properties
  • id
    The ID is the primary key of the entity. The ID identifies the entity uniquely.
    Long
  • name
    Max. 200 characters
    Printable characters, no line breaks
    The name of the database.
    String
  • version
    The version number indicates the version of the entity. The version is incremented whenever the entity is changed.
    Integer

4.1.8Environment

Fields
  • LIVE
    Live
  • PREVIEW
    Preview

4.1.9Failure Category

Fields
  • TEMPORARY_ISSUE
    Temporary Issue
  • INTERNAL
    Internal
  • END_USER
    End User
  • CONFIGURATION
    Configuration
  • DEVELOPER
    Developer

4.1.10Failure Reason Details

Properties
  • category
  • description
    Map of String String
  • features
    Collection of Long
  • id
    The ID is the primary key of the entity. The ID identifies the entity uniquely.
    Long
  • name
    Map of String String

4.1.11Feature Details

Properties
  • beta
    Boolean
  • description
    Map of String String
  • id
    The ID is the primary key of the entity. The ID identifies the entity uniquely.
    Long
  • logoPath
    String
  • name
    Map of String String
  • requiredFeatures
    Collection of Long
  • sortOrder
    Integer
  • visible
    Boolean

4.1.12Gender

Fields
  • MALE
    Male
  • FEMALE
    Female

4.1.13Line 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
  • name
    1 to 150 characters
    Printable characters, no line breaks
    String
  • quantity
    Positive value
    Decimal
  • shippingRequired
    Boolean
  • sku
    Max. 200 characters
    Printable characters, no line breaks
    String
  • taxAmount
    Virtual
    Decimal
  • taxAmountPerUnit
    Virtual
    Decimal
  • taxes
    Collection of Tax
  • type
  • uniqueId
    Max. 200 characters
    Printable characters, no line breaks
    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.1.14Line Item Attribute Details

Properties
  • label
    Max. 512 characters
    String
  • value
    Max. 512 characters
    String

4.1.15Line Item Reduction Details

Properties
  • lineItemUniqueId
    Max. 200 characters
    Printable characters, no line breaks
    The unique id identifies the line item on which the reduction is applied on.
    String
  • quantityReduction
    Positive value
    Decimal
  • unitPriceReduction
    Decimal

4.1.16Line Item Type

Fields
  • SHIPPING
    Shipping
  • DISCOUNT
    Discount
  • FEE
    Fee
  • PRODUCT
    Product

4.1.17Metric 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.1.18Resource Path Details

Properties
  • id
    The ID is the primary key of the entity. The ID identifies the entity uniquely.
    Long
  • linkedSpaceId
    The linked space id holds the ID of the space to which the entity belongs to.
    Long
  • path
    4 to 500 characters
    Printable ASCII characters
    String
  • plannedPurgeDate
    The planned purge date indicates when the entity is permanently removed. When the date is null the entity is not planned to be removed.
    DateTime
  • spaceId
    Long
  • state
  • version
    The version number indicates the version of the entity. The version is incremented whenever the entity is changed.
    Integer

4.1.19Resource State

Fields
  • ACTIVE
    Active
  • DELETING
    Deleting
  • DELETED
    Deleted

4.1.20Scope Details

Properties
  • domainName
    Max. 40 characters
    Printable characters, no line breaks
    The domain name to which this scope is mapped to.
    String
  • features
    Collection of Feature
  • id
    The ID is the primary key of the entity. The ID identifies the entity uniquely.
    Long
  • name
    Max. 50 characters
    Printable characters, no line breaks
    The name of the scope is shown to the user where the user should select a scope.
    String
  • plannedPurgeDate
    The planned purge date indicates when the entity is permanently removed. When the date is null the entity is not planned to be removed.
    DateTime
  • port
    Min. 1
    The port number to which this scope is mapped to.
    Integer
  • sslActive
    Define whether the scope supports SSL.
    Boolean
  • state
  • themes
    The themes determines how the application layout, look and feel is. By providing multiple themes you can fallback to other themes.
    Collection of String
  • url
    Virtual
    String
  • version
    The version number indicates the version of the entity. The version is incremented whenever the entity is changed.
    Integer

4.1.21Space Details

Properties
  • account
    The account to which the space belongs to.
  • active
    Virtual
    Active means that this account and all accounts in the hierarchy are active.
    Boolean
  • activeOrRestrictedActive
    Virtual
    This property is true when all accounts in the hierarchy are active or restricted active.
    Boolean
  • database
    The database in which the space's data are stored in.
  • id
    The ID is the primary key of the entity. The ID identifies the entity uniquely.
    Long
  • name
    3 to 200 characters
    Printable characters, no line breaks
    The space name is used internally to identify the space in administrative interfaces. For example it is used within search fields and hence it should be distinct and descriptive.
    String
  • plannedPurgeDate
    The planned purge date indicates when the entity is permanently removed. When the date is null the entity is not planned to be removed.
    DateTime
  • postalAddress
    The address to use in communication with clients for example in email, documents etc.
  • requestLimit
    The request limit defines the maximum number of API request accepted within 2 minutes for this space. This limit can only be changed with special privileges.
    Long
  • restrictedActive
    Virtual
    Restricted active means that at least one account in the hierarchy is only restricted active, but all are either restricted active or active.
    Boolean
  • state
  • technicalContactAddresses
    The email address provided as contact addresses will be informed about technical issues or errors triggered by the space.
    Collection of String
  • timeZone
    The time zone assigned to the space determines the time offset for calculating dates within the space. This is typically used for background processed which needs to be triggered on a specific hour within the day. Changing the space time zone will not change the display of dates.
    String
  • version
    The version number indicates the version of the entity. The version is incremented whenever the entity is changed.
    Integer

4.1.22Space Address Details

Properties
  • city
    String
  • country
    String
  • dependentLocality
    Max. 100 characters
    Printable characters, no line breaks
    String
  • emailAddress
    The email address is used within emails and as reply to address.
    String
  • familyName
    Max. 100 characters
    Printable characters, no line breaks
    String
  • givenName
    Max. 100 characters
    Printable characters, no line breaks
    String
  • organizationName
    Max. 100 characters
    Printable characters, no line breaks
    String
  • postCode
    String
  • postalState
    String
  • salesTaxNumber
    Max. 100 characters
    Printable characters, no line breaks
    String
  • salutation
    Max. 20 characters
    Printable characters, no line breaks
    String
  • sortingCode
    Max. 100 characters
    Printable characters, no line breaks
    The sorting code identifies the post office at which the post box is located in.
    String
  • street
    String

4.1.23Space Reference Details

Properties
  • createdOn
    DateTime
  • id
    The ID is the primary key of the entity. The ID identifies the entity uniquely.
    Long
  • linkedSpaceId
    The linked space id holds the ID of the space to which the entity belongs to.
    Long
  • plannedPurgeDate
    The planned purge date indicates when the entity is permanently removed. When the date is null the entity is not planned to be removed.
    DateTime
  • spaceId
    Long
  • state
  • version
    The version number indicates the version of the entity. The version is incremented whenever the entity is changed.
    Integer

4.1.24Space Reference State

Fields
  • RESTRICTED_ACTIVE
    Restricted Active
  • ACTIVE
    Active
  • INACTIVE
    Inactive
  • DELETING
    Deleting
  • DELETED
    Deleted

4.1.25Space View Details

Properties
  • id
    The ID is the primary key of the entity. The ID identifies the entity uniquely.
    Long
  • linkedSpaceId
    The linked space id holds the ID of the space to which the entity belongs to.
    Long
  • name
    3 to 200 characters
    Printable characters, no line breaks
    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 planned purge date indicates when the entity is permanently removed. When the date is null the entity is not planned to be removed.
    DateTime
  • space
    The space to which the view belongs to.
  • state
  • version
    The version number indicates the version of the entity. The version is incremented whenever the entity is changed.
    Integer

4.2Debt Collection

4.2.1Condition Details

A condition controls under which circumstances a collector configuration is applied to a debt collection case.

Properties
  • id
    The ID is the primary key of the entity. The ID identifies the entity uniquely.
    Long
  • linkedSpaceId
    The linked space id holds the ID of the space to which the entity belongs to.
    Long
  • name
    Max. 100 characters
    Printable characters, no line breaks
    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 planned purge date indicates when the entity is permanently removed. When the date is null the entity is not planned to be removed.
    DateTime
  • state
  • type
    The condition type determines the condition realization.
  • version
    The version number indicates the version of the entity. The version is incremented whenever the entity is changed.
    Integer

4.2.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 created on date indicates the date on which the entity was stored into the database.
    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
    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
    The failed on date indicates when the case is failed on.
    DateTime
  • failureReason
  • id
    The ID is the primary key of the entity. The ID identifies the entity uniquely.
    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
    The linked space id holds the ID of the space to which the entity belongs to.
    Long
  • nextAttemptOn
    DateTime
  • plannedPurgeDate
    The planned purge date indicates when the entity is permanently removed. When the date is null the entity is not planned to 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
  • version
    The version number indicates the version of the entity. The version is incremented whenever the entity is changed.
    Integer