Documentation
accountsubscriber accountsubscriber
  • accountId
    bigint
     
  • id
    bigint
    A unique identifier for the object.
  • state
    string
    The object's current state.
  • bigint
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
accountsubscription accountsubscription
  • bigint
     
  • id
    bigint
    A unique identifier for the object.
  • state
    string
    The object's current state.
  • bigint
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
boardingtrialsubscription boardingtrialsubscription
  • accountId
    bigint
     
  • couponCodes
    array
     
  • createdOn
    timestamp
    The date and time when the object was created.
  • currency
    string
     
  • expireDate
    timestamp
     
  • id
    bigint
    A unique identifier for the object.
  • lastNotifiedOn
    timestamp
     
  • bigint
     
  • selectedComponents
    array
     
  • state
    string
    The object's current state.
  • bigint
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
subscriptionproductcomponentquantity subscriptionproductcomponentquantity
  • id
    bigint
    A unique identifier for the object.
  • quantity
    bigint
     
  • bigint
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
account account
  • active
    boolean
    Whether this account and all its parent accounts are active.
  • activeOrRestrictedActive
    boolean
    Whether this account and all its parent accounts are active or restricted active.
  • createdBy
    bigint
    The ID of the user the account was created by.
  • createdOn
    timestamp
    The date and time when the account was created.
  • deletedBy
    bigint
    The ID of a user the account was deleted by.
  • deletedOn
    timestamp
    The date and time when the account was deleted.
  • id
    bigint
    A unique identifier for the object.
  • lastModifiedDate
    timestamp
    The date and time when the object was last modified.
  • name
    string
    The name used to identify the account.
  • bigint
    The parent account responsible for administering this account.
  • restrictedActive
    boolean
    Whether this account and all its parent accounts are active or restricted active. There is at least one account that is restricted active.
  • scope
    bigint
    The scope that the account belongs to.
  • state
    string
    The object's current state.
  • subaccountLimit
    bigint
    The number of sub-accounts that can be created within this account.
  • type
    string
    The account's type which defines its role and capabilities.
failurereason failurereason
  • category
    string
     
  • description
    map
    The localized description of the object.
  • id
    bigint
    A unique identifier for the object.
  • name
    map
    The localized name of the object.
labeldescriptor labeldescriptor
  • category
    string
    The label's category.
  • description
    map
    The localized description of the object.
  • bigint
    The group that this label belongs to.
  • id
    bigint
    A unique identifier for the object.
  • name
    map
    The localized name of the object.
  • weight
    int
    When listing labels, they can be sorted by this number.
labeldescriptorgroup labeldescriptorgroup
  • description
    map
    The localized description of the object.
  • id
    bigint
    A unique identifier for the object.
  • name
    map
    The localized name of the object.
  • weight
    int
    When listing label groups, they can be sorted by this number.
space space
  • bigint
    The account that the space belongs to.
  • active
    boolean
    Whether this space and all its parent accounts are active.
  • activeOrRestrictedActive
    boolean
    Whether this space and all its parent accounts are active or restricted active.
  • createdBy
    bigint
    The ID of the user the space was created by.
  • createdOn
    timestamp
    The date and time when the space was created.
  • deletedBy
    bigint
    The ID of the user the space was deleted by.
  • deletedOn
    timestamp
    The date and time when the space was deleted.
  • id
    bigint
    A unique identifier for the object.
  • lastModifiedDate
    timestamp
    The date and time when the object was last modified.
  • name
    string
    The name used to identify the space.
  • postalAddress
    struct
    The address that is used in communication with clients for example in emails, documents, etc.
  • postalAddress.city
    string
     
  • postalAddress.country
    string
     
  • postalAddress.dependentLocality
    string
     
  • postalAddress.emailAddress
    string
     
  • postalAddress.familyName
    string
     
  • postalAddress.givenName
    string
     
  • postalAddress.mobilePhoneNumber
    string
     
  • postalAddress.organizationName
    string
     
  • postalAddress.phoneNumber
    string
     
  • postalAddress.postalState
    string
     
  • postalAddress.postcode
    string
     
  • postalAddress.salesTaxNumber
    string
     
  • postalAddress.salutation
    string
     
  • postalAddress.sortingCode
    string
     
  • postalAddress.street
    string
     
  • primaryCurrency
    string
    The currency that is used to display aggregated amounts in the space.
  • requestLimit
    bigint
    The maximum number of API requests that are accepted within two minutes. This limit can only be changed with special privileges.
  • restrictedActive
    boolean
    Whether this space and all its parent accounts are active or restricted active. There is least one parent account that is restricted active.
  • state
    string
    The object's current state.
  • technicalContactAddresses
    array
    The email address that will receive messages about technical issues and errors that occur in the space.
  • timeZone
    string
    The time zone that is used to schedule and run background processes. This does not affect the formatting of dates in the user interface.
spacereference spacereference
  • createdOn
    timestamp
     
  • id
    bigint
    A unique identifier for the object.
  • spaceId
    bigint
     
  • state
    string
    The object's current state.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
legalorganizationform legalorganizationform
  • country
    string
    The two-letter code of the country the legal organization form is used in (ISO 3166-1 alpha-2 format).
  • description
    array
    The localized descriptions of the legal organization form.
  • englishDescription
    string
    The English name of the legal organization form.
  • id
    bigint
    A unique identifier for the object.
  • shortcut
    array
    The localized shortcuts of the legal organization form.
customer customer
  • createdOn
    timestamp
    The date and time when the object was created.
  • customerId
    string
    The customer's ID in the merchant's system.
  • emailAddress
    string
    The customer's email address.
  • familyName
    string
    The customer's family or last name.
  • givenName
    string
    The customer's given or first name.
  • id
    bigint
    A unique identifier for the object.
  • language
    string
    The language that is linked to the object.
  • metaData
    map
    Allow to store additional information about the object.
  • preferredCurrency
    string
    The customer's preferred currency.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
