Documentation

1Introduction

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

1.1Type System

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

Long

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

Integer

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

String

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

Boolean

A boolean holds either true or false.

Decimal

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

Date

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

DateTime

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

Duration

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

Complex Object

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

Collection

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

Binary

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

1.2Object Versioning / Locking

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

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

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

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

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

1.3Entity Search

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

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

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

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

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

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

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

1.4Machine-readable API Definition / Swagger

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

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

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

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

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

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

1.5SDK

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

1.6Meta Data

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

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

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

  • A key cannot be longer as 40 chars.

  • A value cannot be longer as 512 chars.

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

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

2Authentication

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

2.1Basics

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

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

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

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

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

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

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

2.2Getting the User ID and Authentication Key

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

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

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

2.3Calculating the Time Stamp

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

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

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

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

2.4Calculating the MAC Value

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

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

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

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

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

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

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

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

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

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

2.5Example

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

  1. x-mac-version header: 1

  2. x-mac-userid header: 2481632

  3. x-mac-timestamp header: 1425387916

  4. Method: GET

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

  6. Authentication-Key: OWOMg2gnaSx1nukAM6SN2vxedfY1yLPONvcTKbhDv7I=

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

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

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

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

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

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

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

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

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

tz7RqRBH8GEw29tj2/x76opKmlbthgSFJLqiwkKIUQlKiM1HaHeisC/IQzaEgALMgwSI0kvJdPAmbS11oxzz4Q==

2.5.1PHP

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

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

2.5.2Java

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

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

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

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

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

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

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

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

2.5.3Python

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

import hashlib
import hmac
import base64

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

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

2.6MAC Calculation Illustrated

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

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

2.7Request Logging

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

3Services

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

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

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

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

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

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

3.1Core

3.1.1Account Service

3.1.1.1Create

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

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

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

3.1.1.3Read

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

Searches for the entities as specified by the given query.

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

3.1.1.5Delete

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.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/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.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.1Update

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

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

3.1.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.5Read

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.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.2Customer

3.2.1Customer Address Service

3.2.1.1Create

Creates the entity with the given properties.

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

3.2.1.2Update

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

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

3.2.1.3Count

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

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

3.2.1.4Search

Searches for the entities as specified by the given query.

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

3.2.1.5Read

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

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

3.2.1.6Delete

Deletes the entity with the given id.

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

3.2.1.7selectDefaultAddress

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

3.2.2Customer Comment Service

3.2.2.1Create

Creates the entity with the given properties.

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

3.2.2.2pinComment

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

3.2.2.3Count

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

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

3.2.2.4unpinComment

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

3.2.2.5Read

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

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

3.2.2.6Search

Searches for the entities as specified by the given query.

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

3.2.2.7Delete

Deletes the entity with the given id.

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

3.2.2.8Update

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

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

3.2.3Customer Service

3.2.3.1Read

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

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

3.2.3.2Update

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

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

3.2.3.3Search

Searches for the entities as specified by the given query.

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

3.2.3.4Count

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

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

3.2.3.5Delete

Deletes the entity with the given id.

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

3.2.3.6Create

Creates the entity with the given properties.

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

3.3Internationalization

3.3.1Country Service

3.3.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.3.2Country State Service

3.3.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.3.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.3.3Currency Service

3.3.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.3.4Language Service

3.3.4.1All

This operation returns all languages.

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

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

3.3.5Legal Organization Form Service

3.3.5.1Read

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.3.5.2Find 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.3.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.4Label

3.4.1Label Descriptor Group Service

3.4.1.1All

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

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.4.2Label Descriptor Service

3.4.2.1All

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

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.4.3Static Value Service

3.4.3.1All

This operation returns all entities which are available.

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

3.4.3.2Read

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

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

3.5Manual Task

3.5.1Manual Task Service

3.5.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.5.1.2Count

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

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

3.5.1.3Search

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

3.6.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.6.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.6.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.6.2Charge Attempt Service

3.6.2.1Count

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

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

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

3.6.2.3Search

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.6.3Charge Flow Level Payment Link Service

3.6.3.1Read

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

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

3.6.3.2Count

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

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

3.6.3.3Search

Searches for the entities as specified by the given query.

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

3.6.4Charge Flow Level Service

3.6.4.1Read

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

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

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.6.4.4Send 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.6.5Charge Flow Service

3.6.5.1Cancel Charge Flow

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

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

3.6.5.2Fetch Charge Flow Payment Page URL

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

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

3.6.5.3Search

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

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

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.6.5.6applyFlow

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

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

3.6.6.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.6.6.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.
  • 442
    Error
    This status code indicates that the server cannot or will not process the request due to something that is perceived to be a 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.7Delivery Indication Service

3.6.7.1markAsNotSuitable

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.6.7.2markAsSuitable

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

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

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

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

3.6.8.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.6.8.2Count

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

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.6.9Payment Connector Service

3.6.9.1All

This operation returns all entities which are available.

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

3.6.9.2Read

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

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

3.6.10Payment Link Service

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

3.6.10.1Update

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

POST /api/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.6.10.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.6.10.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.6.10.4Read

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

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

3.6.10.5Create

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.6.10.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.6.11Payment Method Brand Service

3.6.11.1Read

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

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

3.6.11.2All

This operation returns all entities which are available.

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

3.6.12Payment Method Configuration Service

3.6.12.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.6.12.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.6.12.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.6.13Payment Method Service

3.6.13.1All

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

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.6.14Payment Processor Configuration Service

3.6.14.1Search

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

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

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.6.15Payment Processor Service

3.6.15.1All

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

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.6.16Refund Comment Service

3.6.16.1Read

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

GET /api/refund-comment/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the comment 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.16.2Delete

Deletes the comment with the given id.

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

3.6.16.3Update

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

POST /api/refund-comment/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The comment 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.6.16.4Create

Creates the comment with the given properties.

POST /api/refund-comment/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The comment 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.6.16.5Unpin

Unpins the comment from the top.

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

3.6.16.6Find by refund

Returns all comments of the given refund.

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

3.6.16.7Pin

Pins the comment to the top.

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

3.6.17Refund Service

3.6.17.1Read

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.6.17.2fail

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

