{
'filter': {
'fieldName': 'primaryAccount.name',
'operator': 'EQUALS',
'type': 'LEAF',
'value': 'test'
}
}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.
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 |
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 |
DateTime |
A date defines a specific point in time. We represent dates as strings since |
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) |
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.
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:
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.
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:
-
Each operation will be tagged exactly with one tag. This tag correspond to the service name. It is always in camel case.
-
Each
operationIdstarts 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.
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.
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
25key / value pairs can be provided. -
A key cannot be longer as
40chars. -
A value cannot be longer as
512chars. -
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.
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.
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.
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.
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.
|
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();
?>After you collected all the data you have to calculate the x-mac-value using the following input:
-
Algorithm Version: The same fixed string as defined above in
x-mac-versionheader. -
User ID: The user ID as used for the
x-mac-useridheader. -
Time stamp: The same string representing the current time as used for the
x-mac-timestampheader. -
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. -
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.
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.
-
x-mac-versionheader: 1 -
x-mac-useridheader: 2481632 -
x-mac-timestampheader: 1425387916 -
Method:
GET -
Path: /api/transaction/read?spaceId=12&id=1
-
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=1Which, 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, 0x31Decoding 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, 0xb2Now 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==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));
?>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));
}
}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)The following diagram illustrates the calculation of the complete algorithm described above:
Figure 2. Diagram illustrating the HMAC value calculation
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.
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.
Deletes the entity with the given id.
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Message Body *
The account object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Message Body *
The query restricts the accounts which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Account
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Message Body *
The account object with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The id of the account which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The metric usage service allows to query used resources.
Calculates the consumed resources for the given space and time range.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Metric Usage
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Message Body *
The query restricts the spaces which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Space
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Message Body *
The space object with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The id of the space which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Message Body *
The space object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The web app service allows to manage the installation of web apps.
This operation confirms the app installation. This method has to be invoked after the user returns to the web app. The request of the user will contain the code as a request parameter. The web app is implied by the client ID resp. user ID that is been used to invoke this operation.
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation uninstalls the web app from the provided space. The web app is implied by the client ID resp. user ID that is been used to invoke this operation.
Query Parameters
-
spaceId*This parameter identifies the space within which the web app should be uninstalled.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns true when the app is installed in given space. The web app is implied by the client ID resp. user ID that is been used to invoke this operation.
Query Parameters
-
spaceId*This parameter identifies the space which should be checked if the web app is installed.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Boolean
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the customer which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The customer object which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the customers which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Customer Address
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The customer object with the properties which should be updated.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Query Parameters
-
spaceId*Long
-
id*The id of the customer address to set as default.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the customers which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Customer Comment
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The customer object with the properties which should be updated.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the customer which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Query Parameters
-
spaceId*Long
-
id*The id of the customer comment to unpin.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Query Parameters
-
spaceId*Long
-
id*The id of the customer comment to pin to the top.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The customer object which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The customer object which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the customers which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Customer
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the customer which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The customer object with the properties which should be updated.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation will mark a debt collection case as prepared and allow the collection process to proceed.
Query Parameters
-
spaceId*Long
-
id*The id of the debt collection case which should be marked as prepared.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The debt collection case object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Adds a new collected amount to the case, creating a new payment receipt.
Query Parameters
-
spaceId*Long
-
id*The id of the debt collection case for which the amount should be added.Long
-
collectedAmount*The amount that has been collected.Decimal
-
externalId*The unique external id of this payment receipt.String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Attach an additional supporting document to the case.
Query Parameters
-
spaceId*Long
-
id*The id of the debt collection case.Long
-
fileName*The file name of the document that is uploaded.String
-
contentBase64*The BASE64 encoded contents of the document.String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the debt collection case which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the cases which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Debt Collection Case
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation will mark a debt collection case as reviewed and allow the collection process to proceed.
Query Parameters
-
spaceId*Long
-
id*The id of the debt collection case which should be reviewed.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Closes the debt collection case, meaning no further money can be collected.
Query Parameters
-
spaceId*Long
-
id*The id of the debt collection case which should be closed.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Returns all documents that are attached to a debt collection case.
Query Parameters
-
spaceId*Long
-
id*The id of the debt collection case for which the attached documents are returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Debt Collection Case Document
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the debt collector configuration which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Debt Collector Configuration
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the debt collector configuration which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all entities which are available.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Debt Collector
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The id of the collector which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the document template which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the document templates which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Document Template
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all entities which are available.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Document Template Type
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The id of the document template type which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the installment payment which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body *
The filter which restricts the installment payment which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the installment payments which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Installment Payment
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation creates based up on the given transaction an installment payment.
Query Parameters
-
spaceId*Long
-
transactionId*The transaction which should be converted into an installment payment.Long
-
installmentPlanConfiguration*The installment plan configuration ID which should be applied on the transaction.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the installment payment slice which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the installment payment slices which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Installment Payment Slice
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body *
The filter which restricts the installment payment slices which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to calculate all plans for the given transaction. The transaction will not be changed in any way.
Query Parameters
-
spaceId*Long
-
transactionId*The transaction for which the plans should be calculated for.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Installment Calculated Plan
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the installment plan configurations which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Installment Plan
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body *
The filter which restricts the installment plan configurations which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the installment plan configuration which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the installment plan slice configuration which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the installment plan slice configurations which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Installment Plan Slice
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body *
The filter which restricts the installment plan slice configurations which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all countries.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Country
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all states for a given country.
Query Parameters
-
code*The country code in ISO code two letter format for which all states should be returned.String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of State
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all states of all countries.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of State
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all currencies.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Currency
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all languages.
GET /api/language/all HTTP/1.1
Host: app-wallee.com
Content-Type: application/json;charset=utf-8
X-Mac-Version: 1
X-Mac-Userid: <:YOUR_USER_ID>
X-Mac-Timestamp: <:UNIX_TIMESTAMP>
X-Mac-Value: <:CALCULATED_MAC_VALUE>$client = new \Wallee\Sdk\ApiClient(<:YOUR_USER_ID>, <:YOUR_API_KEY>);
$service = new \Wallee\Sdk\Service\LanguageService($client);
$result = $service->languageAllGet();Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Language
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all legal organization forms for a given country.
Query Parameters
-
code*The country in ISO 3166-1 alpha-2 format, for which all legal organization forms should be returned.String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Legal Organization Form
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all entities which are available.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Legal Organization Form
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The id of the legal organization form which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The id of the label descriptor group which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all entities which are available.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Label Descriptor Group
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The id of the label descriptor which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all entities which are available.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Label Descriptor
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The id of the static value which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all entities which are available.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Static Value
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the manual tasks which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Manual Task
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the manual task which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The ID of the bank account which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the bank accounts which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Bank Account
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the bank transactions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Bank Transaction
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The ID of the bank transaction which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
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.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.String
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The process method will process the transaction with the given card details without using 3-D secure.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the charge attempts which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Charge Attempt
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the charge attempt which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The ID of the charge bank transaction which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the charge bank transactions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Charge Bank Transaction
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the charge flow level payment links which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Charge Flow Level Payment Link
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The ID of the charge flow level payment link which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the payment flow levels which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Charge Flow Level
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Sends the payment link of the charge flow level with the given 'id'.
Query Parameters
-
spaceId*Long
-
id*The id of the charge flow level whose payment link should be sent.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the payment flow level which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Query Parameters
-
spaceId*Long
-
id*The transaction id of the transaction which should be process asynchronously.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
-
id*The transaction id of the transaction for which the URL of the charge flow should be fetched.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.String
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the charge flow which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation cancels the charge flow that is linked with the transaction indicated by the given ID.
Query Parameters
-
spaceId*Long
-
id*The ID of the transaction for which the charge flow should be canceled.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the charge flows which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Charge Flow
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all entities which are available.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Payment Condition Type
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The id of the condition type which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the currency bank accounts which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Currency Bank Account
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The ID of the currency bank account which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the delivery indication which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the delivery indications which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Delivery Indication
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation marks the delivery indication as suitable.
Query Parameters
-
spaceId*Long
Message Body *
The delivery indication id which should be marked as suitable.
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation marks the delivery indication as not suitable.
Query Parameters
-
spaceId*Long
Message Body *
The delivery indication id which should be marked as not suitable.
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the external transfer bank transactions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of External Transfer Bank Transaction
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The ID of the external transfer bank transaction which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the internal transfer bank transactions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Internal Transfer Bank Transaction
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The ID of the internal transfer bank transaction which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This service allows to link Invoice Reconciliation Records with invoices.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the invoice reconciliation record invoice link which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Invoice Reconciliation Record
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Links the invoice reconciliation record with the provided invoice.
Query Parameters
-
spaceId*Long
-
recordId*The ID of the invoice reconciliation record which should be linked.Long
-
completionId*The ID of the completion which should be linked.Long
-
amountThe amount of the invoice reconciliation record linked completion which should be changed.Decimal
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Unlinks the invoice reconciliation record from the provided invoice.
Query Parameters
-
spaceId*Long
-
recordId*The ID of the invoice reconciliation record which should be unlinked.Long
-
completionId*The ID of the completion which should be unlinked.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The ID of the invoice reconciliation record invoice link which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Resolves the invoice reconciliation record.
Query Parameters
-
spaceId*Long
-
id*The ID of the invoice reconciliation record which should be resolved.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the invoice reconciliation records which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Invoice Reconciliation Record
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for transaction invoices by given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the invoices which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Transaction Invoice
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The ID of the invoice reconciliation record which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Discards the invoice reconciliation record.
Query Parameters
-
spaceId*Long
-
id*The ID of the invoice reconciliation record which should be discarded.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the invoice reimbursements which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Invoice Reimbursement
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Updates payment connector configuration for reimbursement which is in manual review.
Query Parameters
-
spaceId*Long
-
id*The ID of the invoice reimbursement of which connector should be updated.Long
-
paymentConnectorConfigurationId*Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The ID of the invoice reimbursement which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Updates recipient and/or sender IBAN for reimbursement which is in manual review.
Query Parameters
-
spaceId*Long
-
id*The ID of the invoice reimbursement of which IBANs should be updated.Long
-
recipientIbanString
-
senderIbanString
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the payment connector configuration which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the payment connector configuration which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Payment Connector Configuration
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all entities which are available.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Payment Connector
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The id of the connector which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The payment link service allows to manage payment links via the web service API.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The payment link object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the payment links which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Payment Link
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the payment links which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all entities which are available.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Payment Method Brand
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The id of the payment method brand which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the payment method configuration which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the payment method configuration which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Payment Method Configuration
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The id of the payment method which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all entities which are available.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Payment Method
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the payment processor configuration which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the payment processor configuration which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Processor Configuration
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all entities which are available.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Payment Processor
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The id of the processor which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The payment terminal service allows to fetch the configured terminals.
Remotely triggers the final balance receipt on the terminal.
Query Parameters
-
spaceId*Long
-
terminalId*Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the payment terminal which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Remotely triggers the final balance receipt on the terminal by terminal identifier.
Query Parameters
-
spaceId*Long
-
terminalIdentifier*String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Links the device with given serial number with terminal.
Query Parameters
-
spaceId*Long
-
terminalId*Long
-
serialNumber*String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the payment terminals which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Payment Terminal
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Unlinks the device from terminal.
Query Parameters
-
spaceId*Long
-
terminalId*Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The payment terminal till service allows the till to communicate with the terminal.
Starts a payment terminal transaction and waits for its completion. If the call returns with a long polling timeout status, you may try again. The processing of the transaction will be picked up where it was left off.
Query Parameters
-
spaceId*Long
-
transactionId*The ID of the transaction which is used to process with the terminal.Long
-
terminalIdentifier*The identifier (aka TID) of the terminal which should be used to process the transaction.String
-
languageThe language in which the messages should be rendered in.String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
-
543ErrorThis status code indicates that the long polling request timed out.
Starts a payment terminal transaction and waits for its completion. If the call returns with a long polling timeout status, you may try again. The processing of the transaction will be picked up where it was left off.
Query Parameters
-
spaceId*Long
-
transactionId*The ID of the transaction which is used to process with the terminal.Long
-
terminalId*The ID of the terminal which should be used to process the transaction.Long
-
languageThe language in which the messages should be rendered in.String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
-
543ErrorThis status code indicates that the long polling request timed out.
The payment terminal transaction summary service allows to fetch the detailed transaction summaries, such as final balance reports.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Returns the terminal receipt corresponding to the specified transaction summary id.
Query Parameters
-
spaceId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction summary report which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the transaction summary reports which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Transaction summary
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The payment web app service allows to insert payment processors through a web app.
This operation updates the state of the charge attempt. This method can be invoked for transactions originally created with a processor associated with the web app that invokes this operation. The returned charge attempt corresponds to the charge attempt indicated in the request.
Query Parameters
-
spaceId*This is the ID of the space in which the charge attempt is located in.Long
Message Body *
The charge attempt update request allows to update the state of a charge attempt.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation updates the state of the transaction void. This method can be invoked for transactions originally created with a processor associated with the web app that invokes this operation. The returned void corresponds to the void indicated in the request.
Query Parameters
-
spaceId*This is the ID of the space in which the void is located in.Long
Message Body *
The void update request allows to update the state of a void.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation removes the web app payment processor and its connectors from the given space.
Query Parameters
-
spaceId*The space ID identifies the space in which the processor is installed in.Long
-
externalId*The external ID identifies the processor. The external ID corresponds to the ID provided during inserting of the processor.String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation updates the state of the transaction completion. This method can be invoked for transactions originally created with a processor associated with the web app that invokes this operation. The returned completion corresponds to the completion indicated in the request.
Query Parameters
-
spaceId*This is the ID of the space in which the completion is located in.Long
Message Body *
The completion update request allows to update the state of a completion.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation marks the processor to be usable within the production environment.
Query Parameters
-
spaceId*The space ID identifies the space in which the processor is installed in.Long
-
externalId*The external ID identifies the processor. The external ID corresponds to the ID provided during inserting of the processor.String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation inserts or updates a web app payment processor.
Query Parameters
-
spaceId*The space ID identifies the space into which the processor should be inserted into.Long
Message Body *
The processor object contains all the details required to create or update a web app processor.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation removes the web app payment connector from the given space.
Query Parameters
-
spaceId*The space ID identifies the space in which the connector is installed in.Long
-
externalId*The external ID identifies the connector. The external ID corresponds to the ID provided during inserting of the connector.String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation updates the state of the refund. This method can be invoked for transactions originally created with a processor associated with the web app that invokes this operation. The returned refund corresponds to the refund indicated in the request.
Query Parameters
-
spaceId*This is the ID of the space in which the refund is located in.Long
Message Body *
The refund update request allows to update the state of a refund.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation inserts or updates a web app payment connector.
Query Parameters
-
spaceId*The space ID identifies the space into which the connector should be inserted into.Long
Message Body *
The connector object contains all the details required to create or update a web app connector.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the refund bank transactions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Refund Bank Transaction
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The ID of the refund bank transaction which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The comment object with the properties which should be updated.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Returns all comments of the given refund.
Query Parameters
-
spaceId*Long
-
refundId*Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Refund Comment
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Pins the comment to the top.
Query Parameters
-
spaceId*Long
-
id*The id of the comment to pin to the top.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the comment with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the comment which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the comment with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the comment with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The comment object which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Unpins the comment from the top.
Query Parameters
-
spaceId*Long
-
id*The id of the comment to unpin.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the refund recovery bank transactions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Refund Recovery Bank Transaction
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The ID of the refund recovery bank transaction which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the refund which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Returns the PDF document for the refund with given id and the given target media type.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to mark a refund as failed which is in state MANUAL_CHECK.
Query Parameters
-
spaceId*Long
-
refundId*The id of the refund which should be marked as failed.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation creates and executes a refund of a particular transaction.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to mark a refund as successful which is in state MANUAL_CHECK.
Query Parameters
-
spaceId*Long
-
refundId*The id of the refund which should be marked as successful.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the refunds which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Refund
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Returns the PDF document for the refund with given id.
Query Parameters
-
spaceId*Long
-
id*The id of the refund to get the document for.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation checks if the given transaction can be used to create a token out of it.
Query Parameters
-
spaceId*Long
-
transactionId*The id of the transaction for which we want to check if the token can be created or not.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Boolean
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation creates a token for the given transaction and fills it with the stored payment information of the transaction. The payment information for the transaction will be filled in immediately, if payment information is missing, an exception will be thrown.
Query Parameters
-
spaceId*Long
-
transactionId*The id of the transaction for which we want to create the token.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation creates a token for the given transaction. The transaction payment information will be populated asynchronously as soon as all data becomes available.
Query Parameters
-
spaceId*Long
-
transactionId*The id of the transaction for which we want to create the token.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation creates a transaction which allows the updating of the provided token.
Query Parameters
-
spaceId*Long
-
tokenId*The id of the token which should be updated.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The token object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the token which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the tokens which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Payment Token
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation processes the given transaction by using the token associated with the transaction.
Query Parameters
-
spaceId*Long
-
transactionId*The id of the transaction for which we want to check if the token can be created or not.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the token version which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the token versions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Token Version
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Returns the token version which is currently active given by the token id. In case no token version is active the method will return null.
Query Parameters
-
spaceId*Long
-
id*The id of a token for which you want to look up the current active token version.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Returns all comments of the transaction.
Query Parameters
-
spaceId*Long
-
transactionId*Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Transaction Comment
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Pins the comment to the top.
Query Parameters
-
spaceId*Long
-
id*The id of the comment to pin to the top.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the comment with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the comment which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the comment with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the comment with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The comment object which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Unpins the comment from the top.
Query Parameters
-
spaceId*Long
-
id*The id of the comment to unpin.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The comment object with the properties which should be updated.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction completions which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the transaction completions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Transaction Completion
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation creates the URL which can be used to embed the JavaScript for handling the iFrame checkout flow.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.String
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Unpins the comment from the top.
Query Parameters
-
spaceId*Long
-
id*The id of the comment to unpin.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the comment with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the comment which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Returns all comments of the given transaction invoice.
Query Parameters
-
spaceId*Long
-
invoiceId*Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Transaction Invoice Comment
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the comment with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The comment object which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the comment with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Pins the comment to the top.
Query Parameters
-
spaceId*Long
-
id*The id of the comment to pin to the top.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The comment object with the properties which should be updated.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Returns the PDF document for the transaction invoice with given id.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction invoice to get the document for.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Replaces the transaction invoice with given id with the replacement and returns the new transaction invoice.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction invoices which should be replaced.Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Marks the transaction invoice with the given id as paid.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction invoice which should be marked as paid.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction invoices which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Marks the transaction invoice with the given id as derecognized.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction invoice which should be marked as derecognized.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the transaction invoices which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Transaction Invoice
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Returns the PDF document for the transaction invoice with given id and target media type id.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Returns whether the transaction invoice with the given id can be replaced.
Query Parameters
-
spaceId*Long
-
id*The invoice which should be checked if a replacement is possible.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Boolean
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation creates the URL which can be used to embed the JavaScript for handling the Lightbox checkout flow.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.String
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts line item versions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Transaction Line Item Version
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The ID of the line item version which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation applies a line item version on a particular transaction.
Query Parameters
-
spaceId*Long
Message Body *
The line item version object which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
credentials*The credentials identifies the transaction and contains the security details which grants the access this operation.String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.String
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation creates the URL to which the user should be redirected to when the payment page should be used.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.String
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The confirm operation marks the transaction as confirmed. Once the transaction is confirmed no more changes can be applied.
Examples
POST /api/transaction/confirm?spaceId={YOUR_SPACE_ID} HTTP/1.1
Host: app-wallee.com
Content-Type: application/json;charset=utf-8
X-Mac-Version: 1
X-Mac-Userid: {YOUR_USER_ID}
X-Mac-Timestamp: {UNIX_TIMESTAMP}
X-Mac-Value: {CALCULATED_MAC_VALUE}
{
"id": 109891
}Query Parameters
-
spaceId*Long
Message Body *
The transaction JSON object to update and confirm.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to create transaction credentials to delegate temporarily the access to the web service API for this particular transaction.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.String
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction to get the latest line item version for.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Exports the transactions into a CSV file. The file will contain the properties defined in the request.
Query Parameters
-
spaceId*Long
Message Body *
The request controls the entries which are exported.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.binary:
text/csv -
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to get the payment method configurations which can be used with the provided transaction.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Payment Method Configuration
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Returns the PDF document for the transaction invoice with given id.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction to get the invoice document for.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns the token version objects which references the tokens usable as one-click payment tokens for the provided transaction.
Query Parameters
-
credentials*The credentials identifies the transaction and contains the security details which grants the access this operation.String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Token Version
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the transactions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Transaction
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The transaction object with the properties which should be updated.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to get the payment method configurations which can be used with the provided transaction.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Payment Method Configuration
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.String
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Returns the packing slip for the transaction with given id.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction to get the packing slip for.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the transaction with the given 'id' and returns it. This method uses the credentials to authenticate and identify the transaction.
Query Parameters
-
credentials*The credentials identifies the transaction and contains the security details which grants the access this operation.String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction which should be processed.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Examples
POST /api/transaction/create?spaceId={YOUR_SPACE_ID} HTTP/1.1
Host: app-wallee.com
Content-Type: application/json;charset=utf-8
X-Mac-Version: 1
X-Mac-Userid: {YOUR_USER_ID}
X-Mac-Timestamp: {UNIX_TIMESTAMP}
X-Mac-Value: {CALCULATED_MAC_VALUE}
{
"billingAddress": {
"city": "Winterthur",
"commercialRegisterNumber": "",
"country": "CH",
"dateOfBirth": "",
"emailAddress": "some-buyer@test.com",
"familyName": "Test",
"gender": "",
"givenName": "Sam",
"mobilePhoneNumber": "",
"organisationName": "Test Company Ltd",
"phoneNumber": "",
"postcode": "8400",
"salesTaxNumber": "",
"salutation": "",
"socialSecurityNumber": "",
"state": "",
"street": "Sample Street 47"
},
"currency": "EUR",
"language": "en-US",
"lineItems": [{
"amountIncludingTax": "11.87",
"name": "Sample Product",
"quantity": "1",
"shippingRequired": "true",
"sku": "sample-123",
"type": "PRODUCT",
"uniqueId": "sample-123",
"attributes": {
"test1": {
"label": "My Test Label",
"value": "Test Attribute Value"
},
"c2": {
"label": "My Test Label 2",
"value": "Test Attribute Value"
}
}
}],
"metaData": {
"sampleKey": "Some value",
"additionalDataItem": "Other value"
},
"merchantReference": "DEV-2630",
"shippingAddress": {
"city": "Winterthur",
"commercialRegisterNumber": "",
"country": "CH",
"dateOfBirth": "",
"emailAddress": "some-buyer@test.com",
"familyName": "Test",
"gender": "",
"givenName": "Sam",
"mobilePhoneNumber": "",
"organisationName": "Test Company Ltd",
"phoneNumber": "",
"postcode": "8400",
"salesTaxNumber": "",
"salutation": "",
"socialSecurityNumber": "",
"state": "",
"street": "Sample Street 47"
}
}Query Parameters
-
spaceId*Long
Message Body *
The transaction object which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation removes the given token.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation creates a set of credentials to use within the WebSocket.
Query Parameters
-
spaceId*Long
-
transactionId*The ID of the transaction which is used to process with the terminal.Long
-
terminalId*The ID of the terminal which should be used to process the transaction.Long
-
languageThe language in which the messages should be rendered in.String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.String
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Returns all receipts for the requested terminal transaction.
Query Parameters
-
spaceId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Rendered Terminal Receipt
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction which should be voided.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction which should be voided.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the transaction voids which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the transaction voids which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Transaction Void
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the Shopify recurring order which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the Shopify recurring orders which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Shopify Recurring Order
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to update a Shopify recurring order.
Query Parameters
-
spaceId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the Shopify subscribers which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Shopify Subscriber
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The Shopify subscriber object with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the Shopify subscriber which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The Shopify subscription product object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the Shopify subscription products which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Shopify Subscription Product
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The Shopify subscription product object with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the Shopify subscription product which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to terminate a Shopify subscription.
Query Parameters
-
spaceId*Long
-
subscriptionId*The ID identifies the Shopify subscription which should be terminated.Long
-
respectTerminationPeriod*The respect termination period controls whether the termination period configured on the product version should be respected or if the operation should take effect immediately.Boolean
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to update a Shopify subscription addresses.
Query Parameters
-
spaceId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to create a Shopify subscription.
Query Parameters
-
spaceId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the Shopify subscription which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the Shopify subscriptions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Shopify Subscription
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to update a Shopify subscription.
Query Parameters
-
spaceId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to suspend a Shopify subscription.
Query Parameters
-
spaceId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to reactivate a suspended Shopify subscription.
Query Parameters
-
spaceId*Long
-
subscriptionId*The ID identifies the suspended Shopify subscription which should be reactivated.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the Shopify subscription suspension which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the Shopify subscription suspensions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Shopify Subscription Suspension
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the Shopify subscription version which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the Shopify subscription versions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Shopify Subscription Version
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the Shopify transactions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Shopify Transaction
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the Shopify transaction which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The customer with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the customer which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The customer object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the customer which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Subscriber
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the subscription affiliate case which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the affiliates which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Subscription Affiliate
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The subscription affiliate object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the subscription charge which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The create operation creates a new subscription charge.
Query Parameters
-
spaceId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the subscription charges which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Subscription Charge
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to discard a scheduled charge.
Query Parameters
-
spaceId*Long
-
chargeId*Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the metric which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The metric object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
The id of the metric which should be deleted.
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the metric which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Metric
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The products metric with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the usage report which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation creates a new metric usage report.
Query Parameters
-
spaceId*Long
Message Body *
The usage report which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the usage reports which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Metric Usage Report
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the subscription period bill which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the subscription period bills which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Subscription Period Bill
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the product component group which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The product component group object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the product component groups which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Product Component Group
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The product component group object with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the product component which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Product Component
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The product component object with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the product component which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The product component object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the metered fee which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The metered fee object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the metered fees which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Product Metered Fee
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The metered fee object with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The metered fee tier object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the metered fee tier which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the metered fee tiers which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Product Metered Fee Tier
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The metered fee tier object with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the period fee which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The period fee object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the period fees which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Product Period Fee
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The period fee object with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the retirement which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The create operation creates a new product retirement.
Query Parameters
-
spaceId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the product retirements which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Product Retirement
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the products which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Subscription Product
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The products object with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the product which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The product object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the setup fees which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Product Setup Fee
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The setup fee object with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the setup fee which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The setup fee object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The create operation creates a new product version retirement.
Query Parameters
-
spaceId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the retirement which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the product version retirements which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Product Version Retirement
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Query Parameters
-
spaceId*Long
Message Body *
The product version object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the product versions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Product Version
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The product version object with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the product version which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation activates a new product version.
Query Parameters
-
spaceId*Long
-
productVersionId*The product version id identifies the product version which should be activated.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the subscription which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to apply changes on a subscription.
Query Parameters
-
spaceId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The create operation creates a new subscription and a corresponding subscription version.
Query Parameters
-
spaceId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The initialize operation initializes a subscription when the subscriber is present. The method will initialize a transaction which has to be completed by using the transaction service.
Query Parameters
-
spaceId*Long
-
subscriptionId*Long
-
successUrlThe subscriber will be redirected to the success URL when the transaction is successful.String
-
failedUrlThe subscriber will be redirected to the fail URL when the transaction fails.String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the subscriptions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Subscription
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The initialize operation initializes a subscription. This method uses charge flows to carry out the transaction.
Query Parameters
-
spaceId*Long
-
subscriptionId*The provided subscription id will be used to lookup the subscription which should be initialized.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to update the subscription.
Query Parameters
-
spaceId*Long
-
subscriptionId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The update product version operation updates the product version of the subscription to the latest active product version.
Query Parameters
-
spaceId*Long
-
subscriptionId*The subscription id identifies the subscription which should be updated to the latest version.Long
-
respectTerminationPeriod*The subscription version may be retired. The respect termination period controls whether the termination period configured on the product version should be respected or if the operation should take effect immediately.Boolean
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to terminate a subscription.
Query Parameters
-
spaceId*Long
-
subscriptionId*The subscription id identifies the subscription which should be terminated.Long
-
respectTerminationPeriod*The respect termination period controls whether the termination period configured on the product version should be respected or if the operation should take effect immediately.Boolean
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation allows to search for subscription invoices.
Query Parameters
-
spaceId*Long
-
subscriptionId*The id of the subscription for which the invoices should be searched for.Long
Message Body *
The query restricts the invoices which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Transaction Invoice
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The create operation creates a new subscription suspension.
Query Parameters
-
spaceId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The create operation creates a new subscription suspension.
Query Parameters
-
spaceId*Long
-
suspensionId*Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the suspension which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the subscription suspensions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Suspension
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the subscriptions which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Subscription Version
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the subscription which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the subscription charge which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
The create operation creates a new subscription ledger entry.
Query Parameters
-
spaceId*Long
Message Body *
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the subscription charges which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Subscription Ledger Entry
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The id of the application user which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the application user with the given properties.
Message Body *
The user object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Message Body *
The query restricts the application users which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Application User
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Message Body *
The application user entity with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Exports the human users into a CSV file. The file will contain the properties defined in the request.
Message Body *
The request controls the entries which are exported.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.binary:
text/csv -
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Message Body *
The query restricts the human users which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Human User
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Message Body *
The object with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The id of the human user which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
Message Body *
The human user object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The id of the permission which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation returns all entities which are available.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Permission
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation grants the role to the given user with in the given account.
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
-
appliesOnSubaccountWhether the role applies only on subaccount.Boolean
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation removes the specified user account role.
Query Parameters
-
id*The id of user account role which should be removedLong
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
List all the roles that are assigned to the given user in the given account.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of User Account Role
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation grants the given role to the user in the given space.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
List all the roles that are assigned to the given user in the given space.
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
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of User Space Role
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
This operation removes the specified user space role.
Query Parameters
-
id*The id of user space role which should be removedLong
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
id*The ID of the key version.String
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
use Wallee\Sdk\ApiClient;
use Wallee\Sdk\Model\CreationEntityState;
use Wallee\Sdk\Model\TransactionState;
use Wallee\Sdk\Model\WebhookUrlCreate;
use Wallee\Sdk\Model\WebhookListenerCreate;
$spaceId = <:YOUR_SPACE_ID>;
$userId = <:YOUR_USER_ID>;
$secret = <:YOUR_USER_SECRET>;
$apiClient = new ApiClient($userId, $secret);
$data = [
// Transaction entity id
'id' => '1472041829003',
'name' => 'Shopname::WebHook::Transaction',
'states' => [
TransactionState::DECLINE,
TransactionState::FULFILL
],
'notifyEveryChange' => false,
];
// Create webhook Url
$webHookName = 'Shopname: Webhook name';
$webHookUrl = 'https://yourdomain.com/webhook/action';
$entity = (new WebhookUrlCreate())
->setName($webHookName)
->setUrl($webHookUrl)
->setState(CreationEntityState::ACTIVE);
$webHookUrl = $apiClient->getWebhookUrlService()->create($spaceId, $entity);
// Create a transaction webhook for transactions
// Transaction state flow is documented here: https://app-wallee.com/en/doc/payment/transaction-process
$entity = (new WebhookListenerCreate())
->setName($data['name'])
->setEntity($data['id'])
->setNotifyEveryChange($data['notifyEveryChange'])
->setState(CreationEntityState::CREATE)
->setEntityStates($data['states'])
->setUrl($webhookUrl->getId());
$apiClient->getWebhookListenerService()->create($spaceId, $entity);package com.wallee.walleesdk;
import com.wallee.sdk.ApiClient;
import com.wallee.sdk.model.WebhookListener;
import com.wallee.sdk.model.WebhookListenerCreate;
import com.wallee.sdk.model.WebhookUrl;
import com.wallee.sdk.model.WebhookUrlCreate;
import com.wallee.sdk.service.WebhookListenerService;
import com.wallee.sdk.service.WebhookUrlService;
import org.junit.Test;
import java.util.List;
/**
* API tests for TransactionPaymentPageService
*/
public class WebhookListenerServiceTest {
// Credentials
private Long spaceId = <:YOUR_SPACE_ID>;
private Long applicationUserId = <:YOUR_USER_ID>;
private String authenticationKey = <:YOUR_USER_SECRET>;
// Services
private ApiClient apiClient;
private WebhookUrlService webhookUrlService;
private WebhookListenerService webhookListenerService;
// Models
private WebhookUrlCreate webhookUrlPayload;
private WebhookListenerCreate webhookListenerPayload;
public WebhookListenerServiceTest() {
this.apiClient = new ApiClient(applicationUserId, authenticationKey);
this.webhookUrlService = new WebhookUrlService(this.apiClient);
this.webhookListenerService = new WebhookListenerService(this.apiClient);
}
/**
* Get webhook url payload
*
* @return WebHookUrlCreate
*/
private WebhookUrlCreate getWebhookUrlPayload() {
if (this.webhookUrlPayload == null) {
// Web url
WebhookUrlCreate urlCreate = new WebhookUrlCreate();
urlCreate
.name("Transaction webhook url")
.url("http://transactions.callback-url.com");
this.webhookUrlPayload = urlCreate;
}
return this.webhookUrlPayload;
}
/**
* Get webhook listener payload.
* This specific example is for transactions.
* Transaction state flow is documented here: <a href="https://app-wallee.com/en/doc/payment/transaction-process">Transactions</a>
*
* @param webhookUrlId - id of an existing webhook url
* @return WebhookListener create
*/
private WebhookListenerCreate getWebhookListenerPayload(Long webhookUrlId) {
if (this.webhookListenerPayload == null) {
// Webhook listener
WebhookListenerCreate listenerCreate = new WebhookListenerCreate();
listenerCreate
.url(webhookUrlId)
// Transaction entity ID
.entity(1472041829003L)
.name("Transaction webhook listener")
.entityStates(List.of("FULFILL", "DECLINE"))
.notifyEveryChange(false);
this.webhookListenerPayload = listenerCreate;
}
return this.webhookListenerPayload;
}
/**
* create
*
*
* This operation creates a listener entity, that will listen for state changes.
*/
public void create() {
try {
final WebhookUrl webhookUrl = this.webhookUrlService.create(spaceId, getWebhookUrlPayload());
final WebhookListener webhookListener = this.webhookListenerService.create(spaceId, getWebhookListenerPayload(webhookUrl.getId()));
// expect webhookListener.getId() to not be null
} catch (Exception e) {
e.printStackTrace();
}
}
}Query Parameters
-
spaceId*Long
Message Body *
The webhook listener object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the webhook listeners which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Webhook Listener
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The webhook listener object with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the webhook listener which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Reads the entity with the given 'id' and returns it.
Query Parameters
-
spaceId*Long
-
id*The id of the webhook url which should be returned.Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Deletes the entity with the given id.
Query Parameters
-
spaceId*Long
Message Body *
Long
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.No Response Body
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Creates the entity with the given properties.
use Wallee\Sdk\ApiClient;
use Wallee\Sdk\Model\CreationEntityState;
use Wallee\Sdk\Model\WebhookUrlCreate;
$spaceId = <:YOUR_SPACE_ID>;
$userId = <:YOUR_USER_ID>;
$secret = <:YOUR_USER_SECRET>;
$apiClient = new ApiClient($userId, $secret);
// Create webhook Url
$webHookName = 'Shopname: Webhook name';
$webHookUrl = 'https://yourdomain.com/webhook/action';
$entity = (new WebhookUrlCreate())
->setName($webHookName)
->setUrl($webHookUrl)
->setState(CreationEntityState::ACTIVE);
$apiClient->getWebhookUrlService()->create($spaceId, $entity);package com.wallee.walleesdk;
import com.wallee.sdk.ApiClient;
import com.wallee.sdk.model.WebhookUrl;
import com.wallee.sdk.model.WebhookUrlCreate;
import com.wallee.sdk.service.WebhookUrlService;
/**
* API tests for WebhookUrlService
*/
public class WebhookUrlServiceTest {
// Credentials
private Long spaceId = <:YOUR_SPACE_ID>;
private Long applicationUserId = <:YOUR_USER_ID>;
private String authenticationKey = <:YOUR_USER_SECRET>;
// Services
private ApiClient apiClient;
private WebhookUrlService webhookUrlService;
// Models
private WebhookUrlCreate webhookUrlPayload;
public WebhookUrlServiceTest() {
this.apiClient = new ApiClient(applicationUserId, authenticationKey);
this.webhookUrlService = new WebhookUrlService(this.apiClient);
}
/**
* Get webhook url payload
*
* @return WebhookUrlCreate
*/
private WebhookUrlCreate getWebhookUrlPayload() {
if (this.webhookUrlPayload == null) {
// Webhook url
WebhookUrlCreate urlCreate = new WebhookUrlCreate();
urlCreate
.name("Transaction webhook url")
.url("http://transactions.callback-url.com");
this.webhookUrlPayload = urlCreate;
}
return this.webhookUrlPayload;
}
/**
* create
*
*
* This operation creates a webhook url entity, that will be used for posting.
*/
public void create() {
try {
final WebhookUrl webhookUrl = this.webhookUrlService.create(spaceId, getWebhookUrlPayload());
// expect webhookUrl.getUrl() to be a URL beginning with https://
} catch (Exception e) {
e.printStackTrace();
}
}
}Query Parameters
-
spaceId*Long
Message Body *
The webhook url object with the properties which should be created.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Searches for the entities as specified by the given query.
Query Parameters
-
spaceId*Long
Message Body *
The query restricts the webhook urls which are returned by the search.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Collection of Webhook URL
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.
Query Parameters
-
spaceId*Long
Message Body *
The webhook url object with all the properties which should be updated. The id and the version are required properties.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.
-
409ErrorThis 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.
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
Counts the number of items in the database as restricted by the given filter.
Query Parameters
-
spaceId*Long
Message Body
The filter which restricts the entities which are used to calculate the count.
Responses
-
200OKThis status code indicates that a client request was successfully received, understood, and accepted.Long
-
442ErrorThis status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error.
-
542ErrorThis status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the client request.
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.1.1Account Details
Properties
-
activeVirtualWhether this account and all its parent accounts are active.Boolean
-
activeOrRestrictedActiveVirtualWhether this account and all its parent accounts are active or restricted active.Boolean
-
createdByThe ID of the user the account was created by.Long
-
createdOnThe date and time when the account was created.DateTime
-
deletedByThe ID of a user the account was deleted by.Long
-
deletedOnThe date and time when the account was deleted.DateTime
-
idA unique identifier for the object.Long
-
lastModifiedDateThe date and time when the object was last modified.DateTime
-
name3 - 200 charsThe name used to identify the account.String
-
parentAccountVirtualThe parent account responsible for administering this account.
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
restrictedActiveVirtualWhether this account and all its parent accounts are active or restricted active. There is at least one account that is restricted active.Boolean
-
scopeThe scope that the account belongs to.Long
-
stateThe object's current state.
-
subaccountLimitThe number of sub-accounts that can be created within this account.Long
-
typeThe account's type which defines its role and capabilities.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
CREATECreate
-
RESTRICTED_ACTIVERestricted Active
-
ACTIVEActive
-
INACTIVEInactive
-
DELETINGDeleting
-
DELETEDDeleted
Fields
-
CREATECreate
-
ACTIVEActive
-
INACTIVEInactive
-
DELETINGDeleting
-
DELETEDDeleted
Fields
-
CONTAINSContains
-
EQUALSEquals
-
EQUALS_IGNORE_CASEEquals Ignore Case
-
GREATER_THANGreater Than
-
GREATER_THAN_OR_EQUALGreater Than Or Equal
-
LESS_THANLess Than
-
LESS_THAN_OR_EQUALLess Than Or Equal
-
NOT_EQUALSNot Equals
-
NOT_EQUALS_IGNORE_CASENot Equals Ignore Case
-
NOT_CONTAINSNot Contains
-
IS_NULLIs Null
-
IS_NOT_NULLIs Not Null
4.1.6Database Details
Properties
-
idA unique identifier for the object.Long
-
name≤ 200 charsThe name used to identify the database.String
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
TEMPORARY_ISSUETemporary Issue
-
INTERNALInternal
-
END_USEREnd User
-
CONFIGURATIONConfiguration
-
DEVELOPERDeveloper
4.1.9Failure Reason Details
Properties
-
categoryThe category that the failure reason belongs to.
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
4.1.10Feature Details
Properties
-
betaWhether the feature is in beta stage and there may still be some issues.Boolean
-
categoryThe category that the feature belongs to.
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
logoPathThe path to the feature's logo image.String
-
nameThe localized name of the object.Map of String String
-
requiredFeaturesThe features that must be enabled for this feature to work properly.Collection of Long
-
sortOrderWhen listing features, they can be sorted by this number.Integer
-
visibleBoolean
4.1.11Feature Category Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
-
orderWeightWhen listing feature categories, they can be sorted by this number.Integer
4.1.12Line Item Reduction Details
4.1.13Metric Usage Details
The metric usage provides details about the consumption of a particular metric.
Properties
-
consumedUnitsThe number of consumed units.Decimal
-
metricDescriptionThe description of the consumed unit's metric.Map of String String
-
metricIdThe ID of the consumed units' metric.Long
-
metricNameThe name of the consumed units' metric.Map of String String
4.1.14Resource Path Details
Properties
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
path4 - 500 charsString
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
spaceIdLong
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.1.16Scope Details
Properties
-
domainName≤ 40 charsThe domain name that belongs to the scope.String
-
featuresThe list of features that are active in the scope.Collection of Feature
-
idA 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 charsThe name used to identify the scope.String
-
plannedPurgeDateThe 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≥ 1The port where the scope can be accessed.Integer
-
sslActiveWhether the scope supports SSL.Boolean
-
stateThe object's current state.
-
themesThe 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
-
urlVirtualThe URL where the scope can be accessed.String
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.1.17Space Details
Properties
-
accountThe account that the space belongs to.
-
activeVirtualWhether this space and all its parent accounts are active.Boolean
-
activeOrRestrictedActiveVirtualWhether this space and all its parent accounts are active or restricted active.Boolean
-
createdByThe ID of the user the space was created by.Long
-
createdOnThe date and time when the space was created.DateTime
-
databaseThe database the space is connected to and that holds the space's data.
-
deletedByThe ID of the user the space was deleted by.Long
-
deletedOnThe date and time when the space was deleted.DateTime
-
idA unique identifier for the object.Long
-
lastModifiedDateThe date and time when the object was last modified.DateTime
-
name3 - 200 charsThe name used to identify the space.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
postalAddressThe address that is used in communication with clients for example in emails, documents, etc.
-
primaryCurrencyThe currency that is used to display aggregated amounts in the space.String
-
requestLimitThe maximum number of API requests that are accepted within two minutes. This limit can only be changed with special privileges.Long
-
restrictedActiveVirtualWhether this space and all its parent accounts are active or restricted active. There is least one parent account that is restricted active.Boolean
-
stateThe object's current state.
-
technicalContactAddressesThe email address that will receive messages about technical issues and errors that occur in the space.Collection of String
-
timeZoneThe time zone that is used to schedule and run background processes. This does not affect the formatting of dates in the user interface.String
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.1.18Space Address Details
Properties
-
cityThe city, town or village.String
-
countryThe two-letter country code (ISO 3166 format).String
-
dependentLocality≤ 100 charsThe dependent locality which is a sub-division of the state.String
-
emailAddressThe email address used for communication with clients.String
-
familyName≤ 100 charsThe family or last name.String
-
givenName≤ 100 charsThe given or first name.String
-
mobilePhoneNumber≤ 100 charsThe phone number of a mobile phone.String
-
organizationName≤ 100 charsThe organization's name.String
-
phoneNumber≤ 100 charsThe phone number.String
-
postalStateThe name of the region, typically a state, county, province or prefecture.String
-
postcodeThe postal code, also known as ZIP, postcode, etc.String
-
salesTaxNumber≤ 100 charsThe sales tax number of the organization.String
-
salutation≤ 20 charsThe salutation e.g. Mrs, Mr, Dr.String
-
sortingCode≤ 100 charsThe sorting code identifying the post office where the PO Box is located.String
-
streetThe street or PO Box.String
4.1.19Space Reference Details
Properties
-
createdOnDateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
spaceIdLong
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
RESTRICTED_ACTIVERestricted Active
-
ACTIVEActive
-
INACTIVEInactive
-
DELETINGDeleting
-
DELETEDDeleted
4.1.21Space View Details
Properties
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name3 - 200 charsThe name used to identify the space view.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
spaceThe space that the space view belongs to.
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.1.22Web App Confirmation Request Details
Properties
-
code≤ 100 charsThe user returns to the web app after granting the permission. The HTTP request contains the code. Provide it here to confirm the web app installation.String
4.2.1Customer Details
Properties
-
createdOnThe date and time when the object was created.DateTime
-
customerId≤ 100 charsThe customer's ID in the merchant's system.String
-
emailAddressEmail≤ 254 charsThe customer's email address.String
-
familyName≤ 100 charsThe customer's family or last name.String
-
givenName≤ 100 charsThe customer's given or first name.String
-
idA unique identifier for the object.Long
-
languageThe language that is linked to the object.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
metaDataVirtualAllow to store additional information about the object.Map of String String
-
preferredCurrencyThe customer's preferred currency.String
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.2.2Customer Address Details
Properties
-
addressThe actual postal address.
-
addressTypeWhether the address is for billing or shipping or both.
-
createdOnThe date and time when the object was created.DateTime
-
customerThe customer that the object belongs to.
-
defaultAddressWhether this is the customer's default address.Boolean
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.2.4Customer Comment Details
Properties
-
content≤ 262,144 charsThe comment's actual content.String
-
createdByThe ID of the user the comment was created by.Long
-
createdOnThe date and time when the object was created.DateTime
-
customerThe customer that the object belongs to.Long
-
editedByThe ID of the user the comment was last updated by.Long
-
editedOnThe date and time when the comment was last updated.DateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
pinnedWhether the comment is pinned to the top.Boolean
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.2.5Customer Postal Address Details
Properties
-
city≤ 100 charsThe city, town or village.String
-
commercialRegisterNumber≤ 100 charsThe commercial registration number of the organization.String
-
countryThe two-letter country code (ISO 3166 format).String
-
dateOfBirthThe date of birth.Date
-
dependentLocality≤ 100 charsThe dependent locality which is a sub-division of the state.String
-
emailAddressEmail≤ 254 charsThe email address.String
-
familyName≤ 100 charsThe family or last name.String
-
genderThe gender.
-
givenName≤ 100 charsThe given or first name.String
-
legalOrganizationFormThe legal form of the organization.
-
mobilePhoneNumber≤ 100 charsThe phone number of a mobile phone.String
-
organizationName≤ 100 charsThe organization's name.String
-
phoneNumber≤ 100 charsThe phone number.String
-
postalStateThe name of the region, typically a state, county, province or prefecture.String
-
postcode≤ 40 charsThe postal code, also known as ZIP, postcode, etc.String
-
salesTaxNumber≤ 100 charsThe sales tax number of the organization.String
-
salutation≤ 20 charsThe salutation e.g. Mrs, Mr, Dr.String
-
socialSecurityNumber≤ 100 charsThe social security number.String
-
sortingCode≤ 100 charsThe sorting code identifying the post office where the PO Box is located.String
-
street≤ 300 charsThe street or PO Box.String
4.3.1Debt Collection Case Details
The debt collection case represents a try to collect the money from the debtor.
Properties
-
amountThe sum of all unpaid item prices in the case's currency. The amount can no longer be changed once the case has been reviewed.Decimal
-
billingAddressThe billing address that identifies the debtor.
-
closedOnThe date and time when the case was closed.DateTime
-
collectorConfigurationThe configuration that the case is processed with.
-
contractDateThe date and time when the contract with the debtor was signed.DateTime
-
createdOnThe date and time when the object was created.DateTime
-
creatorThe ID of the user the case was created by.Long
-
currencyThe three-letter code (ISO 4217 format) of the case's currency.String
-
dueDateThe date and time when the claim was due.DateTime
-
environmentThe environment in which the case is processed.
-
externalIdA 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
-
failedOnThe date and time when the case failed.DateTime
-
failureReasonThe reason for the failure of the case.
-
idA unique identifier for the object.Long
-
labelsThe labels providing additional information about the object.Collection of Label
-
languageThe language that is linked to the object.String
-
lineItemsThe line items that are subject of this debt collection case.Collection of Line Item
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
nextAttemptOnThe date and time when the next attempt at processing the case will be made.DateTime
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
processingStartedOnThe date and time when the processing of the case was started.DateTime
-
processingTimeoutOnThe date and time when the processing of the case times out.DateTime
-
referenceA unique reference to identify the debt collection case in communication with the debtor.String
-
reviewStartedOnThe date and time when the review of the case was started.DateTime
-
reviewedOnThe date and time when the case was reviewed.DateTime
-
reviewerThe ID of the user the case was reviewed by.Long
-
sourceThe source of the case stating the origin of the claim.
-
sourceEntityIdThe ID of the object that is the source of the case. Only defined if the case was created by an internal process.Long
-
spaceViewIdThe ID of the space view this object is linked to.Long
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.3.2Debt Collection Case Document Details
Properties
-
createdOnThe date and time when the object was created.DateTime
-
debtCollectionCaseThe debt collection case that this document belongs to.Long
-
fileName≤ 100 charsThe file name of the document.String
-
idA unique identifier for the object.Long
-
labelsThe labels providing additional information about the object.Collection of Label
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
mimeTypeThe MIME type of the document's content.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
uniqueId≤ 500 charsA unique identifier of the document.String
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.3.3Debt Collection Case Source Details
The debt collection case source represents the origin of the case. It allows to understand where the amount receivable is coming from.
Properties
-
descriptionThe localized description of the object.Map of String String
-
forcedPreparingStateWhether debt collection cases created from this source will skip review and directly enter preparing state.Boolean
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
Fields
-
CREATECreate
-
PREPARINGPreparing
-
REVIEWINGReviewing
-
PENDINGPending
-
PROCESSINGProcessing
-
CLOSEDClosed
-
FAILEDFailed
4.3.6Debt Collection Receipt Details
Properties
-
amountThe amount that was collected.Decimal
-
createdByThe ID of the user the receipt was created by.Long
-
createdOnThe date and time when the object was created.DateTime
-
debtCollectionCaseThe debt collection case that this document belongs to.Long
-
externalId1 - 100 charsA client-generated nonce which uniquely identifies the receipt.Subsequent requests with the same external ID do not lead to the creation of another receipt, but return the original one.String
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
sourceThe source stating where the receipt is coming from.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.3.7Debt Collection Receipt Source Details
The debt collection receipt source represents the origin of a particular part of the collected amount. It allows to understand from where the amount is coming from, e.g. if it was added manually or in some other way.
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
4.3.8Debt Collector Details
The debt collector connects to an external service to process debt collection cases and directs the debt collection process.
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
4.3.9Debt Collector Condition Details
A condition controls under which circumstances a collector configuration is applied to a debt collection case.
Properties
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 100 charsThe name used to identify the condition.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
typeThe condition type determines the criteria that a debt collection case must fulfill in order for a debt collector configuration to be considered for handling the case.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.3.10Debt Collector Condition Type Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
4.3.11Debt Collector Configuration Details
The debt collector configuration defines the behavior of the collection process for a particular collector.
Properties
-
collectorThe debt collector that the configuration is for.Long
-
conditionsConditions allow to define criteria that a debt collection case must fulfill in order for the debt collector configuration to be considered for processing the case.Collection of Long
-
enabledSpaceViewsThe space views for which the debt collector configuration is enabled. If empty, it is enabled for all space views.Collection of Long
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 100 charsThe name used to identify the debt collector configuration.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
priorityThe priority that determines the order in which debt collector configurations are taken into account when processing a case. Low values are considered first.Integer
-
skipReviewEnabledWhether the review of debt collection cases is skipped.Boolean
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.4.1Document Template Details
A document template contains the customizations for a particular document template type.
Properties
-
defaultTemplateWhether this is the default document template which is used whenever no specific template is specified for the same template type.Boolean
-
deliveryEnabledWhether documents of this template should be delivered.Boolean
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 100 charsThe name used to identify the document template.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
spaceIdThe ID of the space this object belongs to.Long
-
stateThe object's current state.
-
templateResourceThe resource path to a custom template to be used to generate PDF documents.
-
typeThe document template's type.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.4.2Document Template Type Details
Properties
-
descriptionThe localized description of the document template type.Map of String String
-
featureThe feature that this document template type belongs to.Long
-
groupThe group that this document template type belongs to.
-
idA unique identifier for the object.Long
-
titleThe localized title of the document template type.Map of String String
4.4.3Document Template Type Group Details
Properties
-
idA unique identifier for the object.Long
-
titleThe localized title of the group.Map of String String
4.4.4Rendered Document Details
Properties
-
dataCollection of Byte
-
documentTemplateType
-
mimeTypeString
-
titleString
4.5.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
-
queryThe query limits the returned entries. The query allows to restrict the entries to return and it allows to control the order of them.
4.5.2Entity Query Details
The entity query allows to search for specific entities by providing filters. This is similar to a SQL query.
Properties
-
filterThe filter node defines the root filter node of the query. The root node may contain multiple sub nodes with different filters in it.
-
languageThe 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
-
numberOfEntitiesThe number of entities defines how many entities should be returned. There is a maximum of 100 entities.Integer
-
orderBysThe order bys allows to define the ordering of the entities returned by the search.Collection of Entity Query Order By
-
startingEntityThe '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.5.3Entity Query Filter Details
The query filter allows to restrict the entities which are returned.
Properties
-
childrenThe '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
-
fieldNameThe 'fieldName' indicates the property on the entity which should be filtered. This property is only applicable on filter type 'LEAF'.String
-
operatorThe '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.
-
valueThe 'value' is used to compare with the 'fieldName' as defined by the 'operator'. This property is only applicable on filter type 'LEAF'.Object
The filter type defines how the filter is interpreted. Depending of the type different properties are relevant on the filter itself.
Fields
-
LEAFLeafThe leaf node defines a restriction on the result set.
-
ORORThe OR node defines a group of nodes which are combined with a logical OR.
-
ANDANDThe AND node defines a group of nodes which are combined with a logical AND.
4.5.5Entity Query Order By Details
The 'order by' allows to order the returned entities.
Properties
-
fieldName*String
-
sorting*
4.6.1Client Error Details
An error that is returned as the result of a bad user request or a misconfiguration.
Properties
-
dateDate when an error has occurred.String
-
defaultMessageThe error message which is translated into the default language (i.e. English).String
-
idUnique identifier of an error.String
-
messageThe error message which is translated in into the language of the client.String
-
typeThe type of the client error.
The type of Client Errors which can be returned by a service.
Fields
-
END_USER_ERRORUser ErrorUser error is the result of a direct user input.
-
CONFIGURATION_ERRORConfiguration ErrorA configuration Error indicates that there is an application configuration which is configured incorrectly.
-
DEVELOPER_ERRORDeveloper ErrorA developer Error indicates that there is a bad API request.
4.6.3Server Error Details
This error is thrown when something unexpected happens on our side.
Properties
-
dateDate when an error has occurred.String
-
idUnique identifier of an error.String
-
messageThis message describes an error.String
4.7.1Installment Calculated Plan Details
Properties
-
configuration
-
paymentMethodConfigurationsCollection of Payment Method Configuration
-
slicesCollection of Installment Calculated Slice
-
totalAmountDecimal
-
transaction
4.7.2Installment Calculated Slice Details
Properties
-
amountIncludingTaxDecimal
-
dueOnDateTime
-
lineItemsCollection of Line Item
4.7.3Installment Payment Details
An installment payment represents a payment paid in multiple slices.
Properties
-
createdOnThe date and time when the object was created.DateTime
-
idA unique identifier for the object.Long
-
initialTransaction
-
lineItemsCollection of Line Item
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
planConfigurationLong
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.7.4Installment Payment Slice Details
An installment payment slice represents a single transaction of money from the buyer to the merchant.
Properties
-
chargeOnDateTime
-
createdOnThe date and time when the object was created.DateTime
-
idA unique identifier for the object.Long
-
installmentPayment
-
lineItemsCollection of Line Item
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
linkedTransactionVirtualLong
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
transaction
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
CREATECreate
-
SCHEDULEDScheduled
-
CANCELEDCanceled
-
PREPARE_PROCESSINGPrepare Processing
-
PROCESSINGProcessing
-
FAILEDFailed
-
SUCCESSFULSuccessful
Fields
-
CREATECreate
-
CONFIRMEDConfirmed
-
AUTHORIZEDAuthorized
-
REJECTEDRejected
-
COMPLETEDCompleted
-
RUNNINGRunning
-
DONEDone
-
DEFAULTEDDefaulted
4.7.7Installment Plan Details
The installment plan allows to setup a template for an installment.
Properties
-
baseCurrencyThe base currency in which the installment fee and minimal amount are defined.String
-
conditionsIf a transaction meets all selected conditions the installment plan will be available to the customer to be selected.Collection of Long
-
idA unique identifier for the object.Long
-
installmentFeeThe installment fee is a fixed amount that is charged additionally when applying this installment plan.Decimal
-
interestRateThe interest rate is a percentage of the total amount that is charged additionally when applying this installment plan.Decimal
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
minimalAmountThe installment plan can only be applied if the order's total is at least the defined minimal amount.Decimal
-
name≤ 100 charsThe installment plan name is used internally to identify the plan in administrative interfaces.For example it is used within search fields and hence it should be distinct and descriptive.String
-
paymentMethodConfigurationsA installment plan can be enabled only for specific payment method configurations. Other payment methods will not be selectable by the buyer.Collection of Long
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
sortOrderThe sort order controls in which order the installation plans are listed. The sort order is used to order the plans in ascending order.Integer
-
spaceReference
-
stateThe object's current state.
-
taxClassThe tax class determines the taxes which are applicable on all fees linked to the installment plan.
-
termsAndConditionsThe terms and conditions will be displayed to the customer when he or she selects this installment plan.
-
titleThe title of the installment plan is used within the payment process. The title is visible to the buyer.Map of String String
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.7.8Installment Plan Slice Details
The installment plan slice defines a single slice of an installment plan.
Properties
-
idA unique identifier for the object.Long
-
lineItemTitleThe title of this slice's line items. The title is visible to the buyer.Map of String String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
periodThe period defines how much time passes between the last slice and this slice. The charge is triggered at the end of the period. When the slice should be charged immediately the period needs to be zero.String
-
planThe installment plan this slice belongs to.
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
priorityThe priority controls in which order the slices are applied. The lower the value the higher the precedence.Integer
-
proportion≥ 1The proportion defines how much of the total installment payment has to be paid in this slice. The value is summed up with the other slices and the ratio of all proportions compared to proportion of this slice determines how much the buyer has to pay in this slice.Decimal
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.8.1Address Details
Properties
-
city≤ 100 charsThe city, town or village.String
-
commercialRegisterNumber≤ 100 charsThe commercial registration number of the organization.String
-
countryThe two-letter country code (ISO 3166 format).String
-
dateOfBirthThe date of birth.Date
-
dependentLocality≤ 100 charsThe dependent locality which is a sub-division of the state.String
-
emailAddressEmail≤ 254 charsThe email address.String
-
familyName≤ 100 charsThe family or last name.String
-
genderThe gender.
-
givenName≤ 100 charsThe given or first name.String
-
legalOrganizationFormThe legal form of the organization.
-
mobilePhoneNumber≤ 100 charsThe phone number of a mobile phone.String
-
organizationName≤ 100 charsThe organization's name.String
-
phoneNumber≤ 100 charsThe phone number.String
-
postalStateThe name of the region, typically a state, county, province or prefecture.String
-
postcode≤ 40 charsThe postal code, also known as ZIP, postcode, etc.String
-
salesTaxNumber≤ 100 charsThe sales tax number of the organization.String
-
salutation≤ 20 charsThe salutation e.g. Mrs, Mr, Dr.String
-
socialSecurityNumber≤ 100 charsThe social security number.String
-
sortingCode≤ 100 charsThe sorting code identifying the post office where the PO Box is located.String
-
street≤ 300 charsThe street or PO Box.String
4.8.2Address Format Details
Properties
-
postCodeExamplesA list of sample post codes.Collection of String
-
postCodeRegexThe regular expression to validate post codes.String
-
requiredFieldsThe fields that are required in the address format.Collection of Address Format Field
-
usedFieldsThe fields that are used in the address format.Collection of Address Format Field
Fields
-
GIVEN_NAMEGiven Name
-
FAMILY_NAMEFamily Name
-
ORGANIZATION_NAMEOrganization Name
-
STREETStreet
-
DEPENDENT_LOCALITYDependent Locality
-
CITYCity
-
POSTAL_STATEPostal State
-
POST_CODEPost Code
-
SORTING_CODESorting Code
-
COUNTRYCountry
4.8.4Country Details
Properties
-
addressFormatSpecifies the country's way of formatting addresses.
-
isoCode2The country's two-letter code (ISO 3166-1 alpha-2 format).String
-
isoCode3The country's three-letter code (ISO 3166-1 alpha-3 format).String
-
nameThe name of the country.String
-
numericCodeThe country's three-digit code (ISO 3166-1 numeric format).String
-
stateCodesThe codes of all regions (e.g. states, provinces) of the country (ISO 3166-2 format).Collection of String
4.8.5Currency Details
Properties
-
currencyCodeThe currency's three-letter code (ISO 4217 format).String
-
fractionDigitsThe currency's number of decimals. When calculating amounts in this currency, the fraction digits determine the accuracy.Integer
-
nameThe name of the currency.String
-
numericCodeThe currency's three-digit code (ISO 4217 format).Integer
4.8.7Language Details
Properties
-
countryCodeThe two-letter code of the language's region (ISO 3166-1 alpha-2 format).String
-
ietfCodeThe language's IETF tag consisting of the two-letter ISO code and region e.g. en-US, de-CH.String
-
iso2CodeThe language's two-letter code (ISO 639-1 format).String
-
iso3CodeThe language's three-letter code (ISO 639-2/T format).String
-
nameThe name of the language.String
-
pluralExpressionThe expression to determine the plural index for a given number of items used to find the proper plural form for translations.String
-
primaryOfGroupWhether this is the primary language in a group of languages.Boolean
4.8.8Legal Organization Form Details
Properties
-
countryThe two-letter code of the country the legal organization form is used in (ISO 3166-1 alpha-2 format).String
-
descriptionThe localized descriptions of the legal organization form.Collection of Localized String
-
englishDescriptionThe English name of the legal organization form.String
-
idA unique identifier for the object.Long
-
shortcutThe localized shortcuts of the legal organization form.Collection of Localized String
4.8.9Localized String Details
Properties
-
languageThe term's language.String
-
stringThe localized term.String
4.8.11State Details
Properties
-
codeThe state's code used within addresses.String
-
countryString
-
countryCodeThe two-letter code of the state's country (ISO 3166-1 alpha-2 format).String
-
idThe state's code in ISO 3166-2 format.String
-
nameThe name of the state.String
4.9.1Label Details
Properties
-
contentThe label's actual content.Object
-
contentAsStringThe label's content formatted as string.String
-
descriptorThe descriptor that describes what information the label provides.
-
idA unique identifier for the object.Long
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.9.2Label Descriptor Details
Properties
-
categoryThe label's category.
-
descriptionThe localized description of the object.Map of String String
-
featuresThe features that this label belongs to.Collection of Long
-
groupThe group that this label belongs to.
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
-
typeThe type of the label's value.
-
weightWhen listing labels, they can be sorted by this number.Integer
4.9.4Label Descriptor Group Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
-
weightWhen listing label groups, they can be sorted by this number.Integer
4.9.5Label Descriptor Type Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
4.10.1Line Item Details
Properties
-
aggregatedTaxRateVirtualThe total tax rate applied to the item, calculated from the rates of all tax lines.Decimal
-
amountExcludingTaxVirtualThe line item price with discounts applied, excluding taxes.Decimal
-
amountIncludingTaxVirtualThe line item price with discounts applied, including taxes.Decimal
-
attributesA map of custom information for the item.Map of String Line Item Attribute
-
discountExcludingTaxVirtualThe discount allocated to the item, excluding taxes.Decimal
-
discountIncludingTaxThe discount allocated to the item, including taxes.Decimal
-
name1 - 150 charsThe name of the product, ideally in the customer's language.String
-
quantityPositiveThe number of items that were purchased.Decimal
-
shippingRequiredWhether the item required shipping.Boolean
-
sku≤ 200 charsThe SKU (stock-keeping unit) of the product.String
-
taxAmountVirtualThe sum of all taxes applied to the item.Decimal
-
taxAmountPerUnitVirtualThe calculated tax amount per unit.Decimal
-
taxesA set of tax lines, each of which specifies a tax applied to the item.Collection of Tax
-
typeThe type of the line item.
-
undiscountedAmountExcludingTaxVirtualThe line item price with discounts not applied, excluding taxes.Decimal
-
undiscountedAmountIncludingTaxVirtualThe line item price with discounts not applied, including taxes.Decimal
-
undiscountedUnitPriceExcludingTaxVirtualThe calculated price per unit with discounts not applied, excluding taxes.Decimal
-
undiscountedUnitPriceIncludingTaxVirtualThe calculated price per unit with discounts not applied, including taxes.Decimal
-
uniqueId≤ 200 charsThe unique identifier of the line item within the set of line items.String
-
unitPriceExcludingTaxVirtualThe calculated price per unit with discounts applied, excluding taxes.Decimal
-
unitPriceIncludingTaxVirtualThe calculated price per unit with discounts applied, including taxes.Decimal
4.10.2Line Item Attribute Details
4.11.1Manual Task Details
A manual task requires the manual intervention of a human.
Properties
-
actionsThe actions that can be triggered to handle the manual task.Collection of Long
-
contextEntityIdThe ID of the entity the manual task is linked to.Long
-
createdOnThe date and time when the object was created.DateTime
-
expiresOnThe date and time until when the manual task has to be handled.DateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
typeThe manual task's type.Long
4.11.2Manual Task Action Details
Properties
-
idA unique identifier for the object.Long
-
labelThe action's label.Map of String String
-
styleThe action's style.
-
taskTypeThe type of manual tasks this action belongs to.Long
4.11.5Manual Task Type Details
The manual task type indicates what kind of manual task is required to be executed by the human.
Properties
-
descriptionThe localized description of the object.Map of String String
-
featuresThe features that this type belongs to.Collection of Long
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
The address handling mode controls if the address is required and how it is enforced to be provided.
Fields
-
NOT_REQUIREDNot Required
-
REQUIRED_IN_URLRequired In Url
-
REQUIRED_ON_PAYMENT_PAGERequired On Payment Page
4.12.2Authenticated Card Data Details
This model holds the card data and optional cardholder authentication details.
Properties
-
cardHolderName≤ 100 charsThe card holder name is the name printed onto the card. It identifies the person who owns the card.String
-
cardVerificationCode3 - 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
-
cardholderAuthenticationThe 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).
-
cryptogramThe 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 charsString
-
tokenRequestorIdString
4.12.3Authenticated Card Data Details
This model holds the card data and optional cardholder authentication details.
Properties
-
cardHolderName≤ 100 charsThe card holder name is the name printed onto the card. It identifies the person who owns the card.String
-
cardVerificationCode3 - 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
-
cardholderAuthenticationThe 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).
-
cryptogramThe 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
-
primaryAccountNumber10 - 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 charsString
-
tokenRequestorIdString
4.12.4Bank Account Details
Properties
-
description≤ 100 charsThe optional description is shown along the identifier. The intention of the description is to give an alternative name to the bank account.String
-
idA unique identifier for the object.Long
-
identifier≤ 100 charsThe bank account identifier is responsible to uniquely identify the bank account.String
-
linkedSpaceIdThe ID of the space this object belongs to.Long
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
typeLong
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.7Bank Account Type Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
identifierNameMap of String String
-
nameThe localized name of the object.Map of String String
4.12.8Bank Transaction Details
Properties
-
adjustmentsThe adjustments applied on this bank transaction.Collection of Payment Adjustment
-
createdByThe created by indicates the user which has created the bank transaction.Long
-
createdOnThe date and time when the object was created.DateTime
-
currencyBankAccountThe currency bank account which is used to handle money flow.
-
externalId1 - 100 charsString
-
flowDirectionVirtual
-
idA unique identifier for the object.Long
-
linkedSpaceIdThe ID of the space this object belongs to.Long
-
paymentDateThe payment date describes the date when the transaction was made.DateTime
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
postingAmountThe posting amount indicates the amount including adjustments.Decimal
-
referenceString
-
source
-
stateThe object's current state.
-
totalAdjustmentAmountIncludingTaxVirtualDecimal
-
type
-
valueAmountDecimal
-
valueDateThe value date describes the date the amount is effective on the account.DateTime
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.10Bank Transaction Source Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
4.12.12Bank Transaction Type Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
Fields
-
FULLY_AUTHENTICATEDFully Authenticated
-
AUTHENTICATION_NOT_REQUIREDAuthentication Not Required
-
NOT_ENROLLEDNot Enrolled
-
ENROLLMENT_ERROREnrollment Error
-
AUTHENTICATION_ERRORAuthentication Error
This model defines the card authentication versions.
Fields
-
V1V1
-
V2V2
4.12.15Card Cryptogram Details
This model holds the additional card authentication.
Properties
-
type*
-
value*String
4.12.16Card Cryptogram Details
This model holds the additional card authentication.
Properties
-
type
-
valueString
This model defines the card cryptogram types.
Fields
-
SCHEME_TOKENScheme Token
4.12.18Cardholder Authentication Details
This model holds the cardholder authentication data (e.g. 3-D Secure authentication).
Properties
-
authenticationIdentifierThe authentication identifier as assigned by authentication system (e.g. XID or DSTransactionID).String
-
authenticationResponse*
-
authenticationValueThe cardholder authentication value. Also known as Cardholder Authentication Verification Value (CAVV).String
-
electronicCommerceIndicatorThe Electronic Commerce Indicator (ECI) value. The ECI is returned by authentication system and indicates the outcome/status of authentication.String
4.12.19Cardholder Authentication Details
This model holds the cardholder authentication data (e.g. 3-D Secure authentication).
Properties
-
authenticationIdentifierThe authentication identifier as assigned by authentication system (e.g. XID or DSTransactionID).String
-
authenticationResponse
-
authenticationValueThe cardholder authentication value. Also known as Cardholder Authentication Verification Value (CAVV).String
-
electronicCommerceIndicatorThe Electronic Commerce Indicator (ECI) value. The ECI is returned by authentication system and indicates the outcome/status of authentication.String
-
version
4.12.20Charge Details
Properties
-
createdOnThe date on which the charge was created on.DateTime
-
failureReason
-
idA unique identifier for the object.Long
-
languageThe language that is linked to the object.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
spaceViewIdThe ID of the space view this object is linked to.Long
-
stateThe object's current state.
-
timeZoneString
-
timeoutOnDateTime
-
transaction
-
type
-
userFailureMessageThe 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
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.21Charge Attempt Details
Properties
-
charge
-
completionBehavior
-
connectorConfiguration
-
createdOnThe date and time when the object was created.DateTime
-
customersPresenceThe customer's presence indicates which kind of customer interaction was used during the charge attempt.
-
environment
-
failedOnDateTime
-
failureReason
-
idA unique identifier for the object.Long
-
initializingTokenVersionBoolean
-
invocation
-
labelsThe labels providing additional information about the object.Collection of Label
-
languageThe language that is linked to the object.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
linkedTransactionVirtualLong
-
nextUpdateOnDateTime
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
redirectionUrlString
-
salesChannelLong
-
spaceViewIdThe ID of the space view this object is linked to.Long
-
stateThe object's current state.
-
succeededOnDateTime
-
terminal
-
timeZoneString
-
timeoutOnDateTime
-
tokenVersion
-
userFailureMessage≤ 2,000 charsThe 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
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
-
wallet
4.12.24Charge Bank Transaction Details
Properties
-
bankTransaction
-
completion
-
idA unique identifier for the object.Long
-
languageThe language that is linked to the object.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
linkedTransactionVirtualLong
-
spaceViewIdThe ID of the space view this object is linked to.Long
-
transaction
-
transactionCurrencyAmountSpecify the posting amount in the transaction's currency.Decimal
-
transactionCurrencyValueAmountVirtualDecimal
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.25Charge Flow Details
Properties
-
conditionsIf a transaction meets all selected conditions, the charge flow will be used to process the transaction. If the conditions are not met the next charge flow in line will be chosen according to the priorities.Collection of Long
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
nameThe 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
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
priorityThe 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
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.26Charge Flow Level Details
Properties
-
asynchronousChargeLong
-
configuration
-
createdOnThe date and time when the object was created.DateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
linkedTransactionVirtualLong
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
synchronousChargeLong
-
timeoutOnDateTime
-
tokenChargeLong
-
transaction
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.27Charge Flow Level Configuration Details
Properties
-
flowThe charge flow level configuration to which the flow is associated.
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 100 charsThe 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
-
periodThe duration of the level before switching to the next one.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
priorityThe 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
-
stateThe object's current state.
-
typeThe type determines how the payment link is delivered to the customer. Once the type is defined it cannot be changed anymore.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.28Charge Flow Level Configuration Type Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
labelMap of String String
-
nameThe localized name of the object.Map of String String
4.12.29Charge Flow Level Payment Link Details
Properties
-
chargeFlowLevel
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
paymentLinkVirtualString
Fields
-
ASYNCHRONOUSAsynchronous
-
SYNCHRONOUSSynchronous
-
TOKENToken
-
TERMINALTerminal
4.12.33Completion Line Item Details
4.12.34Connector Invocation Details
Properties
-
createdOnThe date and time when the object was created.DateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
plannedPurgeDateThe 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
-
timeTookInMillisecondsLong
-
transactionLong
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
PAYMENT_METHOD_LISTPayment Method List
-
FORM_GENERATIONForm Generation
-
VALIDATIONValidation
-
AUTHORIZATIONAuthorization
4.12.36Currency Bank Account Details
Properties
-
bankAccount
-
currencyString
-
environment
-
idA unique identifier for the object.Long
-
linkedSpaceIdThe ID of the space this object belongs to.Long
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
NOT_PRESENTNot Present
-
VIRTUAL_PRESENTVirtual Present
-
PHYSICAL_PRESENTPhysical Present
4.12.39Delivery Indication Details
Properties
-
automaticDecisionReason
-
automaticallyDecidedOnDateTime
-
completion
-
createdOnThe date and time when the object was created.DateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
linkedTransactionVirtualLong
-
manualDecisionTimeoutOnDateTime
-
manuallyDecidedByLong
-
manuallyDecidedOnDateTime
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
timeoutOnDateTime
-
transaction
4.12.40Delivery Indication Decision Reason Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
Fields
-
PENDINGPending
-
NOT_SUITABLENot Suitable
-
MANUAL_CHECK_REQUIREDManual Check Required
-
SUITABLESuitable
4.12.42External Transfer Bank Transaction Details
Properties
-
bankTransaction
-
externalAccountIdentifierString
-
externalAccountTypeString
-
externalBankNameString
-
idA unique identifier for the object.Long
-
linkedSpaceIdThe ID of the space this object belongs to.Long
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.43Final Balance Transaction Sums Details
Properties
-
brandString
-
dccTipAmountDecimal
-
dccTransactionAmountDecimal
-
dccTransactionCountInteger
-
idA unique identifier for the object.Long
-
productString
-
transactionAmountDecimal
-
transactionCountInteger
-
transactionCurrencyString
-
transactionTipAmountDecimal
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.44Internal Transfer Bank Transaction Details
Properties
-
idA unique identifier for the object.Long
-
linkedSpaceIdThe ID of the space this object belongs to.Long
-
sourceBankTransaction
-
targetBankTransaction
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.45Invoice Reconciliation Record Details
Properties
-
amountDecimal
-
createdOnThe date and time when the object was created.DateTime
-
idA unique identifier for the object.Long
-
invoice
-
linkedSpaceIdThe ID of the space this object belongs to.Long
-
record
4.12.46Invoice Reconciliation Record Details
Properties
-
addressString
-
amountDecimal
-
cityString
-
countryString
-
createdOnThe date and time when the object was created.DateTime
-
currencyString
-
discardedByLong
-
discardedOnThe discarded on date indicates when the bank transaction has been discarded.DateTime
-
environment
-
familyNameString
-
givenNameString
-
iban≤ 100 charsString
-
idA unique identifier for the object.Long
-
lastResolutionFailure
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
linkedTransactionVirtualLong
-
participantNumber≤ 100 charsString
-
paymentFeeAmountDecimal
-
paymentFeeCurrencyString
-
paymentReasonString
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
postCodeString
-
referenceNumber≤ 255 charsString
-
rejectionStatus
-
resolvedByLong
-
resolvedOnThe resolved on date indicates when the bank transaction has been resolved.DateTime
-
senderBankAccountString
-
stateThe object's current state.
-
streetString
-
type
-
uniqueId≤ 500 charsString
-
valueDateDateTime
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
NONENone
-
REJECTEDRejected
-
BULK_REJECTEDBulk Rejected
Fields
-
CREATECreate
-
PENDINGPending
-
UNRESOLVEDUnresolved
-
RESOLVEDResolved
-
DISCARDEDDiscarded
4.12.49Invoice Reconciliation Record Type Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
4.12.50Invoice Reimbursement Details
Properties
-
amountDecimal
-
createdOnThe date and time when the object was created.DateTime
-
currencyString
-
discardedByLong
-
discardedOnDateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdThe ID of the space this object belongs to.Long
-
paymentConnectorConfiguration
-
paymentInitiationAdviceFile
-
processedByLong
-
processedOnDateTime
-
recipientCityString
-
recipientCountryString
-
recipientFamilyNameString
-
recipientGivenNameString
-
recipientIbanString
-
recipientOrganizationNameString
-
recipientPostcodeString
-
recipientStreetString
-
refundMerchantReferenceString
-
senderIbanString
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.51Invoice Reimbursement Details
Properties
-
amountDecimal
-
createdOnThe date and time when the object was created.DateTime
-
currencyString
-
discardedByLong
-
discardedOnDateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdThe ID of the space this object belongs to.Long
-
paymentConnectorConfiguration
-
paymentInitiationAdviceFile
-
processedByLong
-
processedOnDateTime
-
recipientCityString
-
recipientCountryString
-
recipientFamilyNameString
-
recipientGivenNameString
-
recipientIbanString
-
recipientOrganizationNameString
-
recipientPostcodeString
-
recipientStreetString
-
senderIbanString
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
PENDINGPending
-
MANUAL_REVIEWManual Review
-
PROCESSINGProcessing
-
PROCESSEDProcessed
-
DISCARDEDDiscarded
4.12.54Payment Adjustment Details
Properties
-
amountExcludingTaxVirtualDecimal
-
amountIncludingTaxThe total amount of this adjustment including taxes.Decimal
-
rateInPercentage≤ 100The rate in percentage is the rate on which the adjustment amount was calculated with.Decimal
-
tax
-
type
4.12.55Payment Adjustment Type Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
The target state indicates the state that should be set on the charge attempt.
Fields
-
SUCCESSFULSuccessful
-
FAILEDFailed
4.12.57Payment App Charge Attempt Update Request Details
The charge attempt update request allows to change the state of a charge attempt. The charge attempt must be linked with a processor that was created by the payment Web App that invokes the operation.
Properties
-
chargeAttemptIdThis is the ID of the charge attempt that should be updated.Long
-
endUserFailureMessage≤ 2,000 charsThe end user failure message indicates to the end user (buyer) why the payment failed. The message has to be in the language of the end user. The language is provided within the payment page invocation URL.String
-
failureReasonIdThe failure reason indicates why the charge attempt failed. It is required when the target state is FAILED.Long
-
reference≤ 100 charsThe reference identifies the charge attempt within the systems of the external service provider. It is required when the target state is SUCCESSFUL.String
-
targetStateThe target state defines the state into which the charge attempt should be switched into. Once the charge attempt changed the state it will not be possible to change it again.
4.12.58Payment App Completion Configuration Details
Properties
-
completionEndpointURLThe completion endpoint is invoked to request the payment service provider to execute a completion.String
-
completionTimeoutInMinutesWhen the completion or the void is triggered we expect a feedback about the state of it. This timeout defines after how long we consider the void resp. completion as failed without receiving a final state update.Integer
-
maximalCompletionDelayInDaysThe completion resp. the void can be triggered a while after the authorization of the transaction has been executed. This delay defines how many days after the authorization the void resp. completion must be triggered at the latest.Integer
-
multipleCompletionsSupportedThis flag indicates whether the connector supports multiple completions for a single transaction or not.Boolean
-
voidEndpointURLThe void endpoint is invoked to request the payment service provider to execute a void.String
The target state indicates the state that should be set on the completion.
Fields
-
SUCCESSFULSuccessful
-
FAILEDFailed
4.12.60Payment App Completion Update Request Details
The completion update request allows to change the state of a completion. The completion must be linked with a processor that was created by the payment Web App that invokes the operation.
Properties
-
completionIdThis is the ID of the completion that should be updated.
-
failureReasonIdThe failure reason indicates why the completion failed. It is required when the target state is FAILED.Long
-
reference≤ 100 charsThe reference identifies the completion within the systems of the external service provider. It is required when the target state is SUCCESSFUL.String
-
targetStateThe target state defines the state into which the completion should be switched into. Once the completion changed the state it will not be possible to change it again.
4.12.61Payment App Connector Details
Properties
-
authorizationTimeoutString
-
completionConfigurationThe completion configuration defines how the deferred completion is processed. If it is not present it means that deferred completion is not supported by this connector.
-
connectorConfigurationThe connector configuration references the configuration that was created as part of this connector within the space. The connector configuration is referenced within transactions created with this connector.
-
createdOnThe created on date indicates when the connector was added.DateTime
-
externalId≤ 40 charsThe external ID corresponds to the ID provided during inserting of the processor.String
-
idA unique identifier for the object.Long
-
linkedSpaceIdThe ID of the space this object belongs to.Long
-
name≤ 100 charsThe name of the connector will be displayed within the user interfaces that the merchant is interacting with.String
-
paymentPageEndpointThe payment page endpoint is invoked to process the transaction. The endpoint is defined by the external service provider.String
-
processorThe processor references the app processor to which this connector belongs to. The relationship is established during the creation of the connector.
-
refundConfigurationThe refund configuration defines how refunds are processed. If it is not present it means that refunds are not supported by this connector.
-
stateThe object's current state.
-
updatedOnThe updated on date indicates when the last time the connector was updated on.DateTime
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.62Payment App Connector Creation Request Details
Properties
-
authorizationTimeoutInMinutes*When the transaction is not authorized within this timeout the transaction is considered as failed.Integer
-
completionConfigurationThe completion configuration allows the connector to support deferred completions on a transaction. If it is not provided the connector will not process transactions in deferred mode.
-
connector*The ID of the connector identifies which connector that should be linked with this web app connector. The connector defines the payment method.Long
-
externalId*1 - 40 charsThe external ID identifies the connector within the external system. It has to be unique per processor external ID and for any subsequent update the same ID must be sent.String
-
name*≤ 100 charsThe name of the connector will be displayed within the user interfaces that the merchant is interacting with.String
-
paymentPageEndpoint*URLThe payment page endpoint URL will be invoked by the buyer to carry out the authorization of the payment.String
-
processorExternalId*1 - 40 charsThe external ID of the processor identifies the processor to which this connector belongs to. The processor cannot be changed once it has been set on a connector.String
-
refundConfigurationThe refund configuration allows the connector to support refunds on transactions. In case no refund configuration is provided the connector will not support refunds.
4.12.64Payment App Processor Details
Properties
-
configuredEnvironment
-
createdOnThe created on date is the date when this processor has been added.DateTime
-
documentationUrlThe documentation URL points to a web site that describes how to configure and use the processor.String
-
externalId≤ 40 charsThe external ID corresponds to the ID that was provided during creation of the processor.String
-
idA unique identifier for the object.Long
-
installationIdThe installation ID identifies the Web App installation.Long
-
linkedSpaceIdThe ID of the space this object belongs to.Long
-
name≤ 100 charsThe name of the processor will be displayed within the user interfaces that the merchant is interacting with.String
-
processorConfigurationThis processor configuration is created as part of the app processor. Any transaction created with the processor is linked with this processor configuration.
-
productionModeUrlWhen the user sets the processor into the production mode the user will be forwarded to this URL to configure the production environment. When no URL is provided no redirection will happen.String
-
stateThe object's current state.
-
svgIcon≤ 10,000 charsString
-
updatedOnThe updated on date indicates when the last update on the processor occurred.DateTime
-
usableInProductionWhen the processor is ready to be used for transactions in the production environment this flag is set to true.Boolean
-
usableInProductionSinceDateTime
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.65Payment App Processor Creation Request Details
Properties
-
documentationUrl*URLThe documentation URL has to point to a description of how to configure and use the processor.String
-
externalId*1 - 40 charsThe external ID identifies the processor within the external system. It has to be unique per space and for any subsequent update the same ID must be sent.String
-
name*≤ 100 charsThe name of the processor will be displayed within the user interfaces that the merchant is interacting with.String
-
productionModeUrlURLThe production mode URL has to point to a site on which the merchant can set up the production mode for the processor.String
-
svgIcon*≤ 10,000 charsThe SVG icon will be displayed to the user to represent this processor.String
4.12.67Payment App Refund Configuration Details
Properties
-
multipleRefundsSupportedThis flag indicates whether the connector supports multiple refunds for a single transaction or not.Boolean
-
refundEndpointURLThe refund endpoint is invoked to request the payment service provider to execute a refund.String
-
refundTimeoutInMinutesWhen the refund is triggered we expect a feedback about the state of it. This timeout defines after how long we consider the refund as failed without receiving a final state update.Integer
The target state indicates the state that should be set on the refund.
Fields
-
SUCCESSFULSuccessful
-
FAILEDFailed
4.12.69Payment App Refund Update Request Details
The refund update request allows to change the state of a refund. The refund must be linked with a processor that was created by the payment Web App that invokes the operation.
Properties
-
failureReasonIdThe failure reason indicates why the refund failed. It is required when the target state is FAILED.Long
-
reference≤ 100 charsThe reference identifies the refund within the systems of the external service provider. It is required when the target state is SUCCESSFUL.String
-
refundIdThis is the ID of the refund that should be updated.Long
-
targetStateThe target state defines the state into which the refund should be switched into. Once the refund changed the state it will not be possible to change it again.
The target state indicates the state that should be set on the void.
Fields
-
SUCCESSFULSuccessful
-
FAILEDFailed
4.12.71Payment App Void Update Request Details
The void update request allows to change the state of a void. The void must be linked with a processor that was created by the payment Web App that invokes the operation.
Properties
-
failureReasonIdThe failure reason indicates why the void failed. It is required when the target state is FAILED.Long
-
reference≤ 100 charsThe reference identifies the void within the systems of the external service provider. It is required when the target state is SUCCESSFUL.String
-
targetStateThe target state defines the state into which the void should be switched into. Once the void changed the state it will not be possible to change it again.
-
voidIdThis is the ID of the void that should be updated.Long
4.12.72Payment Condition Type Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
4.12.73Payment Connector Details
Properties
-
dataCollectionTypeThe data collection type specifies how the payment information is collected.
-
deprecatedWhether the object was deprecated.Boolean
-
deprecationReasonThe deprecation reason describes why the object was deprecated.Map of String String
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
-
paymentMethodThe payment method that the connector supports.Long
-
paymentMethodBrandThe specific brand that this payment connector supports.
-
primaryRiskTakerThe entity that bears the main risk in the event that a contracting party fails to meet its obligations.
-
processorThe processor that the connector belongs to.Long
-
supportedCurrenciesThe currencies that are supported by the connector.Collection of String
-
supportedCustomersPresencesThe types of customer's presence that are supported by the connector.Collection of Customer's Presence
-
supportedFeaturesThe features that are supported by the connector.Collection of Long
4.12.74Payment 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
-
conditionTypeThe condition type determines the criteria that a transaction must fulfill in order for a connector configuration to be considered for processing the payment.
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 100 charsThe name used to identify the condition.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.75Payment Connector Configuration Details
Properties
-
applicableForTransactionProcessingVirtualWhether this connector configuration is enabled for processing payments, taking into account the state of the processor and payment method configurations.Boolean
-
conditionsConditions allow to define criteria that a transaction must fulfill in order for the connector configuration to be considered for processing the payment.Collection of Long
-
connectorThe connector that the configuration is for.Long
-
enabledSalesChannelsThe sales channels for which the connector configuration is enabled. If empty, it is enabled for all sales channels.Collection of Sales Channel
-
enabledSpaceViewsThe space views for which the connector configuration is enabled. If empty, it is enabled for all space views.Collection of Long
-
idA unique identifier for the object.Long
-
imagePathThe URL to the connector's image.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 100 charsThe name used to identify the connector configuration.String
-
paymentMethodConfigurationThe payment method configuration that the connector configuration belongs to.
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
priorityThe priority that determines the order in which connector configurations are taken into account when processing a payment. Low values are considered first.Integer
-
processorConfigurationThe processor configuration that the connector configuration belongs to.
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.76Payment Connector Feature Details
Properties
-
displayNameThe name of the feature.String
-
idA unique identifier for the object.Long
4.12.77Payment Contract Details
Properties
-
accountThis account that the contract belongs to.
-
activatedOnThe date and time when the contract was activated.DateTime
-
contractIdentifierThe identifier of the contract.String
-
contractTypeThe type of the contract.
-
createdByThe ID of the user the contract was created by.
-
createdOnThe date and time when the object was created.DateTime
-
externalIdA 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
-
idA unique identifier for the object.Long
-
lastModifiedDateThe date and time when the object was last modified.DateTime
-
rejectedOnThe date and time when the contract was rejected.DateTime
-
rejectionReasonThe reason for rejecting the contract.
-
startTerminatingOnThe date and time when the termination process of the contract was started.DateTime
-
stateThe object's current state.
-
terminatedByThe ID of the user the contract was terminated by.
-
terminatedOnThe date and time when the contract was terminated.DateTime
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
PENDINGPending
-
ACTIVEActive
-
TERMINATINGTerminating
-
TERMINATEDTerminated
-
REJECTEDRejected
4.12.79Payment Contract Type Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
4.12.80Payment Information Hash Details
A payment information hash is calculated based on the information entered by the user. The same input leads to the same hash. The hash is collision free.
Properties
-
idA unique identifier for the object.Long
-
type
-
valueString
4.12.81Payment Information Hash Type Details
Properties
-
idA unique identifier for the object.Long
-
nameMap of String String
4.12.82Payment Initiation Advice File Details
Properties
-
createdOnThe created on date indicates the date on which the entity was stored into the database.DateTime
-
failureMessageString
-
fileGeneratedOnDateTime
-
forwardedOnThe shipping date indicates the date on which the pain file was transferred to an external processing system.DateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdThe ID of the space this object belongs to.Long
-
nameString
-
processedOnDateTime
-
processor
-
stateThe object's current state.
Fields
-
CREATINGCreating
-
FAILEDFailed
-
CREATEDCreated
-
OVERDUEOverdue
-
UPLOADEDUploaded
-
DOWNLOADEDDownloaded
-
PROCESSEDProcessed
4.12.84Payment Link Details
The payment link defines an URL to automatically create transactions.
Properties
-
allowedPaymentMethodConfigurationsThe allowed payment method configurations restrict the payment methods which can be used with this payment link.Collection of Payment Method Configuration
-
appliedSpaceViewThe payment link can be conducted in a specific space view. The space view may apply a specific design to the payment page.Long
-
availableFromThe available from date defines the earliest date on which the payment link can be used. When no date is specified there will be no restriction.DateTime
-
availableUntilThe available from date defines the latest date on which the payment link can be used to initialize a transaction. When no date is specified there will be no restriction.DateTime
-
billingAddressHandlingModeThe billing address handling mode controls if the address is collected or not and how it is collected.
-
currencyThe currency defines in which currency the payment is executed in. If no currency is defined it has to be specified within the request parameter 'currency'.String
-
externalIdA 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
-
idA unique identifier for the object.Long
-
languageThe language defines the language of the payment page. If no language is provided it can be provided through the request parameter.String
-
lineItemsThe line items allows to define the line items for this payment link. When the line items are defined they cannot be overridden through the request parameters. If no amount for the payment link is defined, the additional checkout page to enter the amount is shown to the consumer.Collection of Line Item
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
maximalNumberOfTransactionsThe maximal number of transactions limits the number of transactions which can be created with this payment link.Integer
-
name≤ 100 charsThe payment link name is used internally to identify the payment link. For example the name is used within search fields and hence it should be distinct and descriptive.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
protectionModeThe protection mode determines if the payment link is protected against tampering and in what way.
-
shippingAddressHandlingModeThe shipping address handling mode controls if the address is collected or not and how it is collected.
-
stateThe object's current state.
-
urlVirtualThe URL defines the URL to which the user has to be forwarded to initialize the payment.String
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.86Payment Method Details
Properties
-
dataCollectionTypesThe data collection types that are supported by the payment method.Collection of Data Collection Type
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
imagePathThe path to the payment method's image which is displayed to the customer.String
-
merchantDescriptionMap of String String
-
nameThe localized name of the object.Map of String String
-
supportedCurrenciesThe currencies that are supported by the payment method.Collection of String
4.12.87Payment Method Brand Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
grayImagePathString
-
idA unique identifier for the object.Long
-
imagePathThe path to the payment brand's image which is displayed to the customer.String
-
nameThe localized name of the object.Map of String String
-
paymentMethodThe payment method that the brand belongs to.Long
4.12.88Payment Method Configuration Details
The payment method configuration builds the base to connect with different payment method connectors.
Properties
-
dataCollectionTypeThe data collection type specifies how the payment information is collected.
-
descriptionA custom description for the payment method which is displayed to the customer.Map of String String
-
idA unique identifier for the object.Long
-
imageResourcePathThe resource path to a custom image for the payment method which is displayed to the customer.
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 100 charsThe name used to identify the payment method configuration.String
-
oneClickPaymentModeThe one-click payment mode determines whether the customer can save their payment details for later payments.
-
paymentMethodThe payment method that the configuration is for.Long
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
resolvedDescriptionVirtualThe description for the payment method that is actually displayed to the customer. This is either the custom description, if defined, or otherwise the payment method's default one.Map of String String
-
resolvedImageUrlVirtualThe image URL for the payment method that is actually displayed to the customer. This is either the custom image, if defined, or otherwise the payment method's default one.String
-
resolvedTitleVirtualThe title for the payment method that is actually displayed to the customer. This is either the custom title, if defined, or otherwise the payment method's default one.Map of String String
-
sortOrderWhen listing payment methods, they can be sorted by this number.Integer
-
spaceId≥ 1The ID of the space this object belongs to.Long
-
stateThe object's current state.
-
titleA custom title for the payment method which is displayed to the customer.Map of String String
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.89Payment Processor Details
Payment processors handle the connection to third part companies (payment service providers) that technically manage payment transactions and therefore process payments.
Properties
-
companyNameThe name of the company to which the processor belongs.Map of String String
-
descriptionThe localized description of the object.Map of String String
-
headquartersLocationWhere the processor's headquarters are located.Map of String String
-
idA unique identifier for the object.Long
-
logoPathThe path to the logo image of the processor.String
-
nameThe localized name of the object.Map of String String
-
productNameThe name of the processor's product.Map of String String
4.12.90Payment Terminal Details
Properties
-
configurationVersionThe configuration that is assigned to the terminal and determines how it works.
-
defaultCurrencyVirtualThe default currency of the terminal.String
-
deviceNameThe name of the device that is currently linked to the payment terminal.String
-
deviceSerialNumberThe serial number of the device that is currently linked to the payment terminal.String
-
externalIdA 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
-
idA unique identifier for the object.Long
-
identifierThe unique identifier of the terminal, that is displayed on the device.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
locationVersionThe physical location where the terminal is used.
-
name≤ 100 charsThe name used to identify the payment terminal.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
typeThe type of the payment terminal.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.91Payment Terminal Address Details
Properties
-
cityThe city, town or village.String
-
countryThe two-letter country code (ISO 3166 format).String
-
dependentLocality≤ 100 charsThe dependent locality which is a sub-division of the state.String
-
emailAddressEmail≤ 254 charsThe email address.String
-
familyNameThe family or last name.String
-
givenNameThe given or first name.String
-
mobilePhoneNumber≤ 100 charsThe phone number of a mobile phone.String
-
organizationNameThe organization's name.String
-
phoneNumberThe phone number.String
-
postalStateThe name of the region, typically a state, county, province or prefecture.String
-
postcodeThe postal code, also known as ZIP, postcode, etc.String
-
salutation≤ 20 charsThe salutation e.g. Mrs, Mr, Dr.String
-
sortingCode≤ 100 charsThe sorting code identifying the post office where the PO Box is located.String
-
streetThe street or PO Box.String
4.12.92Payment Terminal Configuration Details
Properties
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 100 charsThe name used to identify the payment terminal configuration.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
typeThe type of payment terminals that this configuration can be assigned to.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
CREATECreate
-
ACTIVEActive
-
DELETINGDeleting
-
DELETEDDeleted
4.12.94Payment Terminal Configuration Version Details
Properties
-
configurationThe payment terminal configuration that the version belongs to.
-
connectorConfigurationsThe payment connector configurations that are available on the payment terminal.Collection of Long
-
createdByThe ID of the user the payment terminal configuration version was created by.Long
-
createdOnThe date and time when the object was created.DateTime
-
defaultCurrencyThe default currency that is used if none is set on the payment terminal itself. If it is empty, the currency is derived from the location of the terminal.String
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
maintenanceWindowDurationThe permitted duration of the terminal's maintenance window.String
-
maintenanceWindowStartThe start time of the terminal's maintenance window.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
timeZoneThe time zone of the payment terminal used to determine the maintenance window.String
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
-
versionAppliedImmediatelyWhether payment terminals are immediately updated to this configuration version. If not, it will be applied during the maintenance window.Boolean
Fields
-
PENDINGPending
-
SCHEDULINGScheduling
-
ACTIVEActive
-
DELETINGDeleting
-
DELETEDDeleted
4.12.96Payment Terminal Location Details
Properties
-
externalIdA 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
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 100 charsThe name used to identify the payment terminal location.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
CREATECreate
-
ACTIVEActive
-
DELETINGDeleting
-
DELETEDDeleted
4.12.98Payment Terminal Location Version Details
Properties
-
addressThe postal address of the location where the payment terminals are used.
-
contactAddressThe contact details if the person responsible for the payment terminals at this location.
-
createdByThe ID of the user the payment terminal location version was created by.Long
-
createdOnThe date and time when the object was created.DateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
locationThe payment terminal location that the version belongs to.
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
-
versionAppliedImmediatelyWhether payment terminals are immediately updated to this configuration version. If not, it will be applied during the maintenance window.Boolean
Fields
-
PENDINGPending
-
SCHEDULINGScheduling
-
ACTIVEActive
-
DELETINGDeleting
-
DELETEDDeleted
4.12.100Payment Terminal Receipt Type Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
Fields
-
CREATECreate
-
PREPARINGPreparing
-
ACTIVEActive
-
INACTIVEInactive
-
DECOMMISSIONINGDecommissioning
-
DECOMMISSIONEDDecommissioned
4.12.102Payment Terminal Type Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
4.12.103Payment Token Details
Properties
-
createdOnThe date and time when the object was created.DateTime
-
customerEmailAddress≤ 150 charsThe customer's email address.String
-
customerIdThe unique identifier of the customer in the external system.String
-
enabledForOneClickPaymentWhether the token is enabled for one-click payments, which simplify the payment process for the customer. One-click tokens are linked to customers via the customer ID.Boolean
-
externalIdA 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
-
idA unique identifier for the object.Long
-
languageThe language that is linked to the object.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
timeZoneThe customer's time zone, which affects how dates and times are formatted when communicating with the customer.String
-
tokenReference≤ 100 charsThe reference used to identify the payment token (e.g. the customer's ID or email address).String
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
The primary risk taker will have the main loss when one party of the contract does not fulfill the contractual duties.
Fields
-
CUSTOMERCustomer
-
MERCHANTMerchant
-
THIRD_PARTYThird Party
4.12.105Processor Configuration Details
Properties
-
applicationManagedWhether the processor configuration is managed by the application and therefore cannot be changed.Boolean
-
contractIdThe ID of the payment contract the processor configuration is linked to.Long
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 100 charsThe name used to identify the payment method configuration.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
processorThe payment processor that the configuration is for.Long
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
REGULAR_TRANSACTIONRegular Transaction
-
INITIAL_RECURRING_TRANSACTIONInitial Recurring Transaction
-
MERCHANT_INITIATED_RECURRING_TRANSACTIONMerchant Initiated Recurring Transaction
-
CUSTOMER_INITIATED_RECURRING_TRANSACTIONCustomer Initiated Recurring Transaction
4.12.108Refund Details
The refund represents a credit back to the customer. It can be issued by the merchant or by the customer (reversal).
Properties
-
amountDecimal
-
baseLineItemsCollection of Line Item
-
completion
-
createdByLong
-
createdOnThe date and time when the object was created.DateTime
-
environment
-
externalId1 - 100 charsThe external id helps to identify duplicate calls to the refund service. As such the external ID has to be unique per transaction.String
-
failedOnDateTime
-
failureReason
-
idA unique identifier for the object.Long
-
labelsThe labels providing additional information about the object.Collection of Label
-
languageThe language that is linked to the object.String
-
lineItemsVirtualCollection of Line Item
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
merchantReference≤ 100 charsString
-
nextUpdateOnDateTime
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
processingOnDateTime
-
processorReference≤ 150 charsString
-
reducedLineItemsCollection of Line Item
-
reductionsCollection of Line Item Reduction
-
stateThe object's current state.
-
succeededOnDateTime
-
taxesCollection of Tax
-
timeZoneString
-
timeoutOnDateTime
-
totalAppliedFeesThe total applied fees is the sum of all fees that have been applied so far.Decimal
-
totalSettledAmountThe total settled amount is the total amount which has been settled so far.Decimal
-
transaction
-
type
-
updatedInvoiceLong
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.109Refund Bank Transaction Details
Properties
-
bankTransaction
-
idA unique identifier for the object.Long
-
languageThe language that is linked to the object.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
linkedTransactionVirtualLong
-
refund
-
refundCurrencyAmountSpecify the posting amount in the refund's currency.Decimal
-
refundCurrencyValueAmountVirtualDecimal
-
spaceViewIdThe ID of the space view this object is linked to.Long
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.110Refund Comment Details
Properties
-
content≤ 262,144 charsThe comment's actual content.String
-
createdByThe ID of the user the comment was created by.Long
-
createdOnThe date and time when the object was created.DateTime
-
editedByThe ID of the user the comment was last updated by.Long
-
editedOnThe date and time when the comment was last updated.DateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
pinnedWhether the comment is pinned to the top.Boolean
-
refundLong
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.111Refund Recovery Bank Transaction Details
Properties
-
bankTransaction
-
idA unique identifier for the object.Long
-
languageThe language that is linked to the object.String
-
lineItemsThe line items contain the items which could be recovered.Collection of Line Item
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
linkedTransactionVirtualLong
-
refund
-
refundCurrencyAmountSpecify the posting amount in the refund's currency.Decimal
-
refundCurrencyValueAmountVirtualDecimal
-
spaceViewIdThe ID of the space view this object is linked to.Long
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
CREATECreate
-
SCHEDULEDScheduled
-
PENDINGPending
-
MANUAL_CHECKManual Check
-
FAILEDFailed
-
SUCCESSFULSuccessful
Fields
-
MERCHANT_INITIATED_ONLINEMerchant Initiated Online
-
MERCHANT_INITIATED_OFFLINEMerchant Initiated Offline
-
CUSTOMER_INITIATED_AUTOMATICCustomer Initiated Automatic
-
CUSTOMER_INITIATED_MANUALCustomer Initiated Manual
4.12.114Rendered Terminal Receipt Details
Properties
-
dataThe data property contains the binary data of the receipt document encoded as base 64 encoded string.Collection of Byte
-
mimeTypeThe mime type indicates the format of the receipt document. The mime type depends on the requested receipt format.String
-
printedThe terminal might or might not print the receipt. This property is set to true when the configuration of the terminal forces the printing and the device supports the receipt printing.Boolean
-
receiptTypeEach receipt has a different usage. The receipt type indicates for what resp. for whom the document is for.
4.12.115Rendered Terminal Transaction Summary Details
Properties
-
dataThe data property contains the binary data of the receipt document encoded as base 64 encoded string.Collection of Byte
-
mimeTypeThe mime type indicates the format of the receipt document. The mime type depends on the requested receipt format.String
4.12.116Sales Channel Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
-
sortOrderWhen listing sales channels, they can be sorted by this number.Integer
4.12.117Terminal Receipt Fetch Request Details
The receipt fetch request allows to retrieve the receipt documents for a terminal transaction.
Properties
-
format*The format determines in what format the receipt will be returned in.
-
summaryId*The id of the transaction summary receipt whose content should be returned.Long
-
widthThe width controls how width the document will be rendered. In case of the PDF format the width is in mm. In case of the text format the width is in the number of chars per line.Integer
4.12.118Terminal Receipt Fetch Request Details
The receipt fetch request allows to retrieve the receipt documents for a terminal transaction.
Properties
-
format*The format determines in what format the receipts will be returned in.
-
transaction*Provide here the ID of the transaction for which the receipts should be fetched.Long
-
widthThe width controls how width the document will be rendered. In case of the PDF format the width is in mm. In case of the text format the width is in the number of chars per line.Integer
4.12.119Token Version Details
Properties
-
activatedOnDateTime
-
billingAddress
-
createdOnThe date and time when the object was created.DateTime
-
environment
-
expiresOnThe expires on date indicates when token version expires. Once this date is reached the token version is marked as obsolete.DateTime
-
iconUrlVirtualString
-
idA unique identifier for the object.Long
-
labelsThe labels providing additional information about the object.Collection of Label
-
languageVirtualThe language that is linked to the object.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 150 charsString
-
obsoletedOnDateTime
-
paymentConnectorConfiguration
-
paymentInformationHashesThe payment information hash set contains hashes of the payment information represented by this token version.Collection of Payment Information Hash
-
paymentMethodLong
-
paymentMethodBrandLong
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
processorToken≤ 150 charsString
-
shippingAddress
-
stateThe object's current state.
-
token
-
typeThe token version type determines what kind of token it is and by which payment connector the token can be processed by.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.121Token Version Type Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
feature
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
The tokenization mode controls how the tokenization of payment information is applied on the transaction.
Fields
-
FORCE_UPDATEForce Update
-
FORCE_CREATIONForce Creation
-
FORCE_CREATION_WITH_ONE_CLICK_PAYMENTForce Creation With One Click Payment
-
ALLOW_ONE_CLICK_PAYMENTAllow One Click Payment
4.12.123Tokenized Card Data Details
This model holds the card data in plain.
Properties
-
cardHolderName≤ 100 charsThe card holder name is the name printed onto the card. It identifies the person who owns the card.String
-
cardVerificationCode3 - 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
-
cryptogramThe 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 charsString
-
tokenRequestorIdString
4.12.124Tokenized Card Data Details
This model holds the card data in plain.
Properties
-
cardHolderName≤ 100 charsThe card holder name is the name printed onto the card. It identifies the person who owns the card.String
-
cardVerificationCode3 - 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
-
cryptogramThe 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
-
primaryAccountNumber10 - 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 charsString
-
tokenRequestorIdString
4.12.125Transaction Details
Properties
-
acceptHeaderThe 'Accept' header of the customer's web browser.String
-
acceptLanguageHeaderThe 'Accept Language' header of the customer's web browser.String
-
allowedPaymentMethodBrandsThe payment method brands that can be used to authorize the transaction.Collection of Long
-
allowedPaymentMethodConfigurationsThe payment method configurations that can be used to authorize the transaction.Collection of Long
-
authorizationAmountThe sum of all line item prices including taxes in the transaction's currency.Decimal
-
authorizationEnvironmentThe environment in which the transaction was authorized.
-
authorizationSalesChannelThe sales channel through which the transaction was placed.Long
-
authorizationTimeoutOnThe date and time when the transaction must be authorized, otherwise it will canceled.DateTime
-
authorizedOnThe date and time when the transaction was authorized.DateTime
-
autoConfirmationEnabledWhether the transaction can be confirmed automatically or whether this must be done explicitly via the API. Default is true.Boolean
-
billingAddressThe address associated with the payment method for invoicing and transaction processing purposes.
-
chargeRetryEnabledWhether the customer can make further payment attempts if the first one has failed. Default is true.Boolean
-
completedAmountThe total amount that was completed, in the transaction's currency.Decimal
-
completedOnThe date and time when the transaction was completed.DateTime
-
completionBehaviorThe behavior that controls when the transaction is completed.
-
completionTimeoutOnThe date and time when the transaction is completed automatically.DateTime
-
confirmedByThe ID of the user the transaction was confirmed by.Long
-
confirmedOnThe date and time when the transaction was created.DateTime
-
createdByThe ID of the user the transaction was created by.Long
-
createdOnThe date and time when the object was created.DateTime
-
currencyThe three-letter code (ISO 4217 format) of the transaction's currency.String
-
customerEmailAddress≤ 254 charsThe customer's email address.String
-
customerIdThe unique identifier of the customer in the external system.String
-
customersPresenceThe customer's presence indicates whether and in what way the transaction's customer is present. Default is VIRTUAL_PRESENT.
-
deliveryDecisionMadeOnThis date and time when the decision was made as to whether the order should be shipped.DateTime
-
deviceSessionIdentifier10 - 40 chars([a-zA-Z0-9_-])*Allows to link the transaction to the data collected from the customer's device.String
-
emailsDisabledWhether email sending is deactivated for the transaction. Default is false.Boolean
-
endOfLifeThe date and time when the transaction reaches its end of live. No further actions can be carried out at this time.DateTime
-
environment
-
environmentSelectionStrategyThe strategy for determining whether the transaction is to be processed in the test or production environment.
-
failedOnThe date and time when the transaction failed.DateTime
-
failedUrl9 - 2,000 optionsURLVirtualThe URL to redirect the customer back to after they canceled or failed to authenticated their payment.String
-
failureReasonThe reason for the failure of the transaction.
-
groupThe group that the transaction belongs to.
-
idA unique identifier for the object.Long
-
internetProtocolAddressThe IP address of the customer's device.String
-
internetProtocolAddressCountryThe country determined from the IP address of the customer's device.String
-
invoiceMerchantReference≤ 100 charsThe merchant's reference used to identify the invoice.String
-
javaEnabledWhether Java is enabled on the customer's web browser.Boolean
-
languageThe language that is linked to the object.String
-
lineItemsThe line items purchased by the customer.Collection of Line Item
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
merchantReference≤ 100 charsThe merchant's reference used to identify the transaction.String
-
metaDataVirtualAllow to store additional information about the object.Map of String String
-
parentThe parent transaction which was (partially) replaced by this transaction.Long
-
paymentConnectorConfigurationThe payment connector configuration that was used to authorize the transaction.
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
processingOnThe date and time when the processing of the transaction was started.DateTime
-
refundedAmountThe total amount that was refunded, in the transaction's currency.Decimal
-
screenColorDepthThe screen color depth of the customer's web browser.String
-
screenHeightThe screen height of the customer's web browser.String
-
screenWidthThe screen width of the customer's web browser.String
-
shippingAddressThe address to where the order will be shipped.
-
shippingMethod≤ 200 charsThe name of the shipping method used to ship the products.String
-
spaceViewIdThe ID of the space view this object is linked to.Long
-
stateThe object's current state.
-
successUrl9 - 2,000 optionsURLVirtualThe URL to redirect the customer back to after they successfully authenticated their payment.String
-
terminalThe payment terminal through which the payment was processed.
-
timeZoneThe customer's time zone, which affects how dates and times are formatted when communicating with the customer.String
-
tokenThe payment token that should be used to charge the customer.
-
tokenizationModeThe tokenization mode specifies whether and how the tokenization of payment information is applied to the transaction.
-
totalAppliedFeesThe total of all fees charged, in the transaction's currency.Decimal
-
totalSettledAmountThe total amount that was settled, in the transaction's currency.Decimal
-
userAgentHeaderThe 'User Agent' header of the customer's web browser.String
-
userFailureMessageThe message that can be displayed to the customer explaining why the transaction failed, in the customer's language.String
-
userInterfaceTypeThe type of user interface the customer used to provide the payment information.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
-
windowHeightThe window height of the customer's web browser.String
-
windowWidthThe window width of the customer's web browser.String
-
yearsToKeepThe number of years the transaction is kept after its authorization.Integer
4.12.126Transaction Aware Entity Details
Properties
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
linkedTransactionVirtualLong
4.12.127Transaction Comment Details
Properties
-
content≤ 262,144 charsThe comment's actual content.String
-
createdByThe ID of the user the comment was created by.Long
-
createdOnThe date and time when the object was created.DateTime
-
editedByThe ID of the user the comment was last updated by.Long
-
editedOnThe date and time when the comment was last updated.DateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
pinnedWhether the comment is pinned to the top.Boolean
-
transactionLong
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.128Transaction Completion Details
Properties
-
amountThe amount which is captured. The amount represents sum of line items including taxes.Decimal
-
baseLineItemsThe base line items on which the completion is applied on.Collection of Line Item
-
createdByLong
-
createdOnThe date and time when the object was created.DateTime
-
externalId1 - 100 charsThe external ID helps to identify the entity and a subsequent creation of an entity with the same ID will not create a new entity.String
-
failedOnDateTime
-
failureReason
-
idA unique identifier for the object.Long
-
invoiceMerchantReference≤ 100 charsString
-
labelsThe labels providing additional information about the object.Collection of Label
-
languageThe language that is linked to the object.String
-
lastCompletionIndicates if this is the last completion. After the last completion is created the transaction cannot be completed anymore.Boolean
-
lineItemVersion
-
lineItemsThe line items which are captured.Collection of Line Item
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
linkedTransactionVirtualLong
-
mode
-
nextUpdateOnDateTime
-
paymentInformationString
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
processingOnDateTime
-
processorReferenceString
-
remainingLineItemsVirtualCollection of Line Item
-
spaceViewIdThe ID of the space view this object is linked to.Long
-
stateThe object's current state.
-
statementDescriptor≤ 80 options[a-zA-Z0-9\s.,_?+/-]*The statement descriptor explain charges or payments on bank statements.String
-
succeededOnDateTime
-
taxAmountThe total sum of all taxes of line items.Decimal
-
timeZoneString
-
timeoutOnDateTime
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
COMPLETE_IMMEDIATELYComplete Immediately
-
COMPLETE_DEFERREDComplete Deferred
-
USE_CONFIGURATIONUse Configuration
4.12.131Transaction Completion Request Details
Properties
-
externalId*1 - 100 charsThe external ID helps to identify the entity and a subsequent creation of an entity with the same ID will not create a new entity.String
-
invoiceMerchantReference≤ 100 charsString
-
lastCompletion*The last completion flag indicates if this is the last completion. After the last completion is created no further completions can be issued.Boolean
-
lineItemsThe line items which will be used to complete the transaction.Collection of Completion Line Item . Create Create
-
statementDescriptor≤ 80 options[a-zA-Z0-9\s.,_?+/-]*The statement descriptor explain charges or payments on bank statements.String
-
transactionId*The ID of the transaction which should be completed.Long
Fields
-
CREATECreate
-
SCHEDULEDScheduled
-
PENDINGPending
-
FAILEDFailed
-
SUCCESSFULSuccessful
Fields
-
FORCE_TEST_ENVIRONMENTForce Test Environment
-
FORCE_PRODUCTION_ENVIRONMENTForce Production Environment
-
USE_CONFIGURATIONUse Configuration
4.12.134Transaction Group Details
Properties
-
beginDateThe date and time when the initial transaction in the group was created.DateTime
-
customerId≤ 100 charsThe unique identifier of the customer in the external system.String
-
endDateThe date and time when the final transaction in the group was last updated.DateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.136Transaction Invoice Details
The transaction invoice represents the invoice document for a particular transaction.
Properties
-
amountDecimal
-
billingAddress
-
completion
-
createdOnThe date on which the invoice is created on.DateTime
-
derecognizedByThe id of the user which marked the invoice as derecognized.Long
-
derecognizedOnThe date on which the invoice is marked as derecognized.DateTime
-
dueOnThe date on which the invoice should be paid on.DateTime
-
environment
-
externalId1 - 100 charsThe external id helps to identify the entity and a subsequent creation of an entity with the same ID will not create a new entity.String
-
idA unique identifier for the object.Long
-
languageThe language that is linked to the object.String
-
lineItemsCollection of Line Item
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
linkedTransactionVirtualLong
-
merchantReference≤ 100 charsString
-
outstandingAmountThe outstanding amount indicates how much the buyer owes the merchant. A negative amount indicates that the invoice is overpaid.Decimal
-
paidOnThe date on which the invoice is marked as paid. Eventually this date lags behind of the actual paid date.DateTime
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
spaceViewIdThe ID of the space view this object is linked to.Long
-
stateThe object's current state.
-
taxAmountDecimal
-
timeZoneString
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.137Transaction Invoice Comment Details
Properties
-
content≤ 262,144 charsThe comment's actual content.String
-
createdByThe ID of the user the comment was created by.Long
-
createdOnThe date and time when the object was created.DateTime
-
editedByThe ID of the user the comment was last updated by.Long
-
editedOnThe date and time when the comment was last updated.DateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
pinnedWhether the comment is pinned to the top.Boolean
-
transactionInvoiceLong
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.138Transaction Invoice Replacement Details
Properties
-
billingAddress
-
dueOnThe date on which the invoice should be paid on.DateTime
-
externalId*1 - 100 charsThe external id helps to identify the entity and a subsequent creation of an entity with the same ID will not create a new entity.String
-
lineItems*Collection of Line Item Create
-
merchantReference≤ 100 charsString
-
sentToCustomerWhen the connector is configured to send the invoice to the customer and this property is true the customer will receive an email with the updated invoice. When this property is false no invoice is sent.Boolean
Fields
-
CREATECreate
-
OPENOpen
-
OVERDUEOverdue
-
CANCELEDCanceled
-
PAIDPaid
-
DERECOGNIZEDDerecognized
-
NOT_APPLICABLENot Applicable
4.12.140Transaction Line Item Version Details
Properties
-
amountDecimal
-
createdByLong
-
createdOnThe date and time when the object was created.DateTime
-
externalIdA 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
-
failedOnDateTime
-
failureReason
-
idA unique identifier for the object.Long
-
labelsThe labels providing additional information about the object.Collection of Label
-
languageThe language that is linked to the object.String
-
lineItemsCollection of Line Item
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
linkedTransactionVirtualLong
-
nextUpdateOnDateTime
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
processingOnDateTime
-
spaceViewIdThe ID of the space view this object is linked to.Long
-
stateThe object's current state.
-
succeededOnDateTime
-
taxAmountDecimal
-
timeoutOnDateTime
-
transaction
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.141Transaction Line Item Version . Create Details
Properties
-
externalId*A client generated nonce which identifies the entity to be created. Subsequent creation requests with the same external ID will not create new entities but return the initially created entity instead.String
-
lineItems*Collection of Line Item Create
-
transaction*ID of Transaction
Fields
-
CREATECreate
-
SCHEDULEDScheduled
-
PENDINGPending
-
SUCCESSFULSuccessful
-
FAILEDFailed
Fields
-
CREATECreate
-
PENDINGPending
-
CONFIRMEDConfirmed
-
PROCESSINGProcessing
-
FAILEDFailed
-
AUTHORIZEDAuthorized
-
VOIDEDVoided
-
COMPLETEDCompleted
-
FULFILLFulfill
-
DECLINEDecline
4.12.144Transaction Summary DCC Transaction Sums Details
Properties
-
brandString
-
dccAmountDecimal
-
dccCurrencyString
-
idA unique identifier for the object.Long
-
transactionAmountDecimal
-
transactionCountInteger
-
transactionCurrencyString
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
IFRAMEIframe
-
LIGHTBOXLightbox
-
PAYMENT_PAGEPayment Page
-
MOBILE_SDKMobile Sdk
-
TERMINALTerminal
4.12.146Transaction Void Details
Properties
-
createdByLong
-
createdOnThe date and time when the object was created.DateTime
-
failedOnDateTime
-
failureReason
-
idA unique identifier for the object.Long
-
labelsThe labels providing additional information about the object.Collection of Label
-
languageThe language that is linked to the object.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
linkedTransactionVirtualLong
-
mode
-
nextUpdateOnDateTime
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
processorReferenceString
-
spaceViewIdThe ID of the space view this object is linked to.Long
-
stateThe object's current state.
-
succeededOnDateTime
-
timeoutOnDateTime
-
transaction
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
CREATECreate
-
PENDINGPending
-
FAILEDFailed
-
SUCCESSFULSuccessful
4.12.149Transaction summary Details
Properties
-
dccTransactionSumsCollection of Transaction Summary DCC Transaction Sums
-
endedOnDateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdThe ID of the space this object belongs to.Long
-
numberOfTransactionsInteger
-
paymentTerminalLong
-
receiptString
-
referenceLong
-
startedOnDateTime
-
transactionSumsCollection of Final Balance Transaction Sums
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.12.150Transaction summary Reference Details
Properties
-
idA unique identifier for the object.Long
-
linkedSpaceIdThe ID of the space this object belongs to.Long
-
terminalIdLong
-
terminalIdentifierString
4.12.151Wallet Type Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
4.13.2Shopify Integration Details
A Shopify Integration allows to connect a Shopify shop.
Properties
-
additionalLineItemDataCollection of Shopify Additional Line Item Data
-
allowInvoiceDownloadBoolean
-
allowedPaymentMethodConfigurationsCollection of Payment Method Configuration
-
currencyString
-
idA unique identifier for the object.Long
-
integratedPaymentFormEnabledEnabling the integrated payment form will embed the payment form in the Shopify shop. The app needs to be installed for this to be possible.Boolean
-
languageThe checkout language forces a specific language in the checkout. Without a checkout language the browser setting of the buyer is used to determine the language.String
-
loginName≤ 100 charsThe login name is used to link a specific Shopify payment gateway to this integration.This login name is to be filled into the appropriate field in the shop's payment gateway configuration.String
-
name≤ 100 charsThe integration name is used internally to identify a specific integration.For example the name is used withinsearch fields and hence it should be distinct and descriptive.String
-
paymentAppVersion
-
paymentInstalledBoolean
-
paymentProxyPath[A-Za-z0-9-_/]*Define the path of the proxy URL. This only needs to be changed if the app's proxy URL is overwritten in the Shopify store.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
replacePaymentMethodImageBoolean
-
shopName≤ 100 chars([^\p{C}\p{Cn}\p{Zl}\p{Zp}.]|[ ])*The store address is used to link a specific Shopify shop to this integration. This is the name used in the Shopify's admin URL: [storeAddress].myshopify.comString
-
showPaymentInformationBoolean
-
showSubscriptionInformationBoolean
-
spaceId≥ 1Long
-
spaceViewIdThe ID of the space view this object is linked to.Long
-
stateThe object's current state.
-
subscriptionAppVersion
-
subscriptionInstalledBoolean
-
subscriptionProxyPath[A-Za-z0-9-_/]*Define the path of the proxy URL. This only needs to be changed if the app's proxy URL is overwritten in the Shopify store.String
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
BASICBasic
-
SUBSCRIPTIONSubscription
-
API_2019_07Api 2019 07
4.13.5Shopify Recurring Order Details
Properties
-
billedOnDateTime
-
checkoutTokenString
-
createdOnDateTime
-
failureReason
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
linkedTransactionVirtualLong
-
orderIdString
-
orderNameString
-
plannedExecutionDateDateTime
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
recurrenceNumberInteger
-
shopLong
-
startedProcessingOnDateTime
-
stateThe object's current state.
-
subscriptionVersion
-
transaction
Fields
-
PENDINGPending
-
ONHOLDOnhold
-
PROCESSINGProcessing
-
CANCELEDCanceled
-
BILLEDBilled
-
FAILEDFailed
4.13.7Shopify Recurring Order Update Request Details
Properties
-
executionDateDateTime
-
recurringOrderIdLong
4.13.8Shopify Subscriber Details
Properties
-
createdOnDateTime
-
emailAddressEmail≤ 254 charsString
-
externalIdA 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
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
phoneNumber≤ 254 charsString
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
shopLong
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.13.9Shopify Subscriber Creation Details
Properties
-
emailAddressString
-
phoneNumberString
-
shopifyCustomerId*The customer ID has to correspond to the ID assigned to the customer by Shopify. When the subscriber already exists no new subscriber will be created.String
4.13.11Shopify Subscription Details
Properties
-
createdByLong
-
createdOnDateTime
-
externalId1 - 100 charsThe external id helps to identify the entity and a subsequent creation of an entity with the same ID will not create a new entity.String
-
idA unique identifier for the object.Long
-
initialExecutionDateDateTime
-
initialPaymentTransactionLong
-
initialShopifyTransactionLong
-
languageThe language that is linked to the object.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
orderRecurrenceNumberInteger
-
shopLong
-
stateThe object's current state.
-
subscriber
-
terminatedByLong
-
terminatedOnDateTime
-
terminationRequestDateDateTime
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.13.12Shopify Subscription Address Details
Properties
-
cityThe city, town or village.String
-
commercialRegisterNumber≤ 100 charsThe commercial registration number of the organization.String
-
countryThe two-letter country code (ISO 3166 format).String
-
dateOfBirthThe date of birth.Date
-
dependentLocality≤ 100 charsThe dependent locality which is a sub-division of the state.String
-
emailAddressEmail≤ 254 charsThe email address.String
-
familyNameThe family or last name.String
-
genderThe gender.
-
givenName≤ 100 charsThe given or first name.String
-
legalOrganizationFormThe legal form of the organization.
-
mobilePhoneNumber≤ 100 charsThe phone number of a mobile phone.String
-
organizationName≤ 100 charsThe organization's name.String
-
phoneNumber≤ 100 charsThe phone number.String
-
postalStateThe name of the region, typically a state, county, province or prefecture.String
-
postcodeThe postal code, also known as ZIP, postcode, etc.String
-
salesTaxNumber≤ 100 charsThe sales tax number of the organization.String
-
salutation≤ 20 charsThe salutation e.g. Mrs, Mr, Dr.String
-
socialSecurityNumber≤ 100 charsThe social security number.String
-
sortingCode≤ 100 charsThe sorting code identifying the post office where the PO Box is located.String
-
streetThe street or PO Box.String
4.13.13Shopify Subscription Billing Configuration Details
Properties
-
billingDayOfMonth≥ 1≤ 31Define the day of the month on which the recurring orders should be created.Integer
-
billingIntervalAmount≥ 1Integer
-
billingIntervalUnitDefine how frequently recurring orders should be created.
-
billingReferenceDateThis date will be used as basis to calculate the dates of recurring orders.DateTime
-
billingWeekdayDefine the weekday on which the recurring orders should be created.
-
maximalBillingCyclesPositiveDefine the maximum number of orders the subscription will run for.Integer
-
maximalSuspendableCyclesPositiveDefine the maximum number of orders the subscription can be suspended for at a time.Integer
-
minimalBillingCyclesPositiveDefine the minimal number of orders the subscription will run for.Integer
-
terminationBillingCyclesPositiveDefine the number of orders the subscription will keep running for after its termination has been requested.Integer
Fields
-
MINUTESMinutes
-
HOURSHours
-
DAYSDays
-
WEEKSWeeks
-
MONTHSMonths
-
YEARSYears
4.13.15Shopify Subscription Creation Request Details
Properties
-
billingAddress*
-
billingConfiguration
-
currency*String
-
externalId*A client generated nonce which identifies the entity to be created. Subsequent creation requests with the same external ID will not create new entities but return the initially created entity instead.String
-
initialExecutionDateDateTime
-
integration*Long
-
items*Collection of Shopify Subscription Item
-
language*String
-
shippingAddress*
-
shippingMethodNameString
-
spaceViewIdLong
-
storeOrderConfirmationEmailEnabledBoolean
-
subscriber*
-
subscriberSuspensionAllowedBoolean
4.13.16Shopify Subscription Item Details
Properties
-
priceIncludingTaxDecimal
-
productIdLong
-
quantityDecimal
-
recalculatePriceBoolean
-
taxLinesCollection of Shopify Subscription Tax Line
4.13.17Shopify Subscription Product Details
Properties
-
absolutePriceAdjustmentDecimal
-
billingDayOfMonth≥ 1≤ 31Define the day of the month on which the recurring orders should be created.Integer
-
billingIntervalAmount≥ 1Integer
-
billingIntervalUnitDefine how frequently recurring orders should be created.
-
billingWeekdayDefine the weekday on which the recurring orders should be created.
-
fixedPriceDecimal
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
maximalBillingCyclesPositiveDefine the maximum number of orders the subscription will run for.Integer
-
maximalSuspendableCyclesPositiveDefine the maximum number of orders the subscription can be suspended for at a time.Integer
-
minimalBillingCyclesPositiveDefine the minimal number of orders the subscription will run for.Integer
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
pricingOption
-
productIdThe ID of the Shopify product that is enabled to be ordered as subscription.String
-
productNameString
-
productPriceDecimal
-
productSkuString
-
productVariantIdString
-
productVariantNameString
-
relativePriceAdjustmentDecimal
-
shippingRequiredBoolean
-
shopLong
-
stateThe object's current state.
-
stockCheckRequiredBoolean
-
storeOrderConfirmationEmailEnabledDefine whether the order confirmation email of the Shopify shop is sent to the customer for recurring orders.Boolean
-
subscriberSuspensionAllowedDefine whether the customer is allowed to suspend subscriptions.Boolean
-
terminationBillingCyclesPositiveDefine the number of orders the subscription will keep running for after its termination has been requested.Integer
-
updatedAtDateTime
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
CURRENT_PRICECurrent Price
-
ORIGINAL_PRICEOriginal Price
-
FIXED_PRICEFixed Price
-
RELATIVE_ADJUSTMENTRelative Adjustment
-
ABSOLUTE_ADJUSTMENTAbsolute Adjustment
Fields
-
CREATECreate
-
ACTIVEActive
-
INACTIVEInactive
-
OBSOLETEObsolete
-
DELETINGDeleting
-
DELETEDDeleted
Fields
-
INITIATINGInitiating
-
FAILEDFailed
-
ACTIVEActive
-
SUSPENDEDSuspended
-
TERMINATINGTerminating
-
TERMINATEDTerminated
4.13.21Shopify Subscription Suspension Details
Properties
-
createdByLong
-
createdOnDateTime
-
endedByLong
-
endedOnDateTime
-
idA unique identifier for the object.Long
-
initiator
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
plannedEndDateDateTime
-
shopLong
-
stateThe object's current state.
-
subscription
-
type
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.13.25Shopify Subscription Tax Line Details
Properties
-
rateDecimal
-
titleString
4.13.26Shopify Subscription Update Addresses Request Details
Properties
-
billingAddress
-
id*Long
-
shippingAddress
4.13.27Shopify Subscription Update Request Details
Properties
-
billingConfiguration
-
id*Long
-
itemsCollection of Shopify Subscription Item
-
storeOrderConfirmationEmailEnabledBoolean
-
subscriberSuspensionAllowedBoolean
4.13.28Shopify Subscription Version Details
Properties
-
billingAddress
-
billingDayOfMonthInteger
-
billingIntervalAmountInteger
-
billingIntervalUnit
-
billingReferenceDateDateTime
-
billingWeekday
-
createdByLong
-
createdOnDateTime
-
currencyString
-
dischargedByLong
-
dischargedOnDateTime
-
idA unique identifier for the object.Long
-
itemsCollection of Shopify Subscription Version Item
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
maximalBillingCyclesInteger
-
maximalSuspendableCyclesInteger
-
minimalBillingCyclesInteger
-
paymentGatewayString
-
shippingAddress
-
shippingRateString
-
shopLong
-
stateThe object's current state.
-
storeOrderConfirmationEmailEnabledBoolean
-
subscriberSuspensionAllowedBoolean
-
subscription
-
terminationBillingCyclesInteger
-
tokenLong
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.13.29Shopify Subscription Version Item Details
Properties
-
priceIncludingTaxDecimal
-
priceStrategy
-
product
-
quantityDecimal
-
taxLinesCollection of Shopify Tax Line
Fields
-
INITIALLY_CALCULATEDInitially Calculated
-
RECALCULATERecalculate
Fields
-
MONDAYMonday
-
TUESDAYTuesday
-
WEDNESDAYWednesday
-
THURSDAYThursday
-
FRIDAYFriday
-
SATURDAYSaturday
-
SUNDAYSunday
4.13.33Shopify Tax Line Details
Properties
-
fractionRateDecimal
-
idA unique identifier for the object.Long
-
rateDecimal
-
titleString
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.13.34Shopify Transaction Details
Properties
-
checkoutIdString
-
createdOnThe date and time when the object was created.DateTime
-
idA unique identifier for the object.Long
-
integration
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
linkedTransactionVirtualLong
-
orderIdString
-
orderNameString
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
state
-
transaction
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.1Metric Details
A metric represents the usage of a resource that can be measured.
Properties
-
descriptionThe localized description of the metric that is displayed to the customer.Map of String String
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
nameThe localized name of the metric that is displayed to the customer.Map of String String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
typeThe type of the metric.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.2Metric Usage Report Details
The metric usage is the actual usage of a metric for a particular subscription as collected by an external application.
Properties
-
consumedUnitsThe number of resources consumed, will be charged in the next billing cycle.Decimal
-
createdByUserIdThe ID of the user the usage report was created by.Long
-
createdOnThe date and time when the usage report was created.DateTime
-
description≤ 100 charsA description used to identify the usage report.String
-
externalIdA 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
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
metricThe metric that the usage report is recorded for.Long
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
subscriptionThe subscription that the usage report is recorded for.Long
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.3Product Component Details
Properties
-
componentChangeWeightIf switching from a component with a lower tier to a component with a higher one, this is considered an upgrade and a fee may be applied.Integer
-
componentGroupThe group that the component belongs to.
-
defaultComponentWhether this is the default component in its group and preselected.Boolean
-
descriptionThe localized description of the component that is displayed to the customer.Map of String String
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
maximalQuantityA maximum of the defined quantity can be selected for this component.Decimal
-
minimalQuantityA minimum of the defined quantity must be selected for this component.Decimal
-
nameThe localized name of the component that is displayed to the customer.Map of String String
-
quantityStepThe quantity step determines the interval in which the quantity can be increased.Decimal
-
referenceThe reference is used to link components across different product versions.
-
sortOrderWhen listing components, they can be sorted by this number.Integer
-
taxClassThe tax class to be applied to fees.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.4Product Component Group Details
Properties
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
nameThe localized name of the component group that is displayed to the customer.Map of String String
-
optionalWhether the component group is optional, i.e. the customer does not have to select any component.Boolean
-
productVersionThe product version that the component group belongs to.
-
sortOrderWhen listing component groups, they can be sorted by this number.Integer
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.5Product Component Reference Details
The product component reference links components from different product versions, which makes it possible to carry out migrations.
Properties
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 100 charsThe name used to identify the component reference.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.7Product Metered Fee Details
Properties
-
componentThe product component that the fee belongs to.
-
descriptionThe localized description of the fee that is displayed to the customer.Map of String String
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
metricThe metric used to determine the resource consumption billed to the customer.
-
nameThe localized name of the fee that is displayed to the customer.Map of String String
-
tierPricingThe method used to calculate the tier price.
-
typeThe type of the fee.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.8Product Metered Fee Tier Details
Properties
-
feeThe amount charged to the customer for each consumed unit at the end of a billing cycle.Collection of Persistable Currency Amount
-
idA unique identifier for the object.Long
-
meteredFeeThe metered fee that this tier belongs to.
-
startRangeStarting from and including this quantity is contained in the tier.Decimal
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
CHEAPEST_TIER_PRICINGCheapest Tier Pricing
-
INCREMENTAL_DISCOUNT_PRICINGIncremental Discount Pricing
4.14.10Product Period Fee Details
Properties
-
componentThe product component that the fee belongs to.
-
descriptionThe localized description of the fee that is displayed to the customer.Map of String String
-
idA unique identifier for the object.Long
-
ledgerEntryTitleThe localized title that be used on ledger entries and invoices.Map of String String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
nameThe localized name of the fee that is displayed to the customer.Map of String String
-
numberOfFreeTrialPeriodsPositiveThe number of subscription billing cycles that count as a trial phase and during which no fees are charged.Integer
-
periodFeeThe amount charged to the customer for each billing cycle during the term of a subscription.Collection of Persistable Currency Amount
-
typeThe type of the fee.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.11Product Retirement Details
Properties
-
createdOnThe date and time when the object was created.DateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
productThe product that is to be retired.
-
respectTerminationPeriodsWhether the subscriptions' termination periods should be respected.Boolean
-
targetProductThe product to which the subscriptions with the retiring product are to be migrated. If none is defined, the subscriptions are terminated.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.12Product Setup Fee Details
Properties
-
componentThe product component that the fee belongs to.
-
descriptionThe localized description of the fee that is displayed to the customer.Map of String String
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
nameThe localized name of the fee that is displayed to the customer.Map of String String
-
onDowngradeCreditedAmount≥ 1 optionsThe amount charged to the customer when a subscription is downgraded.Collection of Persistable Currency Amount
-
onUpgradeCreditedAmount≥ 1 optionsThe amount charged to the customer when a subscription is upgraded.Collection of Persistable Currency Amount
-
setupFee≥ 1 optionsThe amount charged to the customer once when they subscribe to a subscription.Collection of Persistable Currency Amount
-
typeThe type of the fee.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.13Product Version Details
Properties
-
activatedOnThe date and time when the product version was activated.DateTime
-
billingCycleThe recurring period of time, typically monthly or annually, for which a subscriber is charged.String
-
commentA comment that describes the product version and why it was created. It is not disclosed to the subscriber.String
-
createdOnThe date and time when the product version was created.DateTime
-
defaultCurrencyThe three-letter code (ISO 4217 format) of the product version's default currency.String
-
enabledCurrenciesThe three-letter codes (ISO 4217 format) of the currencies that the product version supports.Collection of String
-
idA unique identifier for the object.Long
-
incrementNumberWhenever a new version of a product is created, the number is increased and assigned.Integer
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
minimalNumberOfPeriodsThe minimum number of periods the subscription will run before it can be terminated.Integer
-
nameThe localized name of the product that is displayed to the customer.Map of String String
-
numberOfNoticePeriodsThe number of periods the subscription will keep running after its termination was requested.Integer
-
obsoletedOnThe date and time when the product version was made obsolete.DateTime
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
productThe product that the version belongs to.
-
reference≤ 125 charsThe reference used to identify the product version.String
-
retiringFinishedOnThe date and time when the product version was retired.DateTime
-
retiringStartedOnThe date and time when the product version's retirement was started.DateTime
-
stateThe object's current state.
-
taxCalculationThe way taxes are calculated for fees.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.14Product Version Retirement Details
Properties
-
createdOnThe date and time when the object was created.DateTime
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
productVersionThe product version that is to be retired.
-
respectTerminationPeriodsWhether the subscriptions' termination periods should be respected.Boolean
-
targetProductThe product to which the subscriptions with the retiring product version are to be migrated. If none is defined, the subscriptions are terminated.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.15Subscriber Details
A subscriber represents everyone who is subscribed to a product.
Properties
-
additionalAllowedPaymentMethodConfigurationsAllow the subscriber to use these payment methods even if subscription products do not accept them.Collection of Long
-
billingAddressThe address associated with the subscriber for invoicing and transaction processing purposes.
-
description≤ 200 charsThe description used to identify the subscriber.String
-
disallowedPaymentMethodConfigurationsPrevent the subscriber from using these payment methods even if subscription products do accept them.Collection of Long
-
emailAddress≤ 254 charsThe email address that is used to communicate with the subscriber. There can be only one subscriber per space with the same email address.String
-
externalIdA 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
-
idA unique identifier for the object.Long
-
languageThe language that is used when communicating with the subscriber via emails and documents.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
metaDataVirtualAllow to store additional information about the object.Map of String String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
reference≤ 100 charsThe merchant's reference used to identify the subscriber.String
-
shippingAddressThe address to where orders will be shipped.
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.16Subscription Details
Properties
-
activatedOnThe date and time when the subscription was activate.DateTime
-
affiliateThe affiliate that led to the creation of the subscription.
-
createdOnThe date and time when the subscription was created.DateTime
-
currentProductVersionThe version of the product that the subscription is currently linked to.
-
description≤ 200 charsA description used to identify the subscription.String
-
idA unique identifier for the object.Long
-
initializedOnThe date and time when the subscription was initialized.DateTime
-
languageThe language that is linked to the object.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
plannedTerminationDateThe date and time when the subscription is planned to be terminated.DateTime
-
reference≤ 100 charsThe merchant's reference used to identify the subscription.String
-
stateThe object's current state.
-
subscriberThe subscriber that the subscription belongs to.
-
terminatedByThe ID of the user the subscription was terminated by.Long
-
terminatedOnThe date and time when the subscription was terminated.DateTime
-
terminatingOnThe date and time when the termination of the subscription started.DateTime
-
terminationScheduledOnThe date and time when the subscription was scheduled to be terminated.DateTime
-
tokenThe payment token that is used to charge the customer.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.17Subscription Affiliate Details
Properties
-
externalIdA 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
-
idA unique identifier for the object.Long
-
languageThe language that is linked to the object.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
metaDataVirtualAllow to store additional information about the object.Map of String String
-
name3 - 255 charsThe name used to identify the affiliate.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
reference3 - 100 charsThe reference used to identify the affiliate.String
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.18Subscription Change Request Details
The subscription change request allows to change a subscription.
Properties
-
componentConfigurationsCollection of Subscription Component Reference Configuration
-
currency*String
-
product*The subscription has to be linked with a product.ID of Subscription Product
-
respectTerminationPeriodThe subscription version may be retired. The respect termination period controls whether the termination period configured on the product version should be respected or if the operation should take effect immediately.Boolean
-
selectedComponents
-
subscription*ID of Subscription
4.14.19Subscription Charge Details
The subscription charge represents a single charge carried out for a particular subscription.
Properties
-
createdOnThe date and time when the charge was created.DateTime
-
discardedByThe ID of the user the charge was discarded by.Long
-
discardedOnThe date and time when the charge was discarded.DateTime
-
externalIdA 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
-
failedOnThe date and time when the charge failed.DateTime
-
failedUrl9 - 500 optionsURLVirtualThe URL to redirect the customer back to after they canceled or failed to authenticated their payment.String
-
idA unique identifier for the object.Long
-
languageThe language that is linked to the object.String
-
ledgerEntriesThe ledger entries that belong to the charge.Collection of Subscription Ledger Entry
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
plannedExecutionDateThe date and time when the execution of the charge is planned.DateTime
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
processingTypeThe processing type specifies how the charge is to be processed.
-
reference≤ 100 charsThe merchant's reference used to identify the charge.String
-
stateThe object's current state.
-
subscriptionThe subscription that the charge belongs to.
-
succeedOnThe date and time when the charge succeeded.DateTime
-
successUrl9 - 500 optionsURLVirtualThe URL to redirect the customer back to after they successfully authenticated their payment.String
-
transactionThe transaction used to process the charge.
-
typeThe type specified how the charge was initiated.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
SCHEDULEDScheduled
-
DISCARDEDDiscarded
-
PROCESSINGProcessing
-
SUCCESSFULSuccessful
-
FAILEDFailed
4.14.23Subscription Component Configuration Details
Properties
-
componentThe component that is being configured.Long
-
idA unique identifier for the object.Long
-
linkedSpaceIdThe ID of the space this object belongs to.Long
-
quantityThe quantity that should be applied to the component.Decimal
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.24Subscription Component Reference Configuration Details
The component reference configuration adjusts the product component for a particular subscription.
Properties
-
productComponentReferenceIdThe ID of the component reference that is being configured.Long
-
quantityThe quantity that should be applied to the component.Decimal
4.14.25Subscription Create Request Details
The subscription create request holds all the data required to create a new subscription.
Properties
-
componentConfigurationsCollection of Subscription Component Reference Configuration
-
currency*String
-
product*The subscription has to be linked with a product.ID of Subscription Product
-
selectedComponents
-
subscription*
4.14.26Subscription Ledger Entry Details
The subscription ledger entry represents a single change on the subscription balance.
Properties
-
aggregatedTaxRateThe total tax rate applied to the ledger entry, calculated from the rates of all tax lines.Decimal
-
amountExcludingTaxThe leger entry's amount with discounts applied, excluding taxes.Decimal
-
amountIncludingTaxThe leger entry's amount with discounts applied, including taxes.Decimal
-
createdByThe ID of the user the ledger entry was created by.Long
-
createdOnThe date and time when the object was created.DateTime
-
discountIncludingTaxThe discount allocated to the ledger entry, including taxes.Decimal
-
externalIdA 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
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
proRataCalculatedBoolean
-
quantityThe number of items that were consumed.Decimal
-
stateThe object's current state.
-
subscriptionVersionThe subscription version that the ledger entry belongs to.Long
-
taxAmountThe sum of all taxes applied to the ledger entry.Decimal
-
taxesA set of tax lines, each of which specifies a tax applied to the ledger entry.Collection of Tax
-
title1 - 150 charsThe title that indicates what the ledger entry is about.String
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.28Subscription Metric Type Details
The subscription metric type identifies the type of the metric.
Properties
-
descriptionThe localized description of the object.Map of String String
-
featureLong
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
4.14.29Subscription Period Bill Details
Properties
-
createdOnThe date and time when the period bill was created.DateTime
-
effectivePeriodEndDateThe date and time when the period actually ended.DateTime
-
idA unique identifier for the object.Long
-
languageThe language that is linked to the object.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
periodStartDateThe date and time when the period started.DateTime
-
plannedPeriodEndDateThe date and time when the period is planned to end.DateTime
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
subscriptionVersionThe subscription version that the period bill belongs to.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.14.31Subscription Product Details
A subscription product represents a product to which a subscriber can subscribe to. A product defines how much the subscription costs and in what cycles the subscribe is charged.
Properties
-
allowedPaymentMethodConfigurationsThe payment methods that can be used to subscribe to this product. If none are selected, no restriction is applied.Collection of Long
-
failedPaymentSuspensionPeriodThe period after which a subscription that has been suspended due to a failed payment is terminated.String
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 100 charsThe name used to identify the product.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
productLockedWhether subscriptions can be switched to or from this product, or whether they are locked in.Boolean
-
reference≤ 100 charsThe merchant's reference used to identify the product, e.g. the SKU.String
-
sortOrderWhen listing products, they can be sorted by this number.Integer
-
spaceIdThe ID of the space this object belongs to.Long
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
CREATECreate
-
ACTIVEActive
-
DELETINGDeleting
-
DELETEDDeleted
Fields
-
CREATECreate
-
ACTIVEActive
-
INACTIVEInactive
-
RETIRINGRetiring
-
RETIREDRetired
Fields
-
PENDINGPending
-
ACTIVEActive
-
OBSOLETEObsolete
-
RETIRINGRetiring
-
RETIREDRetired
Fields
-
PENDINGPending
-
INITIALIZINGInitializing
-
FAILEDFailed
-
ACTIVEActive
-
SUSPENDEDSuspended
-
TERMINATION_SCHEDULEDTermination Scheduled
-
TERMINATINGTerminating
-
TERMINATEDTerminated
Fields
-
FAILED_CHARGEFailed Charge
-
SUBSCRIBER_INITIATED_REFUNDSubscriber Initiated Refund
-
MANUALManual
4.14.39Subscription Update Request Details
Properties
-
description≤ 200 charsA description used to identify the subscription.String
4.14.40Subscription Version Details
Properties
-
activatedOnThe date and time when the subscription version was activated.DateTime
-
billingCurrencyThe three-letter code (ISO 4217 format) of the currency used to invoice the customer. Must be one of the currencies supported by the product.String
-
componentConfigurationsThe configurations of the subscription's components.Collection of Subscription Component Configuration
-
createdOnThe date and time when the subscription version was created.DateTime
-
expectedLastPeriodEndThe date and time when the last period is expected to end.DateTime
-
failedOnThe date and time when the subscription version failed.DateTime
-
idA unique identifier for the object.Long
-
languageThe language that is linked to the object.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
plannedTerminationDateThe date and time when the termination of the subscription version is planned.DateTime
-
productVersionThe product version that is subscribed to.
-
stateThe object's current state.
-
subscriptionThe subscription that this version belongs to.
-
terminatedOnThe date and time when the subscription version was terminated.DateTime
-
terminatingOnThe date and time when the termination of the subscription version started.DateTime
-
terminationIssuedOnThe date and time when the termination of the subscription version was issued.DateTime
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
Fields
-
PENDINGPending
-
INITIALIZINGInitializing
-
FAILEDFailed
-
ACTIVEActive
-
TERMINATINGTerminating
-
TERMINATEDTerminated
4.14.42Suspension Details
Properties
-
createdOnThe date and time when the object was created.DateTime
-
effectiveEndDateThe date and time when the suspension ended.DateTime
-
endActionWhether the subscription should be terminated or reactivated after the suspension has reached its end date.
-
idA unique identifier for the object.Long
-
languageThe language that is linked to the object.String
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
note≤ 300 charsA note that contains details about the suspension. It is not disclosed to the subscriber.String
-
periodBillThe period bill that led to the suspension of the subscription.
-
plannedEndDateThe date and time when the suspension is planned to end.DateTime
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
reasonThe reason why the subscription was suspended.
-
stateThe object's current state.
-
subscriptionThe subscription that this suspension belongs to.Long
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.15.1Tax Details
4.15.2Tax Class Details
Properties
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 100 charsThe name used to identify the tax class.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.16.1Application User Details
Properties
-
idA unique identifier for the object.Long
-
name≤ 256 charsThe name used to identify the application user.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
primaryAccountThe primary account that the user belongs to.Long
-
requestLimitThe maximum number of API requests that are accepted every 2 minutes.Long
-
scopeThe scope that the user belongs to.Long
-
stateThe object's current state.
-
userTypeVirtualThe user's type which defines its role and capabilities.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.16.2Human User Details
Properties
-
emailAddressEmail≤ 128 charsThe user's email address.String
-
emailAddressVerifiedWhether the user's email address has been verified.Boolean
-
firstname≤ 100 charsThe user's first name.String
-
idA unique identifier for the object.Long
-
languageThe user's preferred language.String
-
lastname≤ 100 charsThe user's last name.String
-
mobilePhoneNumber≤ 30 charsThe user's mobile phone number.String
-
mobilePhoneVerifiedWhether the user's mobile phone number has been verified.Boolean
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
primaryAccountThe primary account that the user belongs to.Long
-
scopeThe scope that the user belongs to.Long
-
stateThe object's current state.
-
timeZoneThe user's time zone. If none is specified, the one provided by the browser will be used.String
-
twoFactorEnabledWhether two-factor authentication is enabled for this user.Boolean
-
twoFactorTypeThe type of two-factor authentication that is enabled for the user.
-
userTypeVirtualThe user's type which defines its role and capabilities.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.16.3Permission Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
featureThe feature that this permission belongs to.Long
-
groupWhether this is a permission group.Boolean
-
idA unique identifier for the object.Long
-
leafWhether this is a leaf in the tree of permissions, and not a group.Boolean
-
nameThe localized name of the object.Map of String String
-
parentThe group that this permission belongs to.Long
-
pathToRootAll parents of this permission up to the root of the permission tree.Collection of Long
-
titleThe localized name of the object.Map of String String
-
twoFactorRequiredWhether users with this permission are required to enable two-factor authentication.Boolean
-
webAppEnabledBoolean
4.16.4Role Details
Properties
-
accountThe account the role belongs to. The role can only be assigned within this account.
-
idA unique identifier for the object.Long
-
nameThe name used to identify the role.Map of String String
-
permissionsThe permissions granted to users with this role.Collection of Permission
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
twoFactorRequiredWhether users with this role are required to use two-factor authentication.Boolean
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.16.6Two Factor Authentication Type Details
Properties
-
descriptionThe localized description of the object.Map of String String
-
featureThe feature that this type belongs to.Long
-
iconThe identifier of the icon representing this type.String
-
idA unique identifier for the object.Long
-
nameThe localized name of the object.Map of String String
4.16.7User Details
Properties
-
idA unique identifier for the object.Long
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
scopeThe scope that the user belongs to.Long
-
stateThe object's current state.
-
userTypeVirtualThe user's type which defines its role and capabilities.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.16.8User Account Role Details
Properties
-
accountThe account in which the role is assigned to the user.Long
-
appliesOnSubAccountWhether the role is assigned to the user in subaccounts only.Boolean
-
idA unique identifier for the object.Long
-
roleThe role that is assigned to the user.Long
-
userThe user whose role this defines.Long
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.16.9User Space Role Details
Properties
-
idA unique identifier for the object.Long
-
roleThe role that is assigned to the user.Long
-
spaceThe space in which the role is assigned to the user.Long
-
userThe user whose role this defines.Long
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.17.1Web App Confirmation Response Details
The confirmation response provides details about the installation of the web app.
Properties
-
access_tokenThe access code granting permissions to the web service API according to the OAuth standard.String
-
scopeThe list of the permissions granted to the web app within the space.String
-
spaceThe space that the web app was installed in.
-
stateThe state parameter that was provided in the authorization request.String
-
token_typeThe type of the access token that determines the authentication mechanism to use for accessing the web service API.String
4.18.1Webhook Encryption Public Key Details
The webhook encryption public key is used to verify the webhook content signature.
Properties
-
idThe ID of encryption keyString
-
publicKeyThe BASE64 encoded public keyString
4.18.2Webhook Identity Details
The webhook identity represents a set of keys that will be used to sign the webhook messages.
Properties
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 50 charsThe name used to identify the webhook identity.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.18.3Webhook Listener Details
Properties
-
enablePayloadSignatureAndStateWhether signature header and 'state' property are enabled in webhook payload.Boolean
-
entityThe entity that is to be monitored.
-
entityStatesThe entity's target states that are to be monitored.Collection of String
-
idA unique identifier for the object.Long
-
identityThe identity used to sign messages.
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 50 charsThe name used to identify the webhook listener.String
-
notifyEveryChangeWhether every update of the entity or only state changes are to be monitored.Boolean
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
urlThe URL where notifications about entity changes are sent to.
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer
4.18.4Webhook Listener Entity Details
Properties
-
idA unique identifier for the object.Long
-
nameThe name used to identify the webhook listener entity.Map of String String
-
technicalNameThe name used to programmatically identify the webhook listener entity.String
4.18.5Webhook URL Details
Properties
-
applicationManagedWhether the webhook URL is managed by the application, and therefore cannot be changed via the user interface.Boolean
-
idA unique identifier for the object.Long
-
linkedSpaceIdVirtualThe ID of the space this object belongs to.Long
-
name≤ 50 charsThe name used to identify the webhook URL.String
-
plannedPurgeDateThe date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.DateTime
-
stateThe object's current state.
-
url9 - 500 optionsURLThe actual URL where notifications about entity changes are sent to.String
-
versionThe version is used for optimistic locking and incremented whenever the object is updated.Integer