customeraddress customeraddress
  • address
    struct
    The actual postal address.
  • address.city
    string
     
  • address.commercialRegisterNumber
    string
     
  • address.country
    string
     
  • address.dateOfBirth
    date
     
  • address.dependentLocality
    string
     
  • address.emailAddress
    string
     
  • address.familyName
    string
     
  • address.gender
    string
     
  • address.givenName
    string
     
  • bigint
     
  • address.mobilePhoneNumber
    string
     
  • address.organizationName
    string
     
  • address.phoneNumber
    string
     
  • address.postalState
    string
     
  • address.postcode
    string
     
  • address.salesTaxNumber
    string
     
  • address.salutation
    string
     
  • address.socialSecurityNumber
    string
     
  • address.sortingCode
    string
     
  • address.street
    string
     
  • addressType
    string
    Whether the address is for billing or shipping or both.
  • createdOn
    timestamp
    The date and time when the object was created.
  • bigint
    The customer that the object belongs to.
  • defaultAddress
    boolean
    Whether this is the customer's default address.
  • id
    bigint
    A unique identifier for the object.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
taxclass taxclass
  • id
    bigint
    A unique identifier for the object.
  • name
    string
    The tax class name is used internally to identify the tax class in administrative interfaces. For example it is used within search fields and hence it should be distinct and descriptive.
  • spaceId
    bigint
     
  • state
    string
    The object's current state.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
charge charge
  • createdOn
    timestamp
    The date on which the charge was created on.
  • bigint
     
  • id
    bigint
    A unique identifier for the object.
  • language
    string
    The language that is linked to the object.
  • spaceViewId
    bigint
     
  • state
    string
    The object's current state.
  • timeZone
    string
     
  • timeoutOn
    timestamp
     
  • bigint
     
  • type
    string
     
  • userFailureMessage
    string
    The failure message describes for an end user why the charge is failed in the language of the user. This is only provided when the charge is marked as failed.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
chargeattempt chargeattempt
  • bigint
     
  • completionBehavior
    string
     
  • bigint
     
  • createdOn
    timestamp
    The date and time when the object was created.
  • customersPresence
    string
    The customers presence indicates which kind of customer interaction was used during the charge attempt.
  • environment
    string
     
  • failedOn
    timestamp
     
  • bigint
     
  • id
    bigint
    A unique identifier for the object.
  • initializingTokenVersion
    boolean
     
  • bigint
     
  • language
    string
    The language that is linked to the object.
  • bigint
     
  • nextUpdateOn
    timestamp
     
  • redirectionUrl
    string
     
  • bigint
     
  • spaceViewId
    bigint
     
  • state
    string
    The object's current state.
  • succeededOn
    timestamp
     
  • bigint
     
  • timeZone
    string
     
  • timeoutOn
    timestamp
     
  • userFailureMessage
    string
    The user failure message contains the message for the user in case the attempt failed. The message is localized into the language specified on the transaction.
  • bigint
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
saleschannel saleschannel
  • description
    map
    The localized description of the object.
  • id
    bigint
    A unique identifier for the object.
  • name
    map
    The localized name of the object.
  • bigint
     
  • sortOrder
    int
     
connectorinvocation connectorinvocation
  • createdOn
    timestamp
    The date and time when the object was created.
  • id
    bigint
    A unique identifier for the object.
  • stage
    string
     
  • timeTookInMilliseconds
    bigint
     
  • bigint
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
paymentconnector paymentconnector
  • dataCollectionType
    string
     
  • deprecated
    boolean
     
  • deprecationReason
    map
     
  • description
    map
    The localized description of the object.
  • id
    bigint
    A unique identifier for the object.
  • name
    map
    The localized name of the object.
  • bigint
     
  • bigint
     
  • primaryRiskTaker
    string
     
  • bigint
     
  • supportedCurrencies
    array
     
paymentconnectorconfiguration paymentconnectorconfiguration
  • applicableForTransactionProcessing
    boolean
    This property indicates if the connector is currently used for processing transactions. In case either the payment method configuration or the processor configuration is not active the connector will not be used even though the connector state is active.
  • bigint
     
  • enabledSalesChannels
    array
    Defines the sales channels the connector configuration is enabled for. In case the set is empty, the connector configuration is enabled for all sales channels.
  • enabledSpaceViews
    array
    The connector configuration is only enabled for the selected space views. In case the set is empty the connector configuration is enabled for all space views.
  • id
    bigint
    A unique identifier for the object.
  • imagePath
    string
     
  • name
    string
    The connector configuration name is used internally to identify the configuration in administrative interfaces. For example it is used within search fields and hence it should be distinct and descriptive.
  • bigint
     
  • priority
    int
    The priority will define the order of choice of the connector configurations. The lower the value, the higher the priority is going to be. This value can also be a negative number in case you are adding a new configuration that you want to have a high priority and you dont want to change the priority of all the other configurations.
  • bigint
     
  • state
    string
    The object's current state.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
paymentcontract paymentcontract
  • bigint
     
  • activatedOn
    timestamp
     
  • contractIdentifier
    string
     
  • createdOn
    timestamp
    The date and time when the object was created.
  • externalId
    string
    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.
  • id
    bigint
    A unique identifier for the object.
  • lastModifiedDate
    timestamp
    The date and time when the object was last modified.
  • rejectedOn
    timestamp
     
  • bigint
     
  • startTerminatingOn
    timestamp
     
  • state
    string
    The object's current state.
  • terminatedOn
    timestamp
     