import java.math.BigDecimal;

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

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

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

    // Models
    private TransactionCreate transactionPayload;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

    return transactionPayload;
}

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

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

3.6.17.7getRefundDocumentWithTargetMediaType

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.6.17.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.6.18Transaction Comment Service

3.6.18.1Read

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

GET /api/transaction-comment/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the comment 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.18.2Delete

Deletes the comment with the given id.

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

3.6.18.3Update

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

POST /api/transaction-comment/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The comment 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.6.18.4Unpin

Unpins the comment from the top.

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

3.6.18.5Find by transaction

Returns all comments of the transaction.

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

3.6.18.6Pin

Pins the comment to the top.

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

3.6.18.7Create

Creates the comment with the given properties.

POST /api/transaction-comment/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The comment 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.6.19Transaction Completion Service

3.6.19.1completeOnline

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

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

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

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

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

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

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

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

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

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

import java.math.BigDecimal;

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

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

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

    // Models
    private TransactionCreate transactionPayload;

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

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

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

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

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

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

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

        private TransactionCompletionService TransactionCompletionService;
        private TransactionService TransactionService;


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

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

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

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

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

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

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

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

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

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

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

    return transactionPayload;
}

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

3.6.19.2completePartiallyOffline

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

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

3.6.19.3Count

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.6.19.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.6.19.5completePartiallyOnline

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

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

3.6.19.6completeOffline

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

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

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

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

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

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

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

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

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

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

import java.math.BigDecimal;

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

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

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

    // Models
    private TransactionCreate transactionPayload;

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

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

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

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

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

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

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

        private TransactionCompletionService TransactionCompletionService;
        private TransactionService TransactionService;


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

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

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

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

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

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

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

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

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

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

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

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

    return transactionPayload;
}

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

3.6.19.7Read

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.6.20Transaction Iframe Service

3.6.20.1Build JavaScript URL

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

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

3.6.21Transaction Invoice Comment Service

3.6.21.1Unpin

Unpins the comment from the top.

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

3.6.21.2Pin

Pins the comment to the top.

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

3.6.21.3Delete

Deletes the comment with the given id.

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

3.6.21.4Update

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

POST /api/transaction-invoice-comment/update View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The comment 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.6.21.5Create

Creates the comment with the given properties.

POST /api/transaction-invoice-comment/create View in Client
Query Parameters
  • spaceId
    *
    Long
Message Body *
The comment 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.6.21.6Read

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

GET /api/transaction-invoice-comment/read View in Client
Query Parameters
  • spaceId
    *
    Long
  • id
    *
    The id of the comment 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.21.7Find by invoice

Returns all comments of the given transaction invoice.

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

3.6.22Transaction Invoice Service

3.6.22.1Search

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

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

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.6.22.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.6.22.5replace

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.6.22.6isReplacementPossible

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.6.22.7Mark 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.6.22.8getInvoiceDocument

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.6.22.9Mark 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.6.23Transaction Lightbox Service

3.6.23.1Build JavaScript URL

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

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

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

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

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

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

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

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

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

import java.math.BigDecimal;

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

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

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

    // Models
    private TransactionCreate transactionPayload;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    }

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

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

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

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

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

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

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

    return transactionPayload;
}

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

3.6.24Transaction Line Item Version Service

3.6.24.1create

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

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

3.6.24.2Count

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

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

3.6.24.3Search

Searches for the entities as specified by the given query.

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

3.6.24.4Read

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

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

3.6.25Transaction Mobile SDK Service

3.6.25.1Build Mobile SDK URL

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

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

3.6.26Transaction Payment Page Service

3.6.26.1Build Payment Page URL

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

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

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

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

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

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

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

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

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

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

import java.math.BigDecimal;

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

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

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

    // Models
    private TransactionCreate transactionPayload;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    return transactionPayload;
}

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

3.6.27Transaction Service

3.6.27.1Process 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.6.27.2Search

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

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.6.27.4Fetch 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.6.27.5Process One-Click Token with Credentials

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

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

3.6.27.6Confirm

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: twispay.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.6.27.7Fetch Possible Payment Methods

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

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

3.6.27.8Create

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: twispay.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.6.27.9Fetch Possible Payment Methods with Credentials

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

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

3.6.27.10Create 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.6.27.11Export

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

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.6.27.13getLatestSuccessfulTransactionLineItemVersion

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.6.27.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.6.27.15Delete 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.6.27.16getInvoiceDocument

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

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

3.6.28.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.6.28.2Search

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.6.28.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.6.28.4Count

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

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.7Shopify

3.7.1Shopify Transaction Service

3.7.1.1Count

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

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

3.7.1.2Search

Searches for the entities as specified by the given query.

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

3.7.1.3Read

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

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

3.8User

3.8.1Application User Service

3.8.1.1Count

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

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

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

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.8.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.8.1.6Create

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

3.8.2.1Update

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

POST /api/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.8.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.8.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.8.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.8.2.5Count

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

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.8.2.7Export

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.8.3Permission Service

3.8.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.8.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.8.4User Account Role Service

3.8.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.8.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.8.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.8.5User Space Role Service

3.8.5.1Remove Role

This operation removes the specified user space role.

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

3.8.5.2Add Role

This operation grants the given role to the user in the given space.

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

3.8.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.9Webhook

3.9.1Webhook Encryption Service

3.9.1.1Read

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

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

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.1Core

4.1.1Account Details

Properties
  • active
    Virtual
    Whether this account and all its parent accounts are active.
    Boolean
  • activeOrRestrictedActive
    Virtual
    Whether this account and all its parent accounts are active or restricted active.
    Boolean
  • createdBy
    The ID of the user the account was created by.
    Long
  • createdOn
    The date and time when the account was created.
    DateTime
  • deletedBy
    The ID of a user the account was deleted by.
    Long
  • deletedOn
    The date and time when the account was deleted.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • lastModifiedDate
    The date and time when the object was last modified.
    DateTime
  • name
    3 - 200 chars
    The name used to identify the account.
    String
  • parentAccount
    Virtual
    The parent account responsible for administering this account.
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • restrictedActive
    Virtual
    Whether this account and all its parent accounts are active or restricted active. There is at least one account that is restricted active.
    Boolean
  • scope
    The scope that the account belongs to.
    Long
  • state
    The object's current state.
  • subaccountLimit
    The number of sub-accounts that can be created within this account.
    Long
  • type
    The account's type which defines its role and capabilities.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.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.4Creation Entity State

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

