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
    The category that the failure reason belongs to.
  • 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
    The ID of the space view this object is linked to.
  • 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
    The ID of the space view this object is linked to.
  • 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.
  • sortOrder
    int
    When listing sales channels, they can be sorted by this number.
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
    The data collection type specifies how the payment information is collected.
  • deprecated
    boolean
    Whether the object was deprecated.
  • deprecationReason
    map
    The deprecation reason describes why the object was deprecated.
  • 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
    The payment method that the connector supports.
  • bigint
    The specific brand that this payment connector supports.
  • primaryRiskTaker
    string
    The entity that bears the main risk in the event that a contracting party fails to meet its obligations.
  • bigint
    The processor that the connector belongs to.
  • supportedCurrencies
    array
    The currencies that are supported by the connector.
paymentconnectorconfiguration paymentconnectorconfiguration
  • applicableForTransactionProcessing
    boolean
    Whether this connector configuration is enabled for processing payments, taking into account the state of the processor and payment method configurations.
  • bigint
    The connector that the configuration is for.
  • enabledSalesChannels
    array
    The sales channels for which the connector configuration is enabled. If empty, it is enabled for all sales channels.
  • enabledSpaceViews
    array
    The space views for which the connector configuration is enabled. If empty, it is enabled for all space views.
  • id
    bigint
    A unique identifier for the object.
  • imagePath
    string
    The URL to the connector's image.
  • name
    string
    The name used to identify the connector configuration.
  • bigint
    The payment method configuration that the connector configuration belongs to.
  • priority
    int
    The priority that determines the order in which connector configurations are taken into account when processing a payment. Low values are considered first.
  • bigint
    The processor configuration that the connector configuration belongs to.
  • state
    string
    The object's current state.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
paymentcontract paymentcontract
  • bigint
    This account that the contract belongs to.
  • activatedOn
    timestamp
    The date and time when the contract was activated.
  • contractIdentifier
    string
    The identifier of the contract.
  • 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
    The date and time when the contract was rejected.
  • bigint
    The reason for rejecting the contract.
  • startTerminatingOn
    timestamp
    The date and time when the termination process of the contract was started.
  • state
    string
    The object's current state.
  • terminatedOn
    timestamp
    The date and time when the contract was terminated.
paymentmethod paymentmethod
  • dataCollectionTypes
    array
    The data collection types that are supported by the payment method.
  • 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
    The currencies that are supported by the payment method.
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
    The payment method that the brand belongs to.
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 specifies how the payment information is collected.
  • id
    bigint
    A unique identifier for the object.
  • name
    string
    The name used to identify the payment method configuration.
  • oneClickPaymentMode
    string
    The one-click payment mode determines whether the customer can save their payment details for later payments.
  • bigint
    The payment method that the configuration is for.
  • resolvedDescription
    map
    The 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.
  • resolvedTitle
    map
    The 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.
  • sortOrder
    int
    When listing payment methods, they can be sorted by this number.
  • state
    string
    The object's current state.
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
paymentprocessor paymentprocessor

Payment processors handle the connection to third part companies (payment service providers) that technically manage payment transactions and therefore process payments.

Payment processors handle the connection to third part companies (payment service providers) that technically manage payment transactions and therefore process payments.
  • companyName
    map
    The name of the company to which the processor belongs.
  • description
    map
    The localized description of the object.
  • headquartersLocation
    map
    Where the processor's headquarters are located.
  • id
    bigint
    A unique identifier for the object.
  • name
    map
    The localized name of the object.
  • productName
    map
    The name of the processor's product.