paymentmethod paymentmethod
  • dataCollectionTypes
    array
     
  • description
    map
    The localized description of the object.
  • id
    bigint
    A unique identifier for the object.
  • merchantDescription
    map
     
  • name
    map
    The localized name of the object.
  • supportedCurrencies
    array
     
paymentmethodbrand paymentmethodbrand
  • description
    map
    The localized description of the object.
  • id
    bigint
    A unique identifier for the object.
  • name
    map
    The localized name of the object.
  • bigint
     
paymentmethodconfiguration paymentmethodconfiguration

The payment method configuration builds the base to connect with different payment method connectors.

The payment method configuration builds the base to connect with different payment method connectors.
  • dataCollectionType
    string
    The data collection type determines who is collecting the payment information. This can be done either by the processor (offsite) or by our application (onsite).
  • id
    bigint
    A unique identifier for the object.
  • name
    string
    The payment method configuration name is used internally to identify the payment method configuration. For example the name is used within search fields and hence it should be distinct and descriptive.
  • oneClickPaymentMode
    string
    When the buyer is present on the payment page or within the iFrame the payment details can be stored automatically. The buyer will be able to use the stored payment details for subsequent transactions. When the transaction already contains a token one-click payments are disabled anyway
  • bigint
     
  • resolvedDescription
    map
    The resolved description uses the specified description or the default one when it is not overridden.
  • resolvedTitle
    map
    The resolved title uses the specified title or the default one when it is not overridden.
  • sortOrder
    int
    The sort order of the payment method determines the ordering of the methods shown to the user during the payment process.
  • state
    string
    The object's current state.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
paymentprocessor paymentprocessor
  • companyName
    map
     
  • description
    map
    The localized description of the object.
  • headquartersLocation
    map
     
  • id
    bigint
    A unique identifier for the object.
  • name
    map
    The localized name of the object.
  • productName
    map
     
paymentprocessorconfiguration paymentprocessorconfiguration
  • applicationManaged
    boolean
    The configuration is managed by the application and cannot be changed via the user interface.
  • contractId
    bigint
    The contract links the processor configuration with the contract that is used to process payments.
  • id
    bigint
    A unique identifier for the object.
  • name
    string
    The processor configuration name is used internally to identify a specific processor configuration. For example the name is used within search fields and hence it should be distinct and descriptive.
  • bigint
    A processor handles the connection to a third part company (a Payment Service Provider) that technically manages the transaction and therefore processes the payment. For the same processor multiple processor configuration can be setup.
  • state
    string
    The object's current state.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
refund refund

The refund represents a credit back to the customer. It can be issued by the merchant or by the customer (reversal).

The refund represents a credit back to the customer. It can be issued by the merchant or by the customer (reversal).
  • amount
    decimal
     
  • baseLineItems
    array
     
  • bigint
     
  • createdBy
    bigint
     
  • createdOn
    timestamp
    The date and time when the object was created.
  • environment
    string
     
  • externalId
    string
    The external id helps to identify duplicate calls to the refund service. As such the external ID has to be unique per transaction.
  • failedOn
    timestamp
     
  • bigint
     
  • id
    bigint
    A unique identifier for the object.
  • labels
    array
     
  • language
    string
    The language that is linked to the object.
  • lineItems
    array
     
  • merchantReference
    string
     
  • nextUpdateOn
    timestamp
     
  • processingOn
    timestamp
     
  • processorReference
    string
     
  • reducedLineItems
    array
     
  • reductions
    array
     
  • state
    string
    The object's current state.
  • succeededOn
    timestamp
     
  • taxes
    array
     
  • timeZone
    string
     
  • timeoutOn
    timestamp
     
  • totalAppliedFees
    decimal
    The total applied fees is the sum of all fees that have been applied so far.
  • totalSettledAmount
    decimal
    The total settled amount is the total amount which has been settled so far.
  • bigint
     
  • type
    string
     
  • bigint
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
paymentterminal paymentterminal
  • defaultCurrency
    string
     
  • id
    bigint
    A unique identifier for the object.
  • identifier
    string
    The identifier uniquely identifies the terminal. Normally it is visible on the device or in the display of the device.
  • name
    string
    The terminal name is used internally to identify the terminal in administrative interfaces. For example it is used within search fields and hence it should be distinct and descriptive.
  • state
    string
    The object's current state.
  • bigint
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
paymentterminaltype paymentterminaltype
  • description
    map
    The localized description of the object.
  • id
    bigint
    A unique identifier for the object.
  • name
    map
    The localized name of the object.