4.1.5Criteria Operator

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

4.1.6Database Details

Properties
  • id
    A unique identifier for the object.
    Long
  • name
    ≤ 200 chars
    The name used to identify the database.
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.1.7Environment

Fields
  • LIVE
    Live
  • PREVIEW
    Preview

4.1.8Failure Category

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

4.1.9Failure Reason Details

Properties
  • category
    The category that the failure reason belongs to.
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.1.10Feature Details

Properties
  • beta
    Whether the feature is in beta stage and there may still be some issues.
    Boolean
  • category
    The category that the feature belongs to.
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • logoPath
    The path to the feature's logo image.
    String
  • name
    The localized name of the object.
    Map of String String
  • requiredFeatures
    The features that must be enabled for this feature to work properly.
    Collection of Long
  • sortOrder
    When listing features, they can be sorted by this number.
    Integer
  • visible
    Boolean

4.1.11Feature Category Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String
  • orderWeight
    When listing feature categories, they can be sorted by this number.
    Integer

4.1.12Line Item Reduction Details

Properties
  • lineItemUniqueId
    ≤ 200 chars
    The unique id identifies the line item on which the reduction is applied on.
    String
  • quantityReduction
    Positive
    Decimal
  • unitPriceReduction
    Decimal

4.1.13Metric 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.14Resource Path Details

Properties
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • path
    4 - 500 chars
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • spaceId
    Long
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.1.15Resource State

Fields
  • ACTIVE
    Active
  • DELETING
    Deleting
  • DELETED
    Deleted

4.1.16Scope Details

Properties
  • domainName
    ≤ 40 chars
    The domain name that belongs to the scope.
    String
  • features
    The list of features that are active in the scope.
    Collection of Feature
  • id
    A unique identifier for the object.
    Long
  • machineName
    ≤ 50 chars
    ([A-Z][A-Za-z0-9]+)(_([A-Z][A-Za-z0-9]+))*
    The name identifying the scope in e.g. URLs.
    String
  • name
    ≤ 50 chars
    The name used to identify the scope.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • port
    ≥ 1
    The port where the scope can be accessed.
    Integer
  • sslActive
    Whether the scope supports SSL.
    Boolean
  • state
    The object's current state.
  • themes
    The themes that determine the look and feel of the scope's user interface. A fall-through strategy is applied when building the actual theme.
    Collection of String
  • url
    Virtual
    The URL where the scope can be accessed.
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.1.17Space Details

Properties
  • account
    The account that the space belongs to.
  • active
    Virtual
    Whether this space and all its parent accounts are active.
    Boolean
  • activeOrRestrictedActive
    Virtual
    Whether this space and all its parent accounts are active or restricted active.
    Boolean
  • createdBy
    The ID of the user the space was created by.
    Long
  • createdOn
    The date and time when the space was created.
    DateTime
  • database
    The database the space is connected to and that holds the space's data.
  • deletedBy
    The ID of the user the space was deleted by.
    Long
  • deletedOn
    The date and time when the space was deleted.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • lastModifiedDate
    The date and time when the object was last modified.
    DateTime
  • name
    3 - 200 chars
    The name used to identify the space.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • postalAddress
    The address that is used in communication with clients for example in emails, documents, etc.
  • primaryCurrency
    The currency that is used to display aggregated amounts in the space.
    String
  • requestLimit
    The maximum number of API requests that are accepted within two minutes. This limit can only be changed with special privileges.
    Long
  • restrictedActive
    Virtual
    Whether this space and all its parent accounts are active or restricted active. There is least one parent account that is restricted active.
    Boolean
  • state
    The object's current state.
  • technicalContactAddresses
    The email address that will receive messages about technical issues and errors that occur in the space.
    Collection of String
  • timeZone
    The time zone that is used to schedule and run background processes. This does not affect the formatting of dates in the user interface.
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.1.18Space Address Details

Properties
  • city
    The city, town or village.
    String
  • country
    The two-letter country code (ISO 3166 format).
    String
  • dependentLocality
    ≤ 100 chars
    The dependent locality which is a sub-division of the state.
    String
  • emailAddress
    The email address used for communication with clients.
    String
  • familyName
    ≤ 100 chars
    The family or last name.
    String
  • givenName
    ≤ 100 chars
    The given or first name.
    String
  • mobilePhoneNumber
    ≤ 100 chars
    The phone number of a mobile phone.
    String
  • organizationName
    ≤ 100 chars
    The organization's name.
    String
  • phoneNumber
    ≤ 100 chars
    The phone number.
    String
  • postalState
    The name of the region, typically a state, county, province or prefecture.
    String
  • postcode
    The postal code, also known as ZIP, postcode, etc.
    String
  • salesTaxNumber
    ≤ 100 chars
    The sales tax number of the organization.
    String
  • salutation
    ≤ 20 chars
    The salutation e.g. Mrs, Mr, Dr.
    String
  • sortingCode
    ≤ 100 chars
    The sorting code identifying the post office where the PO Box is located.
    String
  • street
    The street or PO Box.
    String

4.1.19Space View Details

Properties
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    3 - 200 chars
    The name used to identify the space view.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • space
    The space that the space view belongs to.
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.2Customer

4.2.1Customer Details

Properties
  • createdOn
    The date and time when the object was created.
    DateTime
  • customerId
    ≤ 100 chars
    The customer's ID in the merchant's system.
    String
  • emailAddress
    Email
    ≤ 254 chars
    The customer's email address.
    String
  • familyName
    ≤ 100 chars
    The customer's family or last name.
    String
  • givenName
    ≤ 100 chars
    The customer's given or first name.
    String
  • id
    A unique identifier for the object.
    Long
  • language
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • metaData
    Virtual
    Allow to store additional information about the object.
    Map of String String
  • preferredCurrency
    The customer's preferred currency.
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.2.2Customer Address Details

