Documentation
Documentation
Analytics Schema BETA
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.
  • parentAccount
    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.
  • group
    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
  • account
    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.
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
     
  • address.legalOrganizationForm
    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.
  • customer
    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.
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.
  • parent
    bigint
     
  • sortOrder
    int
     
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.
  • paymentMethod
    bigint
     
  • paymentMethodBrand
    bigint
     
  • primaryRiskTaker
    string
     
  • processor
    bigint
     
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.
  • connector
    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.
  • 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.
  • paymentMethodConfiguration
    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.
  • processorConfiguration
    bigint
     
  • state
    string
    The object's current state.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
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.
  • paymentMethod
    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
  • paymentMethod
    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.
  • processor
    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
     
  • completion
    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
     
  • failureReason
    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.
  • transaction
    bigint
     
  • type
    string
     
  • updatedInvoice
    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.
  • type
    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.
  • authorizationSalesChannel
    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
     
  • billingAddress.legalOrganizationForm
    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.
  • failureReason
    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.
  • parent
    bigint
     
  • paymentConnectorConfiguration
    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
     
  • shippingAddress.legalOrganizationForm
    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.
  • terminal
    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.
  • token
    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.
  • linkedTransaction
    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
     
  • billingAddress.legalOrganizationForm
    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
     
  • completion
    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
     
  • linkedTransaction
    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.