token token
  • createdOn
    timestamp
    The date and time when the object was created.
  • customerEmailAddress
    string
    The customer email address is the email address of the customer.
  • customerId
    string
    The customer ID identifies the customer in the merchant system. In case the customer ID has been provided it has to correspond with the customer ID provided on the transaction. The customer ID will not be changed automatically. The merchant system has to provide it.
  • enabledForOneClickPayment
    boolean
    When a token is enabled for one-click payments the buyer will be able to select the token within the iFrame or on the payment page to pay with the token. The usage of the token will reduce the number of steps the buyer has to go through. The buyer is linked via the customer ID on the transaction with the token. Means the token will be visible for buyers with the same customer ID. Additionally the payment method has to be configured to allow the one-click payments.
  • externalId
    string
    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.
  • id
    bigint
    A unique identifier for the object.
  • language
    string
    The language that is linked to the object.
  • state
    string
    The object's current state.
  • timeZone
    string
    The time zone defines in which time zone the customer is located in. The time zone may affects how dates are formatted when interacting with the customer.
  • tokenReference
    string
    Use something that it is easy to identify and may help you find the token (e.g. customer id, email address).
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
transaction transaction
  • acceptHeader
    string
     
  • acceptLanguageHeader
    string
    The accept language contains the header which indicates the language preferences of the buyer.
  • allowedPaymentMethodBrands
    array
     
  • allowedPaymentMethodConfigurations
    array
     
  • authorizationAmount
    decimal
     
  • authorizationEnvironment
    string
    The environment in which this transaction was successfully authorized.
  • bigint
    The sales channel through which the transaction was placed.
  • authorizationTimeoutOn
    timestamp
    This is the time on which the transaction will be timed out when it is not at least authorized. The timeout time may change over time.
  • authorizedOn
    timestamp
     
  • autoConfirmationEnabled
    boolean
    When auto confirmation is enabled the transaction can be confirmed by the user and does not require an explicit confirmation through the web service API.
  • billingAddress
    struct
     
  • billingAddress.city
    string
     
  • billingAddress.commercialRegisterNumber
    string
     
  • billingAddress.country
    string
     
  • billingAddress.dateOfBirth
    date
     
  • billingAddress.dependentLocality
    string
     
  • billingAddress.emailAddress
    string
     
  • billingAddress.familyName
    string
     
  • billingAddress.gender
    string
     
  • billingAddress.givenName
    string
     
  • bigint
     
  • billingAddress.mobilePhoneNumber
    string
     
  • billingAddress.organizationName
    string
     
  • billingAddress.phoneNumber
    string
     
  • billingAddress.postalState
    string
     
  • billingAddress.postcode
    string
     
  • billingAddress.salesTaxNumber
    string
     
  • billingAddress.salutation
    string
     
  • billingAddress.socialSecurityNumber
    string
     
  • billingAddress.sortingCode
    string
     
  • billingAddress.street
    string
     
  • chargeRetryEnabled
    boolean
    When the charging of the customer fails we can retry the charging. This implies that we redirect the user back to the payment page which allows the customer to retry. By default we will retry.
  • completedAmount
    decimal
    The completed amount is the total amount which has been captured so far.
  • completedOn
    timestamp
     
  • completionBehavior
    string
    The completion behavior controls when the transaction is completed.
  • completionTimeoutOn
    timestamp
     
  • confirmedBy
    bigint
     
  • confirmedOn
    timestamp
     
  • createdBy
    bigint
     
  • createdOn
    timestamp
    The date and time when the object was created.
  • currency
    string
     
  • customerEmailAddress
    string
    The customer email address is the email address of the customer. If no email address is provided on the shipping or billing address this address is used.
  • customerId
    string
     
  • customersPresence
    string
    The customer's presence indicates what kind of authentication method was finally used during authorization of the transaction. If no value is provided, 'Virtually Present' is used by default.
  • deliveryDecisionMadeOn
    timestamp
    This date indicates when the decision has been made if a transaction should be delivered or not.
  • deviceSessionIdentifier
    string
    The device session identifier links the transaction with the session identifier provided in the URL of the device data JavaScript. This allows to link the transaction with the collected device data of the buyer.
  • emailsDisabled
    boolean
    Flag indicating whether email sending is disabled for this particular transaction. Defaults to false.
  • environment
    string
     
  • environmentSelectionStrategy
    string
    The environment selection strategy determines how the environment (test or production) for processing the transaction is selected.
  • failedOn
    timestamp
     
  • failedUrl
    string
    The user will be redirected to failed URL when the transaction could not be authorized or completed. In case no failed URL is specified a default failed page will be displayed.
  • bigint
    The failure reason describes why the transaction failed. This is only provided when the transaction is marked as failed.
  • id
    bigint
    A unique identifier for the object.
  • internetProtocolAddress
    string
    The Internet Protocol (IP) address identifies the device of the buyer.
  • internetProtocolAddressCountry
    string
     
  • invoiceMerchantReference
    string
     
  • javaEnabled
    boolean
     
  • language
    string
    The language that is linked to the object.
  • lineItems
    array
     
  • merchantReference
    string
     
  • metaData
    map
    Allow to store additional information about the object.
  • bigint
     
  • bigint
     
  • processingOn
    timestamp
     
  • refundedAmount
    decimal
    The refunded amount is the total amount which has been refunded so far.
  • screenColorDepth
    string
     
  • screenHeight
    string
     
  • screenWidth
    string
     
  • shippingAddress
    struct
     
  • shippingAddress.city
    string
     
  • shippingAddress.commercialRegisterNumber
    string
     
  • shippingAddress.country
    string
     
  • shippingAddress.dateOfBirth
    date
     
  • shippingAddress.dependentLocality
    string
     
  • shippingAddress.emailAddress
    string
     
  • shippingAddress.familyName
    string
     
  • shippingAddress.gender
    string
     
  • shippingAddress.givenName
    string
     
  • bigint
     
  • shippingAddress.mobilePhoneNumber
    string
     
  • shippingAddress.organizationName
    string
     
  • shippingAddress.phoneNumber
    string
     
  • shippingAddress.postalState
    string
     
  • shippingAddress.postcode
    string
     
  • shippingAddress.salesTaxNumber
    string
     
  • shippingAddress.salutation
    string
     
  • shippingAddress.socialSecurityNumber
    string
     
  • shippingAddress.sortingCode
    string
     
  • shippingAddress.street
    string
     
  • shippingMethod
    string
     
  • spaceViewId
    bigint
     
  • state
    string
    The object's current state.
  • successUrl
    string
    The user will be redirected to success URL when the transaction could be authorized or completed. In case no success URL is specified a default success page will be displayed.
  • bigint
    The terminal on which the payment was processed.
  • timeZone
    string
    The time zone defines in which time zone the customer is located in. The time zone may affects how dates are formatted when interacting with the customer.
  • bigint
     
  • tokenizationMode
    string
    The tokenization mode controls if and how the tokenization of payment information is applied to the transaction.
  • totalAppliedFees
    decimal
    The total applied fees is the sum of all fees that have been applied so far.
  • totalSettledAmount
    decimal
    The total settled amount is the total amount which has been settled so far.
  • userAgentHeader
    string
    The user agent header provides the exact string which contains the user agent of the buyer.
  • userFailureMessage
    string
    The failure message describes for an end user why the transaction is failed in the language of the user. This is only provided when the transaction is marked as failed.
  • userInterfaceType
    string
    The user interface type defines through which user interface the transaction has been processed resp. created.
  • windowHeight
    string
     
  • windowWidth
    string
     
  • yearsToKeep
    int
    The number of years the transaction will be stored after it has been authorized.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