Properties
  • address
    The actual postal address.
  • addressType
    Whether the address is for billing or shipping or both.
  • createdOn
    The date and time when the object was created.
    DateTime
  • customer
    The customer that the object belongs to.
  • defaultAddress
    Whether this is the customer's default address.
    Boolean
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.2.3Customer Address Type

Fields
  • BILLING
    Billing
  • SHIPPING
    Shipping
  • BOTH
    Both

4.2.4Customer Comment Details

Properties
  • content
    ≤ 262,144 chars
    The comment's actual content.
    String
  • createdBy
    The ID of the user the comment was created by.
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • customer
    The customer that the object belongs to.
  • editedBy
    The ID of the user the comment was last updated by.
    Long
  • editedOn
    The date and time when the comment was last updated.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • pinned
    Whether the comment is pinned to the top.
    Boolean
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.2.5Customer Postal Address Details

Properties
  • city
    ≤ 100 chars
    The city, town or village.
    String
  • commercialRegisterNumber
    ≤ 100 chars
    The commercial registration number of the organization.
    String
  • country
    The two-letter country code (ISO 3166 format).
    String
  • dateOfBirth
    The date of birth.
    Date
  • dependentLocality
    ≤ 100 chars
    The dependent locality which is a sub-division of the state.
    String
  • emailAddress
    Email
    ≤ 254 chars
    The email address.
    String
  • familyName
    ≤ 100 chars
    The family or last name.
    String
  • gender
    The gender.
  • givenName
    ≤ 100 chars
    The given or first name.
    String
  • legalOrganizationForm
    The legal form of the organization.
  • mobilePhoneNumber
    ≤ 100 chars
    The phone number of a mobile phone.
    String
  • organizationName
    ≤ 100 chars
    The organization's name.
    String
  • phoneNumber
    ≤ 100 chars
    The phone number.
    String
  • postalState
    The name of the region, typically a state, county, province or prefecture.
    String
  • postcode
    ≤ 40 chars
    The postal code, also known as ZIP, postcode, etc.
    String
  • salesTaxNumber
    ≤ 100 chars
    The sales tax number of the organization.
    String
  • salutation
    ≤ 20 chars
    The salutation e.g. Mrs, Mr, Dr.
    String
  • socialSecurityNumber
    ≤ 100 chars
    The social security number.
    String
  • sortingCode
    ≤ 100 chars
    The sorting code identifying the post office where the PO Box is located.
    String
  • street
    ≤ 300 chars
    The street or PO Box.
    String

4.3Document

4.3.1Document Template Type Details

Properties

4.3.2Document Template Type Group Details

Properties
  • id
    A unique identifier for the object.
    Long
  • title
    Map of String String

4.3.3Rendered Document Details

Properties

4.4Entity Query

4.4.1Entity Export Request Details

The entity property export request contains the information required to create an export of a list of entities.

Properties
  • properties
    *
    The properties is a list of property paths which should be exported.
    Collection of String
  • query
    The query limits the returned entries. The query allows to restrict the entries to return and it allows to control the order of them.

4.4.2Entity Query Details

The entity query allows to search for specific entities by providing filters. This is similar to a SQL query.

Properties
  • filter
    The filter node defines the root filter node of the query. The root node may contain multiple sub nodes with different filters in it.
  • language
    The language is applied to the ordering of the entities returned. Some entity fields are language dependent and hence the language is required to order them.
    String
  • numberOfEntities
    The number of entities defines how many entities should be returned. There is a maximum of 100 entities.
    Integer
  • orderBys
    The order bys allows to define the ordering of the entities returned by the search.
  • startingEntity
    The 'starting entity' defines the entity number at which the returned result should start. The entity number is the consecutive number of the entity as returned and it is not the entity id.
    Integer

4.4.3Entity Query Filter Details

The query filter allows to restrict the entities which are returned.

Properties
  • children
    The 'children' can contain other filter nodes which are applied to the query. This property is only applicable on filter types 'OR' and 'AND'.
    Collection of Entity Query Filter
  • fieldName
    The 'fieldName' indicates the property on the entity which should be filtered. This property is only applicable on filter type 'LEAF'.
    String
  • operator
    The 'operator' indicates what kind of filtering on the 'fieldName' is executed on. This property is only applicable on filter type 'LEAF'.
  • type
    *
    The filter type controls how the query node is interpreted. I.e. if the node acts as leaf node or as a filter group.
  • value
    The 'value' is used to compare with the 'fieldName' as defined by the 'operator'. This property is only applicable on filter type 'LEAF'.
    Object

4.4.4Entity Query Filter Type

The filter type defines how the filter is interpreted. Depending of the type different properties are relevant on the filter itself.

Fields
  • LEAF
    Leaf
    The leaf node defines a restriction on the result set.
  • OR
    OR
    The OR node defines a group of nodes which are combined with a logical OR.
  • AND
    AND
    The AND node defines a group of nodes which are combined with a logical AND.

4.4.5Entity Query Order By Details

The 'order by' allows to order the returned entities.

Properties

4.4.6Order By Type

The 'order by' type specifies how the result is sorted.

Fields
  • DESC
    Descending
    Sorts the result descending.
  • ASC
    Ascending
    Sorts the result ascending.

4.5Error

4.5.1Client Error Details

An error that is returned as the result of a bad user request or a misconfiguration.

Properties
  • date
    Date when an error has occurred.
    String
  • defaultMessage
    The error message which is translated into the default language (i.e. English).
    String
  • id
    Unique identifier of an error.
    String
  • message
    The error message which is translated in into the language of the client.
    String
  • type
    The type of the client error.

4.5.2Client Error Type

The type of Client Errors which can be returned by a service.

Fields
  • END_USER_ERROR
    User Error
    User error is the result of a direct user input.
  • CONFIGURATION_ERROR
    Configuration Error
    A configuration Error indicates that there is an application configuration which is configured incorrectly.
  • DEVELOPER_ERROR
    Developer Error
    A developer Error indicates that there is a bad API request.

4.5.3Server Error Details

This error is thrown when something unexpected happens on our side.

Properties
  • date
    Date when an error has occurred.
    String
  • id
    Unique identifier of an error.
    String
  • message
    This message describes an error.
    String