paymentprocessorconfiguration paymentprocessorconfiguration
  • applicationManaged
    boolean
    Whether the processor configuration is managed by the application and therefore cannot be changed.
  • contractId
    bigint
    The ID of the payment contract the processor configuration is linked to.
  • id
    bigint
    A unique identifier for the object.
  • name
    string
    The name used to identify the payment method configuration.
  • bigint
    The payment processor that the configuration is for.
  • 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
    The default currency of the terminal.
  • id
    bigint
    A unique identifier for the object.
  • identifier
    string
    The unique identifier of the terminal, that is displayed on the device.
  • name
    string
    The name used to identify the payment terminal.
  • state
    string
    The object's current state.
  • bigint
    The type of the payment terminal.
  • 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's email address.
  • customerId
    string
    The unique identifier of the customer in the external system.
  • enabledForOneClickPayment
    boolean
    Whether 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.
  • 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 customer's time zone, which affects how dates and times are formatted when communicating with the customer.
  • tokenReference
    string
    The reference used to identify the payment token (e.g. the customer's ID or email address).
  • linkedSpaceId
    bigint
    The ID of the space this object belongs to.
transaction transaction
  • acceptHeader
    string
    The 'Accept' header of the customer's web browser.
  • acceptLanguageHeader
    string
    The 'Accept Language' header of the customer's web browser.
  • allowedPaymentMethodBrands
    array
    The payment method brands that can be used to authorize the transaction.
  • allowedPaymentMethodConfigurations
    array
    The payment method configurations that can be used to authorize the transaction.
  • authorizationAmount
    decimal
    The sum of all line item prices including taxes in the transaction's currency.
  • authorizationEnvironment
    string
    The environment in which the transaction was authorized.
  • bigint
    The sales channel through which the transaction was placed.
  • authorizationTimeoutOn
    timestamp
    The date and time when the transaction must be authorized, otherwise it will canceled.
  • authorizedOn
    timestamp
    The date and time when the transaction was authorized.
  • autoConfirmationEnabled
    boolean
    Whether the transaction can be confirmed automatically or whether this must be done explicitly via the API. Default is true.
  • billingAddress
    struct
    The address associated with the payment method for invoicing and transaction processing purposes.
  • 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
    Whether the customer can make further payment attempts if the first one has failed. Default is true.
  • completedAmount
    decimal
    The total amount that was completed, in the transaction's currency.
  • completedOn
    timestamp
    The date and time when the transaction was completed.
  • completionBehavior
    string
    The behavior that controls when the transaction is completed.
  • completionTimeoutOn
    timestamp
    The date and time when the transaction is completed automatically.
  • confirmedBy
    bigint
    The ID of the user the transaction was confirmed by.
  • confirmedOn
    timestamp
    The date and time when the transaction was created.
  • createdBy
    bigint
    The ID of the user the transaction was created by.
  • createdOn
    timestamp
    The date and time when the object was created.
  • currency
    string
    The three-letter code (ISO 4217 format) of the transaction's currency.
  • customerEmailAddress
    string
    The customer's email address.
  • customerId
    string
    The unique identifier of the customer in the external system.
  • customersPresence
    string
    The customer's presence indicates whether and in what way the transaction's customer is present. Default is VIRTUAL_PRESENT.
  • deliveryDecisionMadeOn
    timestamp
    This date and time when the decision was made as to whether the order should be shipped.
  • deviceSessionIdentifier
    string
    Allows to link the transaction to the data collected from the customer's device.
  • emailsDisabled
    boolean
    Whether email sending is deactivated for the transaction. Default is false.
  • environment
    string
     
  • environmentSelectionStrategy
    string
    The strategy for determining whether the transaction is to be processed in the test or production environment.
  • failedOn
    timestamp
    The date and time when the transaction failed.
  • failedUrl
    string
    The URL to redirect the customer back to after they canceled or failed to authenticated their payment.
  • bigint
    The reason for the failure of the transaction.
  • id
    bigint
    A unique identifier for the object.
  • internetProtocolAddress
    string
    The IP address of the customer's device.
  • internetProtocolAddressCountry
    string
    The country determined from the IP address of the customer's device.
  • invoiceMerchantReference
    string
    The merchant's reference used to identify the invoice.
  • javaEnabled
    boolean
    Whether Java is enabled on the customer's web browser.
  • language
    string
    The language that is linked to the object.
  • lineItems
    array
    The line items purchased by the customer.
  • merchantReference
    string
    The merchant's reference used to identify the transaction.
  • metaData
    map
    Allow to store additional information about the object.
  • bigint
    The parent transaction which was (partially) replaced by this transaction.
  • bigint
    The payment connector configuration that was used to authorize the transaction.
  • processingOn
    timestamp
    The date and time when the processing of the transaction was started.
  • refundedAmount
    decimal
    The total amount that was refunded, in the transaction's currency.
  • screenColorDepth
    string
    The screen color depth of the customer's web browser.
  • screenHeight
    string
    The screen height of the customer's web browser.
  • screenWidth
    string
    The screen width of the customer's web browser.
  • shippingAddress
    struct
    The address to where the order will be shipped.
  • 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
    The name of the shipping method used to ship the products.
  • spaceViewId
    bigint
    The ID of the space view this object is linked to.
  • state
    string
    The object's current state.
  • successUrl
    string
    The URL to redirect the customer back to after they successfully authenticated their payment.
  • bigint
    The payment terminal through which the payment was processed.
  • timeZone
    string
    The customer's time zone, which affects how dates and times are formatted when communicating with the customer.
  • bigint
    The payment token that should be used to charge the customer.
  • tokenizationMode
    string
    The tokenization mode specifies whether and how the tokenization of payment information is applied to the transaction.
  • totalAppliedFees
    decimal
    The total of all fees charged, in the transaction's currency.
  • totalSettledAmount
    decimal
    The total amount that was settled, in the transaction's currency.
  • userAgentHeader
    string
    The 'User Agent' header of the customer's web browser.
  • userFailureMessage
    string
    The message that can be displayed to the customer explaining why the transaction failed, in the customer's language.
  • userInterfaceType
    string
    The type of user interface the customer used to provide the payment information.
  • windowHeight
    string
    The window height of the customer's web browser.
  • windowWidth
    string
    The window width of the customer's web browser.
  • yearsToKeep
    int
    The number of years the transaction is kept after its authorization.
  • 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
    The ID of the space view this object is linked to.
  • 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
    The ID of the space view this object is linked to.
  • 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.