transactioncompletion transactioncompletion
  • amount
    decimal
    The amount which is captured. The amount represents sum of line items including taxes.
  • baseLineItems
    array
    The base line items on which the completion is applied on.
  • createdBy
    bigint
     
  • createdOn
    timestamp
    The date and time when the object was created.
  • externalId
    string
    The external ID helps to identify the entity and a subsequent creation of an entity with the same ID will not create a new entity.
  • failedOn
    timestamp
     
  • id
    bigint
    A unique identifier for the object.
  • invoiceMerchantReference
    string
     
  • labels
    array
     
  • language
    string
    The language that is linked to the object.
  • lastCompletion
    boolean
    Indicates if this is the last completion. After the last completion is created the transaction cannot be completed anymore.
  • lineItems
    array
    The line items which are captured.
  • bigint
     
  • mode
    string
     
  • nextUpdateOn
    timestamp
     
  • paymentInformation
    string
     
  • processingOn
    timestamp
     
  • processorReference
    string
     
  • remainingLineItems
    array
     
  • spaceViewId
    bigint
     
  • state
    string
    The object's current state.
  • statementDescriptor
    string
    The statement descriptor explain charges or payments on bank statements.
  • succeededOn
    timestamp
     
  • taxAmount
    decimal
    The total sum of all taxes of line items.
  • timeZone
    string
     
  • timeoutOn
    timestamp
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
transactioninvoice transactioninvoice

The transaction invoice represents the invoice document for a particular transaction.

The transaction invoice represents the invoice document for a particular transaction.
  • amount
    decimal
     
  • billingAddress
    struct
     
  • billingAddress.city
    string
     
  • billingAddress.commercialRegisterNumber
    string
     
  • billingAddress.country
    string
     
  • billingAddress.dateOfBirth
    date
     
  • billingAddress.dependentLocality
    string
     
  • billingAddress.emailAddress
    string
     
  • billingAddress.familyName
    string
     
  • billingAddress.gender
    string
     
  • billingAddress.givenName
    string
     
  • bigint
     
  • billingAddress.mobilePhoneNumber
    string
     
  • billingAddress.organizationName
    string
     
  • billingAddress.phoneNumber
    string
     
  • billingAddress.postalState
    string
     
  • billingAddress.postcode
    string
     
  • billingAddress.salesTaxNumber
    string
     
  • billingAddress.salutation
    string
     
  • billingAddress.socialSecurityNumber
    string
     
  • billingAddress.sortingCode
    string
     
  • billingAddress.street
    string
     
  • bigint
     
  • createdOn
    timestamp
    The date on which the invoice is created on.
  • derecognizedBy
    bigint
    The id of the user which marked the invoice as derecognized.
  • derecognizedOn
    timestamp
    The date on which the invoice is marked as derecognized.
  • dueOn
    timestamp
    The date on which the invoice should be paid on.
  • environment
    string
     
  • externalId
    string
    The external id helps to identify the entity and a subsequent creation of an entity with the same ID will not create a new entity.
  • id
    bigint
    A unique identifier for the object.
  • language
    string
    The language that is linked to the object.
  • lineItems
    array
     
  • bigint
     
  • merchantReference
    string
     
  • outstandingAmount
    decimal
    The outstanding amount indicates how much the buyer owes the merchant. A negative amount indicates that the invoice is overpaid.
  • paidOn
    timestamp
    The date on which the invoice is marked as paid. Eventually this date lags behind of the actual paid date.
  • spaceViewId
    bigint
     
  • state
    string
    The object's current state.
  • taxAmount
    decimal
     
  • timeZone
    string
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
wallettype wallettype
  • description
    map
    The localized description of the object.
  • id
    bigint
    A unique identifier for the object.
  • name
    map
    The localized name of the object.
subscriptionaffiliate subscriptionaffiliate
  • externalId
    string
    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.
  • id
    bigint
    A unique identifier for the object.
  • language
    string
    The language that is linked to the object.
  • metaData
    map
    Allow to store additional information about the object.
  • name
    string
     
  • reference
    string
     
  • state
    string
    The object's current state.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