4.6Internationalization

4.6.1Address Details

Properties
  • city
    ≤ 100 chars
    The city, town or village.
    String
  • commercialRegisterNumber
    ≤ 100 chars
    The commercial registration number of the organization.
    String
  • country
    The two-letter country code (ISO 3166 format).
    String
  • dateOfBirth
    The date of birth.
    Date
  • dependentLocality
    ≤ 100 chars
    The dependent locality which is a sub-division of the state.
    String
  • emailAddress
    Email
    ≤ 254 chars
    The email address.
    String
  • familyName
    ≤ 100 chars
    The family or last name.
    String
  • gender
    The gender.
  • givenName
    ≤ 100 chars
    The given or first name.
    String
  • legalOrganizationForm
    The legal form of the organization.
  • mobilePhoneNumber
    ≤ 100 chars
    The phone number of a mobile phone.
    String
  • organizationName
    ≤ 100 chars
    The organization's name.
    String
  • phoneNumber
    ≤ 100 chars
    The phone number.
    String
  • postalState
    The name of the region, typically a state, county, province or prefecture.
    String
  • postcode
    ≤ 40 chars
    The postal code, also known as ZIP, postcode, etc.
    String
  • salesTaxNumber
    ≤ 100 chars
    The sales tax number of the organization.
    String
  • salutation
    ≤ 20 chars
    The salutation e.g. Mrs, Mr, Dr.
    String
  • socialSecurityNumber
    ≤ 100 chars
    The social security number.
    String
  • sortingCode
    ≤ 100 chars
    The sorting code identifying the post office where the PO Box is located.
    String
  • street
    ≤ 300 chars
    The street or PO Box.
    String

4.6.2Address Format Details

Properties
  • postCodeExamples
    A list of sample post codes.
    Collection of String
  • postCodeRegex
    The regular expression to validate post codes.
    String
  • requiredFields
    The fields that are required in the address format.
    Collection of Address Format Field
  • usedFields
    The fields that are used in the address format.
    Collection of Address Format Field

4.6.3Address Format Field

Fields
  • GIVEN_NAME
    Given Name
  • FAMILY_NAME
    Family Name
  • ORGANIZATION_NAME
    Organization Name
  • STREET
    Street
  • DEPENDENT_LOCALITY
    Dependent Locality
  • CITY
    City
  • POSTAL_STATE
    Postal State
  • POST_CODE
    Post Code
  • SORTING_CODE
    Sorting Code
  • COUNTRY
    Country

4.6.4Country Details

Properties
  • addressFormat
    Specifies the country's way of formatting addresses.
  • isoCode2
    The country's two-letter code (ISO 3166-1 alpha-2 format).
    String
  • isoCode3
    The country's three-letter code (ISO 3166-1 alpha-3 format).
    String
  • name
    The name of the country.
    String
  • numericCode
    The country's three-digit code (ISO 3166-1 numeric format).
    String
  • stateCodes
    The codes of all regions (e.g. states, provinces) of the country (ISO 3166-2 format).
    Collection of String

4.6.5Currency Details

Properties
  • currencyCode
    The currency's three-letter code (ISO 4217 format).
    String
  • fractionDigits
    The currency's number of decimals. When calculating amounts in this currency, the fraction digits determine the accuracy.
    Integer
  • name
    The name of the currency.
    String
  • numericCode
    The currency's three-digit code (ISO 4217 format).
    Integer

4.6.6Gender

Fields
  • MALE
    Male
  • FEMALE
    Female

4.6.7Language Details

Properties
  • countryCode
    The two-letter code of the language's region (ISO 3166-1 alpha-2 format).
    String
  • ietfCode
    The language's IETF tag consisting of the two-letter ISO code and region e.g. en-US, de-CH.
    String
  • iso2Code
    The language's two-letter code (ISO 639-1 format).
    String
  • iso3Code
    The language's three-letter code (ISO 639-2/T format).
    String
  • name
    The name of the language.
    String
  • pluralExpression
    The expression to determine the plural index for a given number of items used to find the proper plural form for translations.
    String
  • primaryOfGroup
    Whether this is the primary language in a group of languages.
    Boolean

4.6.8Legal Organization Form Details

Properties
  • country
    The two-letter code of the country the legal organization form is used in (ISO 3166-1 alpha-2 format).
    String
  • description
    The localized descriptions of the legal organization form.
    Collection of Localized String
  • englishDescription
    The English name of the legal organization form.
    String
  • id
    A unique identifier for the object.
    Long
  • shortcut
    The localized shortcuts of the legal organization form.
    Collection of Localized String

4.6.9Localized String Details

Properties
  • language
    The term's language.
    String
  • string
    The localized term.
    String

4.6.10State Details

Properties
  • code
    The state's code used within addresses.
    String
  • country
    String
  • countryCode
    The two-letter code of the state's country (ISO 3166-1 alpha-2 format).
    String
  • id
    The state's code in ISO 3166-2 format.
    String
  • name
    The name of the state.
    String

4.7Label

4.7.1Label Details

Properties
  • content
    Object
  • contentAsString
    String
  • descriptor
  • id
    A unique identifier for the object.
    Long
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.7.2Label Descriptor Details

Properties
  • category
    The label's category.
  • description
    The localized description of the object.
    Map of String String
  • features
    The features that this label belongs to.
    Collection of Long
  • group
    The group that this label belongs to.
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String
  • type
    The type of the label's value.
  • weight
    When listing labels, they can be sorted by this number.
    Integer

4.7.3Label Descriptor Category

Fields
  • HUMAN
    Human
  • APPLICATION
    Application

4.7.4Label Descriptor Group Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String
  • weight
    When listing label groups, they can be sorted by this number.
    Integer

4.7.5Label Descriptor Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.7.6Static Value Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • features
    Collection of Long
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.8Line Item

4.8.1Line Item Details