subscription subscription
  • activatedOn
    timestamp
     
  • bigint
     
  • createdOn
    timestamp
     
  • bigint
     
  • description
    string
     
  • id
    bigint
    A unique identifier for the object.
  • initializedOn
    timestamp
     
  • language
    string
    The language that is linked to the object.
  • plannedTerminationDate
    timestamp
     
  • reference
    string
     
  • state
    string
    The object's current state.
  • bigint
     
  • terminatedBy
    bigint
     
  • terminatedOn
    timestamp
     
  • terminatingOn
    timestamp
     
  • terminationScheduledOn
    timestamp
     
  • bigint
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
subscriptioncomponentconfiguration subscriptioncomponentconfiguration
  • bigint
     
  • id
    bigint
    A unique identifier for the object.
  • quantity
    decimal
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
subscriptionperiodbill subscriptionperiodbill
  • createdOn
    timestamp
     
  • effectivePeriodEndDate
    timestamp
     
  • id
    bigint
    A unique identifier for the object.
  • language
    string
    The language that is linked to the object.
  • periodStartDate
    timestamp
     
  • plannedPeriodEndDate
    timestamp
     
  • state
    string
    The object's current state.
  • bigint
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
subscriptionperiodbillitem subscriptionperiodbillitem
  • bigint
     
  • fee
    bigint
     
  • id
    bigint
    A unique identifier for the object.
  • bigint
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
subscriptionversion subscriptionversion
  • activatedOn
    timestamp
     
  • billingCurrency
    string
    The subscriber is charged in the billing currency. The billing currency has to be one of the enabled currencies on the subscription product.
  • createdOn
    timestamp
     
  • expectedLastPeriodEnd
    timestamp
    The expected last period end is the date on which the projected end date of the last period is. This is only a projection and as such the actual date may be different.
  • failedOn
    timestamp
     
  • id
    bigint
    A unique identifier for the object.
  • language
    string
    The language that is linked to the object.
  • plannedTerminationDate
    timestamp
     
  • bigint
     
  • selectedComponents
    array
     
  • state
    string
    The object's current state.
  • bigint
     
  • terminatedOn
    timestamp
     
  • terminatingOn
    timestamp
     
  • terminationIssuedOn
    timestamp
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
subscriptioncharge subscriptioncharge

The subscription charge represents a single charge carried out for a particular subscription.

The subscription charge represents a single charge carried out for a particular subscription.
  • createdOn
    timestamp
     
  • discardedBy
    bigint
     
  • discardedOn
    timestamp
     
  • externalId
    string
    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.
  • failedOn
    timestamp
     
  • failedUrl
    string
    The user will be redirected to failed URL when the transaction could not be authorized or completed. In case no failed URL is specified a default failed page will be displayed.
  • id
    bigint
    A unique identifier for the object.
  • language
    string
    The language that is linked to the object.
  • ledgerEntries
    array
     
  • plannedExecutionDate
    timestamp
     
  • processingType
    string
     
  • reference
    string
     
  • state
    string
    The object's current state.
  • bigint
    The field subscription indicates the subscription to which the charge belongs to.
  • succeedOn
    timestamp
     
  • successUrl
    string
    The user will be redirected to success URL when the transaction could be authorized or completed. In case no success URL is specified a default success page will be displayed.
  • bigint
     
  • type
    string
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
subscriptionledgerentry subscriptionledgerentry

The subscription ledger entry represents a single change on the subscription balance.

The subscription ledger entry represents a single change on the subscription balance.
  • aggregatedTaxRate
    decimal
     
  • amountExcludingTax
    decimal
     
  • amountIncludingTax
    decimal
     
  • createdBy
    bigint
     
  • createdOn
    timestamp
    The date and time when the object was created.
  • discountIncludingTax
    decimal
     
  • externalId
    string
    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.
  • id
    bigint
    A unique identifier for the object.
  • quantity
    decimal
     
  • state
    string
    The object's current state.
  • bigint
     
  • taxAmount
    decimal
     
  • taxes
    array
     
  • title
    string
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
coupon coupon

Coupons are a way to grant subscription discounts. Create a new coupon, configure it with discounts and rules and then share it with your customers.

Coupons are a way to grant subscription discounts. Create a new coupon, configure it with discounts and rules and then share it with your customers.
  • createdBy
    bigint
    The created by field indicates the user which has created the coupon.
  • createdOn
    timestamp
     
  • deletedBy
    bigint
    The deleted by field indicates the user which has deleted the coupon.
  • deletedOn
    timestamp
     
  • id
    bigint
    A unique identifier for the object.
  • name
    string
    The coupon name is only used for coupon management purposes and is never shown to the subscriber. You will be able to give this coupon a more detailed discription or name while configuring the coupon later on.
  • spaceId
    bigint
     
  • state
    string
    The object's current state.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
couponversion couponversion

The coupon version contains a subset of the coupon properties which can change over time.Only one version can be active at the same time.

The coupon version contains a subset of the coupon properties which can change over time.Only one version can be active at the same time.
  • activatedBy
    bigint
    The activated by field indicates the user which has activated the coupon version.
  • activatedOn
    timestamp
     
  • bigint
    The coupon to which the coupon version is linked to.
  • createdBy
    bigint
    The created by field indicates the user which has created the coupon version.
  • createdOn
    timestamp
     
  • id
    bigint
    A unique identifier for the object.
  • name
    struct
    A meaningful name or a short description to communicate the intent of the coupon. This is what the subscriber will see on his invoice or when he redeems the coupon code.
  • name.availableLanguages
    array
     
  • name.displayName
    string
     
  • name.items
    array
     
  • obsoletedBy
    bigint
    The obsoleted by field indicates the user which has obsoleted the coupon version.
  • obsoletedOn
    timestamp
     
  • state
    string
    The object's current state.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
abstractproductfee abstractproductfee
  • bigint
     
  • description
    struct
    The description of a component fee describes the fee to the subscriber. The description may be shown in documents or on certain user interfaces.
  • description.availableLanguages
    array
     
  • description.displayName
    string
     
  • description.items
    array
     
  • id
    bigint
    A unique identifier for the object.
  • name
    struct
    The name of the fee should describe for the subscriber in few words for what the fee is for.
  • name.availableLanguages
    array
     
  • name.displayName
    string
     
  • name.items
    array
     
  • type
    string
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
productmeteredfee productmeteredfee
  • bigint
     
  • description
    struct
    The description of a component fee describes the fee to the subscriber. The description may be shown in documents or on certain user interfaces.
  • description.availableLanguages
    array
     
  • description.displayName
    string
     
  • description.items
    array
     
  • id
    bigint
    A unique identifier for the object.
  • bigint
     
  • name
    struct
    The name of the fee should describe for the subscriber in few words for what the fee is for.
  • name.availableLanguages
    array
     
  • name.displayName
    string
     
  • name.items
    array
     
  • tierPricing
    string
    The tier pricing determines the calculation method of the tiers. The prices of the different tiers can be applied in different ways. The tier pricing controls this calculation.
  • type
    string
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
productperiodfee productperiodfee
  • bigint
     
  • description
    struct
    The description of a component fee describes the fee to the subscriber. The description may be shown in documents or on certain user interfaces.
  • description.availableLanguages
    array
     
  • description.displayName
    string
     
  • description.items
    array
     
  • id
    bigint
    A unique identifier for the object.
  • ledgerEntryTitle
    struct
    The ledger entry title will be used for the title in the ledger entry and in the invoice.
  • ledgerEntryTitle.availableLanguages
    array
     
  • ledgerEntryTitle.displayName
    string
     
  • ledgerEntryTitle.items
    array
     
  • name
    struct
    The name of the fee should describe for the subscriber in few words for what the fee is for.
  • name.availableLanguages
    array
     
  • name.displayName
    string
     
  • name.items
    array
     
  • numberOfFreeTrialPeriods
    int
    The number of free trial periods specify how many periods are free of charge at the begining of the subscription.
  • periodFee
    array
    The period fee is charged for every period of the subscription except for those periods which are trial periods.
  • type
    string
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
productsetupfee productsetupfee
  • bigint
     
  • description
    struct
    The description of a component fee describes the fee to the subscriber. The description may be shown in documents or on certain user interfaces.
  • description.availableLanguages
    array
     
  • description.displayName
    string
     
  • description.items
    array
     
  • id
    bigint
    A unique identifier for the object.
  • name
    struct
    The name of the fee should describe for the subscriber in few words for what the fee is for.
  • name.availableLanguages
    array
     
  • name.displayName
    string
     
  • name.items
    array
     
  • onDowngradeCreditedAmount
    array
    When the subscription is changed and the change is considered as a downgrade the amount defined by this property will be credited to the subscriber.
  • onUpgradeCreditedAmount
    array
    When the subscription is changed and the change is considered as a upgrade the amount defined by this property will be credited to the subscriber.
  • setupFee
    array
    The setup fee is charged when the subscriber subscribes to this component. The setup fee is debited with the first charge for the subscriptions.
  • type
    string
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
subscriptionmetric subscriptionmetric

A metric represents the usage of a resource that can be measured.

A metric represents the usage of a resource that can be measured.
  • description
    struct
     
  • description.availableLanguages
    array
     
  • description.displayName
    string
     
  • description.items
    array
     
  • id
    bigint
    A unique identifier for the object.
  • name
    struct
     
  • name.availableLanguages
    array
     
  • name.displayName
    string
     
  • name.items
    array
     
  • state
    string
    The object's current state.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
subscriptionproduct subscriptionproduct

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.

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.
  • allowedPaymentMethodConfigurations
    array
    The allowed payment method configurations control which payment methods can be used with this product. When none is selected all methods will be allowed.
  • failedPaymentSuspensionPeriod
    string
    When a payment fails, the subscription to which the payment belongs to will be suspended. When the suspension is not removed within the specified period the subscription will be terminated. A payment is considered as failed when the subscriber issues a refund or when a subscription charge fails.
  • id
    bigint
    A unique identifier for the object.
  • name
    string
    The product name is used internally to identify the configuration in administrative interfaces. For example it is used within search fields and hence it should be distinct and descriptive.
  • productLocked
    boolean
    Marks the product as locked. Meaning that customer can not change away from this product or change to this product later on.
  • reference
    string
    The product reference identifies the product for external systems. This field may contain the product's SKU.
  • sortOrder
    int
    The sort order controls in which order the product is listed. The sort order is used to order the products in ascending order.
  • spaceId
    bigint
     
  • state
    string
    The object's current state.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
subscriptionproductcomponent subscriptionproductcomponent
  • componentChangeWeight
    int
    If a product component changes from one with a lower product component tier (e.g. 1) to one with a higher product component tier (e.g. 3), it is considered an upgrade and a one-time fee could be applied.
  • bigint
     
  • defaultComponent
    boolean
    When a component is marked as a 'default' component it is used as the default component in its group and will be preselected in the product configuration.
  • description
    struct
    The component description may contain a longer description which gives the subscriber a better understanding of what the component contains.
  • description.availableLanguages
    array
     
  • description.displayName
    string
     
  • description.items
    array
     
  • id
    bigint
    A unique identifier for the object.
  • maximalQuantity
    decimal
    The maximum quantity defines the maximum value which must be entered for the quantity.
  • minimalQuantity
    decimal
    The minimal quantity defines the minimum value which must be entered for the quantity.
  • name
    struct
    The component name is shown to the subscriber. It should describe in few words what the component does contain.
  • name.availableLanguages
    array
     
  • name.displayName
    string
     
  • name.items
    array
     
  • quantityStep
    decimal
    The quantity step defines at which interval the quantity can be increased.
  • bigint
    The component reference is used to identify the component by external systems and it marks components to represent the same component within different product versions.
  • sortOrder
    int
    The sort order controls in which order the component is listed. The sort order is used to order the components in ascending order.
  • bigint
    The tax class of the component determines the taxes which are applicable on all fees linked with the component.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