Properties
  • aggregatedTaxRate
    Virtual
    The total tax rate applied to the item, calculated from the rates of all tax lines.
    Decimal
  • amountExcludingTax
    Virtual
    The line item price with discounts applied, excluding taxes.
    Decimal
  • amountIncludingTax
    Virtual
    The line item price with discounts applied, including taxes.
    Decimal
  • attributes
    A map of custom information for the item.
    Map of String Line Item Attribute
  • discountExcludingTax
    Virtual
    The discount allocated to the item, excluding taxes.
    Decimal
  • discountIncludingTax
    The discount allocated to the item, including taxes.
    Decimal
  • name
    1 - 150 chars
    The name of the product, ideally in the customer's language.
    String
  • quantity
    Positive
    The number of items that were purchased.
    Decimal
  • shippingRequired
    Whether the item required shipping.
    Boolean
  • sku
    ≤ 200 chars
    The SKU (stock-keeping unit) of the product.
    String
  • taxAmount
    Virtual
    The sum of all taxes applied to the item.
    Decimal
  • taxAmountPerUnit
    Virtual
    The calculated tax amount per unit.
    Decimal
  • taxes
    A set of tax lines, each of which specifies a tax applied to the item.
    Collection of Tax
  • type
    The type of the line item.
  • undiscountedAmountExcludingTax
    Virtual
    The line item price with discounts not applied, excluding taxes.
    Decimal
  • undiscountedAmountIncludingTax
    Virtual
    The line item price with discounts not applied, including taxes.
    Decimal
  • undiscountedUnitPriceExcludingTax
    Virtual
    The calculated price per unit with discounts not applied, excluding taxes.
    Decimal
  • undiscountedUnitPriceIncludingTax
    Virtual
    The calculated price per unit with discounts not applied, including taxes.
    Decimal
  • uniqueId
    ≤ 200 chars
    The unique identifier of the line item within the set of line items.
    String
  • unitPriceExcludingTax
    Virtual
    The calculated price per unit with discounts applied, excluding taxes.
    Decimal
  • unitPriceIncludingTax
    Virtual
    The calculated price per unit with discounts applied, including taxes.
    Decimal

4.8.2Line Item Attribute Details

Properties
  • label
    ≤ 512 chars
    The label describing the line item attribute.
    String
  • value
    ≤ 512 chars
    The value of the line item attribute.
    String

4.8.3Line Item Type

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

4.9Manual Task

4.9.1Manual Task Details

A manual task requires the manual intervention of a human.

Properties
  • actions
    The actions that can be triggered to handle the manual task.
    Collection of Long
  • contextEntityId
    The ID of the entity the manual task is linked to.
    Long
  • createdOn
    The date and time when the object was created.
    DateTime
  • expiresOn
    The date and time until when the manual task has to be handled.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • type
    The manual task's type.

4.9.2Manual Task Action Details

Properties
  • id
    A unique identifier for the object.
    Long
  • label
    The action's label.
    Map of String String
  • style
    The action's style.
  • taskType
    The type of manual tasks this action belongs to.

4.9.3Manual Task Action Style

Fields
  • DEFAULT
    Default
  • PRIMARY
    Primary
  • DANGER
    Danger

4.9.4Manual Task State

Fields
  • OPEN
    Open
  • DONE
    Done
  • EXPIRED
    Expired

4.9.5Manual Task Type Details

The manual task type indicates what kind of manual task is required to be executed by the human.

Properties
  • description
    The localized description of the object.
    Map of String String
  • features
    The features that this type belongs to.
    Collection of Long
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.10Payment

4.10.1Address Handling Mode

The address handling mode controls if the address is required and how it is enforced to be provided.

Fields
  • NOT_REQUIRED
    Not Required
  • REQUIRED_IN_URL
    Required In Url
  • REQUIRED_ON_PAYMENT_PAGE
    Required On Payment Page

4.10.2Authenticated Card Data Details

This model holds the card data and optional cardholder authentication details.

Properties
  • cardHolderName
    ≤ 100 chars
    The card holder name is the name printed onto the card. It identifies the person who owns the card.
    String
  • cardVerificationCode
    3 - 4 chars
    ([0-9 ]+)
    The card verification code (CVC) is a 3 to 4 digit code typically printed on the back of the card. It helps to ensure that the card holder is authorizing the transaction. For card not-present transactions this field is optional.
    String
  • cardholderAuthentication
    The cardholder authentication information. The authentication is optional and can be provided if the cardholder has been already authenticated (e.g. in 3-D Secure system).
  • cryptogram
    The additional authentication value used to secure the tokenized card transactions.
  • expiryDate
    ([0-9]{4})\-(11|12|10|0[1-9]{1})
    The card expiry date indicates when the card expires. The format is the format yyyy-mm where yyyy is the year (e.g. 2019) and the mm is the month (e.g. 09).
    String
  • primaryAccountNumber
    *
    10 - 30 chars
    ([0-9 ]+)
    The primary account number (PAN) identifies the card. The number is numeric and typically printed on the front of the card.
    String
  • recurringIndicator
  • schemeTransactionReference
    ≤ 100 chars
    String
  • tokenRequestorId
    String

4.10.3Authenticated Card Data Details

This model holds the card data and optional cardholder authentication details.

Properties
  • cardHolderName
    ≤ 100 chars
    The card holder name is the name printed onto the card. It identifies the person who owns the card.
    String
  • cardVerificationCode
    3 - 4 chars
    ([0-9 ]+)
    The card verification code (CVC) is a 3 to 4 digit code typically printed on the back of the card. It helps to ensure that the card holder is authorizing the transaction. For card not-present transactions this field is optional.
    String
  • cardholderAuthentication
    The cardholder authentication information. The authentication is optional and can be provided if the cardholder has been already authenticated (e.g. in 3-D Secure system).
  • cryptogram
    The additional authentication value used to secure the tokenized card transactions.
  • expiryDate
    ([0-9]{4})\-(11|12|10|0[1-9]{1})
    The card expiry date indicates when the card expires. The format is the format yyyy-mm where yyyy is the year (e.g. 2019) and the mm is the month (e.g. 09).
    String
  • primaryAccountNumber
    10 - 30 chars
    ([0-9 ]+)
    The primary account number (PAN) identifies the card. The number is numeric and typically printed on the front of the card.
    String
  • recurringIndicator
  • schemeTransactionReference
    ≤ 100 chars
    String
  • tokenRequestorId
    String