subscriptionproductcomponentgroup subscriptionproductcomponentgroup
  • id
    bigint
    A unique identifier for the object.
  • name
    struct
    The component group name will be shown when the components are selected. This can be visible to the subscriber.
  • name.availableLanguages
    array
     
  • name.displayName
    string
     
  • name.items
    array
     
  • optional
    boolean
    The component group can be optional. This means no component has to be selected by the subscriber.
  • bigint
     
  • sortOrder
    int
    The sort order controls in which order the component group is listed. The sort order is used to order the component groups in ascending order.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
subscriptionproductcomponentreference subscriptionproductcomponentreference

The product component reference binds components from different product versions together. By binding them together the product version migration can be realized.

The product component reference binds components from different product versions together. By binding them together the product version migration can be realized.
  • id
    bigint
    A unique identifier for the object.
  • name
    string
    The component reference name is used internally to identify the reference. For example the name is used within search fields and hence it should be distinct and descriptive.
  • spaceId
    bigint
     
  • state
    string
    The object's current state.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
subscriptionproductversion subscriptionproductversion
  • activatedOn
    timestamp
     
  • billingCycle
    string
    The billing cycle determines the rhythm with which the subscriber is billed. The charging may have different rhythm.
  • comment
    string
    The comment allows to provide a internal comment for the version. It helps to document why a product was changed. The comment is not disclosed to the subscriber.
  • createdOn
    timestamp
     
  • defaultCurrency
    string
    The default currency has to be used in all fees.
  • enabledCurrencies
    array
    The currencies which are enabled can be selected to define component fees. Currencies which are not enabled cannot be used to define fees.
  • id
    bigint
    A unique identifier for the object.
  • incrementNumber
    int
    The increment number represents the version number incremented whenever a new version is activated.
  • minimalNumberOfPeriods
    int
    The minimal number of periods determines how long the subscription has to run before the subscription can be terminated.
  • name
    struct
    The product version name is the name of the product which is shown to the user for the version. When the visible product name should be changed for a particular product a new version has to be created which contains the new name of the product.
  • name.availableLanguages
    array
     
  • name.displayName
    string
     
  • name.items
    array
     
  • numberOfNoticePeriods
    int
    The number of notice periods determines the number of periods which need to be paid between the request to terminate the subscription and the final period.
  • obsoletedOn
    timestamp
     
  • bigint
    Each product version is linked to a product.
  • reference
    string
    The product version reference helps to identify the version. The reference is generated out of the product reference.
  • retiringFinishedOn
    timestamp
     
  • retiringStartedOn
    timestamp
     
  • state
    string
    The object's current state.
  • taxCalculation
    string
    Strategy that is used for tax calculation in fees.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
subscriber subscriber

A subscriber represents everyone who is subscribed to a product.

A subscriber represents everyone who is subscribed to a product.
  • additionalAllowedPaymentMethodConfigurations
    array
    Those payment methods which are allowed additionally will be available even when the product does not allow those methods.
  • billingAddress
    struct
     
  • billingAddress.city
    string
     
  • billingAddress.commercialRegisterNumber
    string
     
  • billingAddress.country
    string
     
  • billingAddress.dateOfBirth
    date
     
  • billingAddress.dependentLocality
    string
     
  • billingAddress.emailAddress
    string
     
  • billingAddress.familyName
    string
     
  • billingAddress.gender
    string
     
  • billingAddress.givenName
    string
     
  • bigint
     
  • billingAddress.mobilePhoneNumber
    string
     
  • billingAddress.organizationName
    string
     
  • billingAddress.phoneNumber
    string
     
  • billingAddress.postalState
    string
     
  • billingAddress.postcode
    string
     
  • billingAddress.salesTaxNumber
    string
     
  • billingAddress.salutation
    string
     
  • billingAddress.socialSecurityNumber
    string
     
  • billingAddress.sortingCode
    string
     
  • billingAddress.street
    string
     
  • description
    string
    The subscriber description can be used to add a description to the subscriber. This is used in the back office to identify the subscriber.
  • disallowedPaymentMethodConfigurations
    array
    Those payment methods which are disallowed will not be available to the subscriber even if the product allows those methods.
  • emailAddress
    string
    The email address is used to communicate with the subscriber. There can be only one subscriber per space with the same email address.
  • externalId
    string
    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.
  • id
    bigint
    A unique identifier for the object.
  • language
    string
    The subscriber language determines the language which is used to communicate with the subscriber in emails and documents (e.g. invoices).
  • metaData
    map
    Allow to store additional information about the object.
  • reference
    string
    The subscriber reference identifies the subscriber in administrative interfaces (e.g. customer id).
  • shippingAddress
    struct
     
  • shippingAddress.city
    string
     
  • shippingAddress.commercialRegisterNumber
    string
     
  • shippingAddress.country
    string
     
  • shippingAddress.dateOfBirth
    date
     
  • shippingAddress.dependentLocality
    string
     
  • shippingAddress.emailAddress
    string
     
  • shippingAddress.familyName
    string
     
  • shippingAddress.gender
    string
     
  • shippingAddress.givenName
    string
     
  • bigint
     
  • shippingAddress.mobilePhoneNumber
    string
     
  • shippingAddress.organizationName
    string
     
  • shippingAddress.phoneNumber
    string
     
  • shippingAddress.postalState
    string
     
  • shippingAddress.postcode
    string
     
  • shippingAddress.salesTaxNumber
    string
     
  • shippingAddress.salutation
    string
     
  • shippingAddress.socialSecurityNumber
    string
     
  • shippingAddress.sortingCode
    string
     
  • shippingAddress.street
    string
     
  • state
    string
    The object's current state.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
subscribercustomer subscribercustomer
  • bigint
     
  • id
    bigint
    A unique identifier for the object.
  • bigint
     
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.