4.10.4Card Authentication Response

Fields
  • FULLY_AUTHENTICATED
    Fully Authenticated
  • AUTHENTICATION_NOT_REQUIRED
    Authentication Not Required
  • NOT_ENROLLED
    Not Enrolled
  • ENROLLMENT_ERROR
    Enrollment Error
  • AUTHENTICATION_ERROR
    Authentication Error

4.10.5Card Authentication Version

This model defines the card authentication versions.

Fields
  • V1
    V1
  • V2
    V2

4.10.6Card Cryptogram Details

This model holds the additional card authentication.

Properties

4.10.7Card Cryptogram Details

This model holds the additional card authentication.

Properties

4.10.8Card Cryptogram Type

This model defines the card cryptogram types.

Fields
  • SCHEME_TOKEN
    Scheme Token

4.10.9Cardholder Authentication Details

This model holds the cardholder authentication data (e.g. 3-D Secure authentication).

Properties
  • authenticationIdentifier
    The authentication identifier as assigned by authentication system (e.g. XID or DSTransactionID).
    String
  • authenticationResponse
    *
  • authenticationValue
    The cardholder authentication value. Also known as Cardholder Authentication Verification Value (CAVV).
    String
  • electronicCommerceIndicator
    The Electronic Commerce Indicator (ECI) value. The ECI is returned by authentication system and indicates the outcome/status of authentication.
    String

4.10.10Cardholder Authentication Details

This model holds the cardholder authentication data (e.g. 3-D Secure authentication).

Properties
  • authenticationIdentifier
    The authentication identifier as assigned by authentication system (e.g. XID or DSTransactionID).
    String
  • authenticationResponse
  • authenticationValue
    The cardholder authentication value. Also known as Cardholder Authentication Verification Value (CAVV).
    String
  • electronicCommerceIndicator
    The Electronic Commerce Indicator (ECI) value. The ECI is returned by authentication system and indicates the outcome/status of authentication.
    String
  • version

4.10.11Charge Details

Properties
  • createdOn
    The date on which the charge was created on.
    DateTime
  • failureReason
  • id
    A unique identifier for the object.
    Long
  • language
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • spaceViewId
    The ID of the space view this object is linked to.
  • state
    The object's current state.
  • timeZone
    String
  • timeoutOn
    DateTime
  • transaction
  • type
  • userFailureMessage
    The failure message describes for an end user why the charge is failed in the language of the user. This is only provided when the charge is marked as failed.
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.10.12Charge Attempt Details

Properties
  • charge
  • completionBehavior
  • connectorConfiguration
  • createdOn
    The date and time when the object was created.
    DateTime
  • customersPresence
    The customers presence indicates which kind of customer interaction was used during the charge attempt.
  • environment
  • failedOn
    DateTime
  • failureReason
  • id
    A unique identifier for the object.
    Long
  • initializingTokenVersion
    Boolean
  • invocation
  • labels
    Collection of Label
  • language
    The language that is linked to the object.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • nextUpdateOn
    DateTime
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • redirectionUrl
    String
  • salesChannel
  • spaceViewId
    The ID of the space view this object is linked to.
  • state
    The object's current state.
  • succeededOn
    DateTime
  • terminal
  • timeZone
    String
  • timeoutOn
    DateTime
  • tokenVersion
  • userFailureMessage
    ≤ 2,000 chars
    The user failure message contains the message for the user in case the attempt failed. The message is localized into the language specified on the transaction.
    String
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer
  • wallet

4.10.13Charge Attempt Environment

Fields
  • PRODUCTION
    Production
  • TEST
    Test

4.10.14Charge Attempt State

Fields
  • PROCESSING
    Processing
  • FAILED
    Failed
  • SUCCESSFUL
    Successful

4.10.15Charge Flow Details

Properties
  • conditions
    If a transaction meets all selected conditions, the charge flow will be used to process the transaction. If the conditions are not met the next charge flow in line will be chosen according to the priorities.
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    The charge flow name is used internally to identify the configuration in administrative interfaces. For example it is used within search fields and hence it should be distinct and descriptive.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • priority
    The priority orders the charge flows. As such the priority determines together with the conditions the charge flow the selection mechanism for a particular transaction. A change of the priority affects all future selections.
    Integer
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.10.16Charge Flow Level Details

Properties
  • asynchronousCharge
  • configuration
  • createdOn
    The date and time when the object was created.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • synchronousCharge
  • timeoutOn
    DateTime
  • tokenCharge
  • transaction
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.10.17Charge Flow Level Configuration Details

Properties
  • flow
    The charge flow level configuration to which the flow is associated.
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The charge flow level configuration name is used internally to identify the charge flow level configuration. For example the name is used within search fields and hence it should be distinct and descriptive.
    String
  • period
    The duration of the level before switching to the next one.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • priority
    The priority indicates the sort order of the level configurations. A low value indicates that the level configuration is executed before any level with a higher value. Any change to this value affects future level configuration selections.
    Integer
  • state
    The object's current state.
  • type
    The type determines how the payment link is delivered to the customer. Once the type is defined it cannot be changed anymore.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.10.18Charge Flow Level Configuration Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • label
    Map of String String
  • name
    The localized name of the object.
    Map of String String

4.10.19Charge Flow Level Payment Link Details

Properties
  • chargeFlowLevel
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • paymentLink
    Virtual
    String

4.10.20Charge Flow Level State

Fields
  • PENDING
    Pending
  • FAILED
    Failed
  • SUCCESSFUL
    Successful

4.10.21Charge State

Fields
  • PENDING
    Pending
  • FAILED
    Failed
  • SUCCESSFUL
    Successful

4.10.22Charge Type

Fields
  • ASYNCHRONOUS
    Asynchronous
  • SYNCHRONOUS
    Synchronous
  • TOKEN
    Token
  • TERMINAL
    Terminal

4.10.23Completion Line Item Details

Properties
  • amount
    The total amount of the line item including any tax.
    Decimal
  • quantity
    Positive
    The quantity of the line item which should be completed.
    Decimal
  • uniqueId
    ≤ 200 chars
    The unique id identifies the line item on which the capture is applied on.
    String

4.10.24Connector Invocation Details

Properties
  • createdOn
    The date and time when the object was created.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • stage
  • timeTookInMilliseconds
    Long
  • transaction
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.10.25Connector Invocation Stage

Fields
  • PAYMENT_METHOD_LIST
    Payment Method List
  • FORM_GENERATION
    Form Generation
  • VALIDATION
    Validation
  • AUTHORIZATION
    Authorization

4.10.26Customer's Presence

Fields
  • NOT_PRESENT
    Not Present
  • VIRTUAL_PRESENT
    Virtual Present
  • PHYSICAL_PRESENT
    Physical Present

4.10.27Data Collection Type

Fields
  • ONSITE
    Onsite
  • OFFSITE
    Offsite

4.10.28Delivery Indication Details

Properties
  • automaticDecisionReason
  • automaticallyDecidedOn
    DateTime
  • completion
  • createdOn
    The date and time when the object was created.
    DateTime
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • linkedTransaction
    Virtual
  • manualDecisionTimeoutOn
    DateTime
  • manuallyDecidedBy
    Long
  • manuallyDecidedOn
    DateTime
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • timeoutOn
    DateTime
  • transaction

4.10.29Delivery Indication Decision Reason Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.10.30Delivery Indication State

Fields
  • PENDING
    Pending
  • NOT_SUITABLE
    Not Suitable
  • MANUAL_CHECK_REQUIRED
    Manual Check Required
  • SUITABLE
    Suitable

4.10.31One Click Payment Mode

Fields
  • DISABLED
    Disabled
  • ALLOW
    Allow
  • FORCE
    Force

4.10.32Payment Condition Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.10.33Payment Connector Details

Properties
  • dataCollectionType
    The data collection type specifies how the payment information is collected.
  • deprecated
    Whether the object was deprecated.
    Boolean
  • deprecationReason
    The deprecation reason describes why the object was deprecated.
    Map of String String
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String
  • paymentMethod
    The payment method that the connector supports.
  • paymentMethodBrand
    The specific brand that this payment connector supports.
  • primaryRiskTaker
    The entity that bears the main risk in the event that a contracting party fails to meet its obligations.
  • processor
    The processor that the connector belongs to.
  • supportedCurrencies
    The currencies that are supported by the connector.
    Collection of String
  • supportedCustomersPresences
    The types of customer's presence that are supported by the connector.
    Collection of Customer's Presence
  • supportedFeatures
    The features that are supported by the connector.
    Collection of Long

4.10.34Payment Connector Condition Details

A condition allows you to define a criteria that a transaction must fulfill in order for a connector configuration to be considered for processing the payment.

Properties
  • conditionType
    The condition type determines the criteria that a transaction must fulfill in order for a connector configuration to be considered for processing the payment.
  • id
    A unique identifier for the object.
    Long
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The name used to identify the condition.
    String
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.10.35Payment Connector Configuration Details

Properties
  • applicableForTransactionProcessing
    Virtual
    Whether this connector configuration is enabled for processing payments, taking into account the state of the processor and payment method configurations.
    Boolean
  • conditions
    Conditions allow you to define criteria that a transaction must fulfill in order for the connector configuration to be considered for processing the payment.
  • connector
    The connector that the configuration is for.
  • enabledSalesChannels
    The sales channels for which the connector configuration is enabled. If empty, it is enabled for all sales channels.
    Collection of Sales Channel
  • enabledSpaceViews
    The space views for which the connector configuration is enabled. If empty, it is enabled for all space views.
    Collection of Long
  • id
    A unique identifier for the object.
    Long
  • imagePath
    The URL to the connector's image.
    String
  • linkedSpaceId
    Virtual
    The ID of the space this object belongs to.
    Long
  • name
    ≤ 100 chars
    The name used to identify the connector configuration.
    String
  • paymentMethodConfiguration
    The payment method configuration that the connector configuration belongs to.
  • plannedPurgeDate
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
    DateTime
  • priority
    The priority that determines the order in which connector configurations are taken into account when processing a payment. Low values are considered first.
    Integer
  • processorConfiguration
    The processor configuration that the connector configuration belongs to.
  • state
    The object's current state.
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.10.36Payment Connector Feature Details

Properties
  • displayName
    The name of the feature.
    String
  • id
    A unique identifier for the object.
    Long

4.10.37Payment Contract Details

Properties
  • account
    This account that the contract belongs to.
  • activatedOn
    The date and time when the contract was activated.
    DateTime
  • contractIdentifier
    The identifier of the contract.
    String
  • contractType
    The type of the contract.
  • createdBy
    The ID of the user the contract was created by.
  • createdOn
    The date and time when the object was created.
    DateTime
  • externalId
    A client generated nonce which identifies the entity to be created. Subsequent creation requests with the same external ID will not create new entities but return the initially created entity instead.
    String
  • id
    A unique identifier for the object.
    Long
  • lastModifiedDate
    The date and time when the object was last modified.
    DateTime
  • rejectedOn
    The date and time when the contract was rejected.
    DateTime
  • rejectionReason
    The reason for rejecting the contract.
  • startTerminatingOn
    The date and time when the termination process of the contract was started.
    DateTime
  • state
    The object's current state.
  • terminatedBy
    The ID of the user the contract was terminated by.
  • terminatedOn
    The date and time when the contract was terminated.
    DateTime
  • version
    The version is used for optimistic locking and incremented whenever the object is updated.
    Integer

4.10.38Payment Contract State

Fields
  • PENDING
    Pending
  • ACTIVE
    Active
  • TERMINATING
    Terminating
  • TERMINATED
    Terminated
  • REJECTED
    Rejected

4.10.39Payment Contract Type Details

Properties
  • description
    The localized description of the object.
    Map of String String
  • id
    A unique identifier for the object.
    Long
  • name
    The localized name of the object.
    Map of String String

4.10.40Payment Information Hash Details

A payment information hash is calculated based on the information entered by the user. The same input leads to the same hash. The hash is collision free.

Properties

4.10.41Payment Information Hash Type Details

Properties
  • id
    A unique identifier for the object.
    Long
  • name
    Map of String String

4.10.42Payment Link Details

The payment link defines an URL to automatically create transactions.