Download OpenAPI specification:Download
This is the OpenAPI description for accessing the plenigo partner platform.
Get customer that is identified by the passed customer id.
customerId required | string unique id of the customer |
{- "customerId": "100003",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED",
- "acceptedTerms": {
- "AEISLQ565BPITQ251O31": {
- "termId": 103300,
- "uniqueId": "V1.0",
- "acceptanceDate": "2020-03-21T17:32:12Z"
}
}
}
Search all addresses that correspond to the given search conditions and belong to the customer identified by the customer id provided.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "addressId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
]
}
Participate active wallets to a specific event.
eventListUniqueId required | string^[0-9\-a-zA-Z]{2,30}$ unique id of the event list |
eventListDateUniqueId required | string^[0-9\-a-zA-Z]{2,30}$ unique id of the event list date |
{- "success": true
}
Get all participants that participated these events.
eventListUniqueId required | string^[0-9\-a-zA-Z]{2,30}$ unique id of the event list |
eventListDateUniqueId required | string^[0-9\-a-zA-Z]{2,30}$ unique id of the event list date |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
{- "items": [
- {
- "customerId": "100003",
- "title": "Another great event",
- "walletUniqueId": "walletUniqueId",
- "eventListUniqueId": "eventListUniqueId",
- "eventListDateUniqueId": "eventListDateUniqueId",
- "creditUsed": "creditUsed"
}
]
}
Get all paywall products.
customerCountry required | string = 2 characters ISO 3166-1 alpha-2 billing country/region code of the user |
customerLanguage required | string = 2 characters language of the customer - two letter language code according to ISO 639-1 |
{- "paywallOfferInfos": [
- {
- "plenigoOfferId": "stringstringstringst"
}
]
}
Get a specific paywall product by plenigo offer id.
plenigoOfferId required | string plenigo offer id |
customerCountry required | string = 2 characters ISO 3166-1 alpha-2 billing country/region code of the user |
customerLanguage required | string = 2 characters language of the customer - two letter language code according to ISO 639-1 |
{- "plenigoOfferId": "stringstringstringst"
}
Get all access rights for a customer identified by the passed customer id.
customerId required | string unique id of the customer |
{- "customerId": "100003",
- "customerBlocked": false,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "items": [
- {
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "accessRightData": {
- "key": "value"
}, - "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
Check if customer has a valid access right for one or multiple access rights identified by the provided access right unique ids.
customerId required | string unique id of the customer |
accessRightUniqueIds required | string comma separated ids of access right unique ids |
{- "customerId": "100003",
- "customerBlocked": false,
- "accessGranted": true,
- "items": [
- {
- "accessGranted": true,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "accessRightData": {
- "key": "value"
}, - "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
This functionality verifies the log in data of a customer and executes the log in. The caller must decide if a username or email address is provided for login. If both are provided only the email address will be used.
username | string <= 100 characters username of the customer |
string <= 100 characters email of the customer | |
password required | string <= 100 characters password of the customer |
object (LoggingData) |
{- "username": "string",
- "email": "string",
- "password": "string",
- "loggingData": {
- "os": "string",
- "browser": "string",
- "source": "string",
- "sourceUrl": "string",
- "ipAddress": "string",
- "country": "st"
}
}
{- "customerId": "100003",
- "status": "ACTIVATED"
}
This functionality verifies the session transfer token and returns the customer id and customer status.
transferToken required | string <= 50 characters transfer token |
{- "customerId": "100003",
- "status": "ACTIVATED"
}
Search all access rights that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "accessRightId": 2000,
- "title": "A new access right",
- "uniqueId": "accessRight",
- "description": "Access right",
- "additionalData": {
- "key": "value"
}
}
]
}
Get all access rights for a customer identified by the passed customer id.
customerId required | string unique id of the customer |
{- "customerId": "100003",
- "customerBlocked": false,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "items": [
- {
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "accessRightData": {
- "key": "value"
}, - "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
Check if customer has a valid access right for one or multiple access rights identified by the provided access right unique ids.
customerId required | string unique id of the customer |
accessRightUniqueIds required | string comma separated ids of access right unique ids |
{- "customerId": "100003",
- "customerBlocked": false,
- "accessGranted": true,
- "items": [
- {
- "accessGranted": true,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "accessRightData": {
- "key": "value"
}, - "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
Search all Apple purchases that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
token | string app store token |
{- "items": [
- {
- "appleAppStorePurchaseId": 0,
- "purchaseDate": "2019-08-24T14:15:22Z",
- "token": "string",
- "valid": true,
- "appStoreOrderId": 0,
- "receipt": {
- "receiptType": "string",
- "adamID": 0,
- "appItemID": "string",
- "bundleID": "string",
- "applicationVersion": "string",
- "downloadID": 0,
- "versionExternalIdentifier": "string",
- "originalApplicationVersion": "string",
- "receiptCreationDate": "2019-08-24T14:15:22Z",
- "requestDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "items": [
- {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}
]
}, - "purchaseData": {
- "transactions": [
- {
- "transactionID": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "bundleID": "string",
- "productID": "string",
- "subscriptionGroupIdentifier": "string",
- "purchaseDate": 0,
- "originalPurchaseDate": 0,
- "expiresDate": 0,
- "quantity": 0,
- "type": "string",
- "appAccountToken": "string",
- "inAppOwnershipType": "string",
- "signedDate": 0,
- "offerType": 0,
- "offerIdentifier": "string",
- "revocationDate": 0,
- "revocationReason": 0,
- "isUpgraded": true,
- "storefront": "string",
- "storefrontId": "string",
- "transactionReason": "string",
- "environment": "string",
- "price": 0,
- "currency": "string",
- "offerDiscountType": "string"
}
]
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Add an Apple app store purchase to the plenigo system and retrieve a token for further processing.
appIdentifier | string <= 100 characters identifier of the application as defined in the plenigo backend to retrieve the according secret |
receiptData | Array of strings [ 1 .. 100 ] items [ items <= 10000 characters ] |
{- "appIdentifier": "string",
- "receiptData": [
- "string"
]
}
{- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
}
]
}
Get details for an Apple app store purchase.
appleAppStorePurchaseId required | integer <int64> unique id of the purchase |
{- "appleAppStorePurchaseId": 0,
- "purchaseDate": "2019-08-24T14:15:22Z",
- "token": "string",
- "valid": true,
- "appStoreOrderId": 0,
- "receipt": {
- "receiptType": "string",
- "adamID": 0,
- "appItemID": "string",
- "bundleID": "string",
- "applicationVersion": "string",
- "downloadID": 0,
- "versionExternalIdentifier": "string",
- "originalApplicationVersion": "string",
- "receiptCreationDate": "2019-08-24T14:15:22Z",
- "requestDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "items": [
- {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}
]
}, - "purchaseData": {
- "transactions": [
- {
- "transactionID": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "bundleID": "string",
- "productID": "string",
- "subscriptionGroupIdentifier": "string",
- "purchaseDate": 0,
- "originalPurchaseDate": 0,
- "expiresDate": 0,
- "quantity": 0,
- "type": "string",
- "appAccountToken": "string",
- "inAppOwnershipType": "string",
- "signedDate": 0,
- "offerType": 0,
- "offerIdentifier": "string",
- "revocationDate": 0,
- "revocationReason": 0,
- "isUpgraded": true,
- "storefront": "string",
- "storefrontId": "string",
- "transactionReason": "string",
- "environment": "string",
- "price": 0,
- "currency": "string",
- "offerDiscountType": "string"
}
]
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Associate an Apple app store purchase with a customer. Only app store purchases that include actual orders can be associated.
token required | string unique id of the purchase of an app store |
customerId | string^[0-9]{1,18}$ id of the customer to associate purchase with |
{- "customerId": "string"
}
{- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
}
]
}
Verify validity of Apple app store purchase.
token required | string unique id of the purchase of an app store |
{- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
}
]
}
Search all Google Playstore purchases that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
token | string app store token |
{- "items": [
- {
- "googlePlayStorePurchaseId": 0,
- "purchaseDate": "2019-08-24T14:15:22Z",
- "token": "string",
- "packageName": "string",
- "productId": "string",
- "valid": true,
- "subscription": true,
- "purchaseToken": "string",
- "appStoreOrderId": 0,
- "subscriptionPurchase": {
- "autoRenewing": true,
- "autoResumeTimeMillis": "string",
- "cancelReason": 0,
- "cancelSurveyReason": 0,
- "userInputCancelReason": "string",
- "subscriptionEndDate": "2019-08-24T14:15:22Z",
- "countryCode": "string",
- "developerPayload": "string",
- "expiryTimeMillis": "string",
- "kind": "string",
- "linkedPurchaseToken": "string",
- "orderId": "string",
- "paymentState": 0,
- "priceAmountMicros": "string",
- "priceCurrencyCode": "string",
- "profileId": "string",
- "profileName": "string",
- "purchaseType": 0,
- "startTimeMillis": "string",
- "userCancellationTimeMillis": "string"
}, - "productPurchase": {
- "acknowledgementState": "string",
- "consumptionState": "string",
- "developerPayload": "string",
- "kind": "string",
- "orderId": "string",
- "purchaseState": "string",
- "purchaseTimeMillis": "string",
- "purchaseType": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Add a Google Playstore purchase to the plenigo system and retrieve a token for further processing.
packageName | string <= 1000 characters package name of the application this purchase was done for (for example, 'com.some.thing'). |
Array of objects (GooglePlayStorePurchaseAdditionElement) [ 1 .. 100 ] items |
{- "packageName": "string",
- "receiptData": [
- {
- "productId": "string",
- "subscription": true,
- "purchaseToken": "string"
}
]
}
{- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
}
]
}
Get details for a Google Playstore purchase.
googlePlayStorePurchaseId required | integer <int64> unique id of the purchase |
{- "googlePlayStorePurchaseId": 0,
- "purchaseDate": "2019-08-24T14:15:22Z",
- "token": "string",
- "packageName": "string",
- "productId": "string",
- "valid": true,
- "subscription": true,
- "purchaseToken": "string",
- "appStoreOrderId": 0,
- "subscriptionPurchase": {
- "autoRenewing": true,
- "autoResumeTimeMillis": "string",
- "cancelReason": 0,
- "cancelSurveyReason": 0,
- "userInputCancelReason": "string",
- "subscriptionEndDate": "2019-08-24T14:15:22Z",
- "countryCode": "string",
- "developerPayload": "string",
- "expiryTimeMillis": "string",
- "kind": "string",
- "linkedPurchaseToken": "string",
- "orderId": "string",
- "paymentState": 0,
- "priceAmountMicros": "string",
- "priceCurrencyCode": "string",
- "profileId": "string",
- "profileName": "string",
- "purchaseType": 0,
- "startTimeMillis": "string",
- "userCancellationTimeMillis": "string"
}, - "productPurchase": {
- "acknowledgementState": "string",
- "consumptionState": "string",
- "developerPayload": "string",
- "kind": "string",
- "orderId": "string",
- "purchaseState": "string",
- "purchaseTimeMillis": "string",
- "purchaseType": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Associate a Google Playstore purchase with a customer.
token required | string unique id of the purchase of an app store |
customerId | string^[0-9]{1,18}$ id of the customer to associate purchase with |
{- "customerId": "string"
}
{- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
}
]
}
Verify validity of Google Playstore purchase.
token required | string unique id of the purchase of an app store |
{- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
}
]
}
Search all app store orders that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "appStoreOrderId": 0,
- "orderDate": "2019-08-24T14:15:22Z",
- "customerId": "string",
- "storeType": "APPSTORE",
- "additionalStoreData": {
- "receiptType": "string",
- "adamID": 0,
- "appItemID": "string",
- "bundleID": "string",
- "applicationVersion": "string",
- "downloadID": 0,
- "versionExternalIdentifier": "string",
- "originalApplicationVersion": "string",
- "receiptCreationDate": "2019-08-24T14:15:22Z",
- "requestDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "items": [
- {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}
]
}, - "items": [
- {
- "position": 0,
- "deliveryCustomerId": "string",
- "productId": "string",
- "appStoreSubscriptionId": 0,
- "accessRightUniqueId": "string",
- "additionalStoreItemData": {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Get details for an app store order.
appStoreOrderId required | integer <int64> unique id of the app store order |
{- "appStoreOrderId": 0,
- "orderDate": "2019-08-24T14:15:22Z",
- "customerId": "string",
- "storeType": "APPSTORE",
- "additionalStoreData": {
- "receiptType": "string",
- "adamID": 0,
- "appItemID": "string",
- "bundleID": "string",
- "applicationVersion": "string",
- "downloadID": 0,
- "versionExternalIdentifier": "string",
- "originalApplicationVersion": "string",
- "receiptCreationDate": "2019-08-24T14:15:22Z",
- "requestDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "items": [
- {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}
]
}, - "items": [
- {
- "position": 0,
- "deliveryCustomerId": "string",
- "productId": "string",
- "appStoreSubscriptionId": 0,
- "accessRightUniqueId": "string",
- "additionalStoreItemData": {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Search all app store subscriptions that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "appStoreSubscriptionId": 0,
- "chainId": 0,
- "externalSystemId": "string",
- "customerId": "string",
- "startDate": "2019-08-24T14:15:22Z",
- "endDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "status": "ACTIVE",
- "accessRightUniqueId": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Get details for an app store subscription.
appStoreSubscriptionId required | integer <int64> unique id of the app store subscription |
{- "appStoreSubscriptionId": 0,
- "chainId": 0,
- "externalSystemId": "string",
- "customerId": "string",
- "startDate": "2019-08-24T14:15:22Z",
- "endDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "status": "ACTIVE",
- "accessRightUniqueId": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Executes a purchase for the product represented by the provided voucher code. Only products that are completely free and have no follow up periods that must be paid can be bought that way.
customerId required | string^[0-9]{1,18}$ unique id of the customer the checkout is for |
customerSession | string <= 10000 characters active customer session - if a customer id is provided the customer id overrules the session |
invoiceAddressId | integer <int64> unique id of the invoice address to use |
deliveryAddressId | integer <int64> unique id of the delivery address to use |
customerIpAddress required | string <= 45 characters ip address of the customer |
object (AdditionalOrderData) | |
voucherCode required | string <= 20 characters voucher code to use |
overwrittenProductId | string <= 20 characters add a custom product id during the voucher checkout - this is only allowed for a single offer with one single purchase in it |
{- "customerId": "10003",
- "customerIpAddress": "198.51.100.42",
- "voucherCode": "1234-5678-1234"
}
{- "orderId": 0
}
Search all customers that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
externalSystemId | string external system id defined by third party systems |
string <email> email to search for | |
username | string username to search for |
customerMark | string Value: "WBZ" customer mark |
{- "items": [
- {
- "customerId": "100003",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED"
}
]
}
Create a new customer with the data provided.
customerId | string^[0-9]{1,18}$ unique id of the customer |
registrationSource | string <= 100 characters domain, website, app or other source of the customer registration |
password | string <= 100 characters password the new customer should get |
sendWelcomeMail | boolean flag indicating if welcome mail for customer should be sent |
Array of objects (CustomerAddressCreation) addresses that should be directly associated with the customer | |
object (AdditionalCustomerData) | |
pseudoEmail | boolean flag indicating that email should be a pseudo email |
processingBlocked | boolean Flag to indicate to third party systems that the customer is blocked for further processing and should not be used for advertisement, etc. Can be used in combination with the pseudoEmail flag to handle data protection requests without deletion of a customer. |
username | string <= 100 characters selected username of the customer that is unique for all users |
email required | string <email> <= 100 characters email address of the customer that is unique for all users |
externalSystemId | string <= 100 characters external system id - can only be set if not set yet |
salutation | string Enum: "DIVERSE" "MR" "MRS" "NONE" salutation to identify the correct designation of a customer |
firstName | string <= 100 characters first name of the customer - first name and last name or company name are required |
lastName | string <= 100 characters last name of the customer - first name and last name or company name are required |
invoiceEmail | string <email> <= 100 characters email address of the customer where invoices should be sent to |
language required | string = 2 characters language of the customer - two letter language code according to ISO 639-1 |
mobileNumber | string <= 100 characters (^\+?[1-9]\d{1,14}$|^$) mobile number of the customer formatted as E.164 |
birthday | string or null <date> birthday of the customer with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-01 |
object (CustomerMiscellaneousData) |
{- "customerId": "100003",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED",
- "addresses": [
- {
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
], - "data": {
- "myCustomerId": "1234CustomerId"
}
}
{- "customerId": "100003",
- "externalSystemId": "1748-E",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "salutation": "MR",
- "firstName": "John",
- "lastName": "Doe",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED",
- "changedDate": "2019-03-21T17:32:12Z",
- "registrationDate": "2019-03-21T17:32:12Z",
- "registrationSource": "www.example.com",
- "twoFactorEnabled": false,
- "addresses": [
- {
- "addressId": 10004,
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
], - "data": {
- "myCustomerId": "1234CustomerId"
}
}
This functionality verifies the log in data of a customer and executes the log in. The caller must decide if a username or email address is provided for login. If both are provided only the email address will be used.
username | string <= 100 characters username of the customer |
string <= 100 characters email of the customer | |
password required | string <= 100 characters password of the customer |
object (LoggingData) |
{- "username": "string",
- "email": "string",
- "password": "string",
- "loggingData": {
- "os": "string",
- "browser": "string",
- "source": "string",
- "sourceUrl": "string",
- "ipAddress": "string",
- "country": "st"
}
}
{- "customerId": "100003",
- "status": "ACTIVATED"
}
This functionality verifies the session transfer token and returns the customer id and customer status.
transferToken required | string <= 50 characters transfer token |
{- "customerId": "100003",
- "status": "ACTIVATED"
}
Search all access rights that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "accessRightId": 2000,
- "title": "A new access right",
- "uniqueId": "accessRight",
- "description": "Access right",
- "additionalData": {
- "key": "value"
}
}
]
}
Create credit wallet.
uniqueId | string^[0-9\-a-zA-Z]{2,30}$ unique id of the wallet for identification |
creditCount | integer <int64> [ 1 .. 100000000 ] credit count to create wallet with |
customerId | string^[0-9]{1,18}$ unique id of the customer the credit wallet belongs to |
{- "items": {
- "customerId": "42",
- "uniqueId": "company-wallet",
- "creditCount": 5
}
}
{- "items": {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
}
{- "items": [
- {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
]
}
Get credit wallet uploads.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "customerId": "42",
- "creditUploadId": 6000001,
- "uploadDate": "2022-01-03T17:32:12Z",
- "uniqueId": "company-wallet",
- "creditsAdded": 5,
- "title": "Added by subscription",
- "itemType": "SUBSCRIPTION_ITEM",
- "itemId": 90300000
}
]
}
Get credit wallet usages.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "customerId": "42",
- "creditUsageId": 5900001,
- "usageDate": "2022-01-02T17:32:12Z",
- "uniqueId": "company-wallet",
- "creditsUsed": 2,
- "reason": "Usage of product one"
}
]
}
Uploads a credit to a given credit wallet.
customerId | string^[0-9]{1,18}$ id of the customer the credit usage should be accounted to |
uniqueId | string^[0-9\-a-zA-Z]{2,30}$ unique id of the wallet to use |
title | string <= 100 characters title of upload |
creditCount | integer <int64> [ 1 .. 100000000 ] amount of credits to add |
{- "items": {
- "customerId": "42",
- "title": "New monthly credits",
- "uniqueId": "company-wallet",
- "creditCount": 2
}
}
{- "items": {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
}
Uses a credit from a given credit wallet.
customerId required | string^[0-9]{1,18}$ id of the customer the credit usage should be accounted to |
uniqueId required | string^[0-9\-a-zA-Z]{2,30}$ unique id of the wallet to use |
creditsUsed required | integer <int64> [ 1 .. 100000 ] amount of credits used |
reason required | string <= 100 characters reason for credit usage |
category | string <= 100 characters category for credit usage |
{- "items": {
- "customerId": "42",
- "uniqueId": "company-wallet",
- "creditsUsed": 2,
- "reason": "Usage of product one"
}
}
{- "items": {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
}
Get customer credit wallets.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
{- "items": [
- {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
]
}
Get credit wallet uploads.
customerId required | string unique id of the customer |
uniqueId required | string unique id of the wallet |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "customerId": "42",
- "creditUploadId": 6000001,
- "uploadDate": "2022-01-03T17:32:12Z",
- "uniqueId": "company-wallet",
- "creditsAdded": 5,
- "title": "Added by subscription",
- "itemType": "SUBSCRIPTION_ITEM",
- "itemId": 90300000
}
]
}
Get credit wallet usages.
customerId required | string unique id of the customer |
uniqueId required | string unique id of the wallet |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "customerId": "42",
- "creditUsageId": 5900001,
- "usageDate": "2022-01-02T17:32:12Z",
- "uniqueId": "company-wallet",
- "creditsUsed": 2,
- "reason": "Usage of product one"
}
]
}
Get all access rights for a customer identified by the passed customer id.
customerId required | string unique id of the customer |
{- "customerId": "100003",
- "customerBlocked": false,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "items": [
- {
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "accessRightData": {
- "key": "value"
}, - "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
Check if customer has a valid access right for one or multiple access rights identified by the provided access right unique ids.
customerId required | string unique id of the customer |
accessRightUniqueIds required | string comma separated ids of access right unique ids |
{- "customerId": "100003",
- "customerBlocked": false,
- "accessGranted": true,
- "items": [
- {
- "accessGranted": true,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "accessRightData": {
- "key": "value"
}, - "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
Search all Apple purchases that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
token | string app store token |
{- "items": [
- {
- "appleAppStorePurchaseId": 0,
- "purchaseDate": "2019-08-24T14:15:22Z",
- "token": "string",
- "valid": true,
- "appStoreOrderId": 0,
- "receipt": {
- "receiptType": "string",
- "adamID": 0,
- "appItemID": "string",
- "bundleID": "string",
- "applicationVersion": "string",
- "downloadID": 0,
- "versionExternalIdentifier": "string",
- "originalApplicationVersion": "string",
- "receiptCreationDate": "2019-08-24T14:15:22Z",
- "requestDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "items": [
- {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}
]
}, - "purchaseData": {
- "transactions": [
- {
- "transactionID": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "bundleID": "string",
- "productID": "string",
- "subscriptionGroupIdentifier": "string",
- "purchaseDate": 0,
- "originalPurchaseDate": 0,
- "expiresDate": 0,
- "quantity": 0,
- "type": "string",
- "appAccountToken": "string",
- "inAppOwnershipType": "string",
- "signedDate": 0,
- "offerType": 0,
- "offerIdentifier": "string",
- "revocationDate": 0,
- "revocationReason": 0,
- "isUpgraded": true,
- "storefront": "string",
- "storefrontId": "string",
- "transactionReason": "string",
- "environment": "string",
- "price": 0,
- "currency": "string",
- "offerDiscountType": "string"
}
]
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Add an Apple app store purchase to the plenigo system and retrieve a token for further processing.
appIdentifier | string <= 100 characters identifier of the application as defined in the plenigo backend to retrieve the according secret |
receiptData | Array of strings [ 1 .. 100 ] items [ items <= 10000 characters ] |
{- "appIdentifier": "string",
- "receiptData": [
- "string"
]
}
{- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
}
]
}
Get details for an Apple app store purchase.
appleAppStorePurchaseId required | integer <int64> unique id of the purchase |
{- "appleAppStorePurchaseId": 0,
- "purchaseDate": "2019-08-24T14:15:22Z",
- "token": "string",
- "valid": true,
- "appStoreOrderId": 0,
- "receipt": {
- "receiptType": "string",
- "adamID": 0,
- "appItemID": "string",
- "bundleID": "string",
- "applicationVersion": "string",
- "downloadID": 0,
- "versionExternalIdentifier": "string",
- "originalApplicationVersion": "string",
- "receiptCreationDate": "2019-08-24T14:15:22Z",
- "requestDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "items": [
- {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}
]
}, - "purchaseData": {
- "transactions": [
- {
- "transactionID": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "bundleID": "string",
- "productID": "string",
- "subscriptionGroupIdentifier": "string",
- "purchaseDate": 0,
- "originalPurchaseDate": 0,
- "expiresDate": 0,
- "quantity": 0,
- "type": "string",
- "appAccountToken": "string",
- "inAppOwnershipType": "string",
- "signedDate": 0,
- "offerType": 0,
- "offerIdentifier": "string",
- "revocationDate": 0,
- "revocationReason": 0,
- "isUpgraded": true,
- "storefront": "string",
- "storefrontId": "string",
- "transactionReason": "string",
- "environment": "string",
- "price": 0,
- "currency": "string",
- "offerDiscountType": "string"
}
]
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Associate an Apple app store purchase with a customer. Only app store purchases that include actual orders can be associated.
token required | string unique id of the purchase of an app store |
customerId | string^[0-9]{1,18}$ id of the customer to associate purchase with |
{- "customerId": "string"
}
{- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
}
]
}
Verify validity of Apple app store purchase.
token required | string unique id of the purchase of an app store |
{- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
}
]
}
Search all Google Playstore purchases that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
token | string app store token |
{- "items": [
- {
- "googlePlayStorePurchaseId": 0,
- "purchaseDate": "2019-08-24T14:15:22Z",
- "token": "string",
- "packageName": "string",
- "productId": "string",
- "valid": true,
- "subscription": true,
- "purchaseToken": "string",
- "appStoreOrderId": 0,
- "subscriptionPurchase": {
- "autoRenewing": true,
- "autoResumeTimeMillis": "string",
- "cancelReason": 0,
- "cancelSurveyReason": 0,
- "userInputCancelReason": "string",
- "subscriptionEndDate": "2019-08-24T14:15:22Z",
- "countryCode": "string",
- "developerPayload": "string",
- "expiryTimeMillis": "string",
- "kind": "string",
- "linkedPurchaseToken": "string",
- "orderId": "string",
- "paymentState": 0,
- "priceAmountMicros": "string",
- "priceCurrencyCode": "string",
- "profileId": "string",
- "profileName": "string",
- "purchaseType": 0,
- "startTimeMillis": "string",
- "userCancellationTimeMillis": "string"
}, - "productPurchase": {
- "acknowledgementState": "string",
- "consumptionState": "string",
- "developerPayload": "string",
- "kind": "string",
- "orderId": "string",
- "purchaseState": "string",
- "purchaseTimeMillis": "string",
- "purchaseType": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Add a Google Playstore purchase to the plenigo system and retrieve a token for further processing.
packageName | string <= 1000 characters package name of the application this purchase was done for (for example, 'com.some.thing'). |
Array of objects (GooglePlayStorePurchaseAdditionElement) [ 1 .. 100 ] items |
{- "packageName": "string",
- "receiptData": [
- {
- "productId": "string",
- "subscription": true,
- "purchaseToken": "string"
}
]
}
{- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
}
]
}
Get details for a Google Playstore purchase.
googlePlayStorePurchaseId required | integer <int64> unique id of the purchase |
{- "googlePlayStorePurchaseId": 0,
- "purchaseDate": "2019-08-24T14:15:22Z",
- "token": "string",
- "packageName": "string",
- "productId": "string",
- "valid": true,
- "subscription": true,
- "purchaseToken": "string",
- "appStoreOrderId": 0,
- "subscriptionPurchase": {
- "autoRenewing": true,
- "autoResumeTimeMillis": "string",
- "cancelReason": 0,
- "cancelSurveyReason": 0,
- "userInputCancelReason": "string",
- "subscriptionEndDate": "2019-08-24T14:15:22Z",
- "countryCode": "string",
- "developerPayload": "string",
- "expiryTimeMillis": "string",
- "kind": "string",
- "linkedPurchaseToken": "string",
- "orderId": "string",
- "paymentState": 0,
- "priceAmountMicros": "string",
- "priceCurrencyCode": "string",
- "profileId": "string",
- "profileName": "string",
- "purchaseType": 0,
- "startTimeMillis": "string",
- "userCancellationTimeMillis": "string"
}, - "productPurchase": {
- "acknowledgementState": "string",
- "consumptionState": "string",
- "developerPayload": "string",
- "kind": "string",
- "orderId": "string",
- "purchaseState": "string",
- "purchaseTimeMillis": "string",
- "purchaseType": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Associate a Google Playstore purchase with a customer.
token required | string unique id of the purchase of an app store |
customerId | string^[0-9]{1,18}$ id of the customer to associate purchase with |
{- "customerId": "string"
}
{- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
}
]
}
Verify validity of Google Playstore purchase.
token required | string unique id of the purchase of an app store |
{- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
}
]
}
Search all app store orders that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "appStoreOrderId": 0,
- "orderDate": "2019-08-24T14:15:22Z",
- "customerId": "string",
- "storeType": "APPSTORE",
- "additionalStoreData": {
- "receiptType": "string",
- "adamID": 0,
- "appItemID": "string",
- "bundleID": "string",
- "applicationVersion": "string",
- "downloadID": 0,
- "versionExternalIdentifier": "string",
- "originalApplicationVersion": "string",
- "receiptCreationDate": "2019-08-24T14:15:22Z",
- "requestDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "items": [
- {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}
]
}, - "items": [
- {
- "position": 0,
- "deliveryCustomerId": "string",
- "productId": "string",
- "appStoreSubscriptionId": 0,
- "accessRightUniqueId": "string",
- "additionalStoreItemData": {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Get details for an app store order.
appStoreOrderId required | integer <int64> unique id of the app store order |
{- "appStoreOrderId": 0,
- "orderDate": "2019-08-24T14:15:22Z",
- "customerId": "string",
- "storeType": "APPSTORE",
- "additionalStoreData": {
- "receiptType": "string",
- "adamID": 0,
- "appItemID": "string",
- "bundleID": "string",
- "applicationVersion": "string",
- "downloadID": 0,
- "versionExternalIdentifier": "string",
- "originalApplicationVersion": "string",
- "receiptCreationDate": "2019-08-24T14:15:22Z",
- "requestDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "items": [
- {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}
]
}, - "items": [
- {
- "position": 0,
- "deliveryCustomerId": "string",
- "productId": "string",
- "appStoreSubscriptionId": 0,
- "accessRightUniqueId": "string",
- "additionalStoreItemData": {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Search all app store subscriptions that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "appStoreSubscriptionId": 0,
- "chainId": 0,
- "externalSystemId": "string",
- "customerId": "string",
- "startDate": "2019-08-24T14:15:22Z",
- "endDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "status": "ACTIVE",
- "accessRightUniqueId": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Get details for an app store subscription.
appStoreSubscriptionId required | integer <int64> unique id of the app store subscription |
{- "appStoreSubscriptionId": 0,
- "chainId": 0,
- "externalSystemId": "string",
- "customerId": "string",
- "startDate": "2019-08-24T14:15:22Z",
- "endDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "status": "ACTIVE",
- "accessRightUniqueId": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Executes a purchase for the product represented by the provided voucher code. Only products that are completely free and have no follow up periods that must be paid can be bought that way.
customerId required | string^[0-9]{1,18}$ unique id of the customer the checkout is for |
customerSession | string <= 10000 characters active customer session - if a customer id is provided the customer id overrules the session |
invoiceAddressId | integer <int64> unique id of the invoice address to use |
deliveryAddressId | integer <int64> unique id of the delivery address to use |
customerIpAddress required | string <= 45 characters ip address of the customer |
object (AdditionalOrderData) | |
voucherCode required | string <= 20 characters voucher code to use |
overwrittenProductId | string <= 20 characters add a custom product id during the voucher checkout - this is only allowed for a single offer with one single purchase in it |
{- "customerId": "10003",
- "customerIpAddress": "198.51.100.42",
- "voucherCode": "1234-5678-1234"
}
{- "orderId": 0
}
Search all customers that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
externalSystemId | string external system id defined by third party systems |
string <email> email to search for | |
username | string username to search for |
customerMark | string Value: "WBZ" customer mark |
{- "items": [
- {
- "customerId": "100003",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED"
}
]
}
Create a new customer with the data provided.
customerId | string^[0-9]{1,18}$ unique id of the customer |
registrationSource | string <= 100 characters domain, website, app or other source of the customer registration |
password | string <= 100 characters password the new customer should get |
sendWelcomeMail | boolean flag indicating if welcome mail for customer should be sent |
Array of objects (CustomerAddressCreation) addresses that should be directly associated with the customer | |
object (AdditionalCustomerData) | |
pseudoEmail | boolean flag indicating that email should be a pseudo email |
processingBlocked | boolean Flag to indicate to third party systems that the customer is blocked for further processing and should not be used for advertisement, etc. Can be used in combination with the pseudoEmail flag to handle data protection requests without deletion of a customer. |
username | string <= 100 characters selected username of the customer that is unique for all users |
email required | string <email> <= 100 characters email address of the customer that is unique for all users |
externalSystemId | string <= 100 characters external system id - can only be set if not set yet |
salutation | string Enum: "DIVERSE" "MR" "MRS" "NONE" salutation to identify the correct designation of a customer |
firstName | string <= 100 characters first name of the customer - first name and last name or company name are required |
lastName | string <= 100 characters last name of the customer - first name and last name or company name are required |
invoiceEmail | string <email> <= 100 characters email address of the customer where invoices should be sent to |
language required | string = 2 characters language of the customer - two letter language code according to ISO 639-1 |
mobileNumber | string <= 100 characters (^\+?[1-9]\d{1,14}$|^$) mobile number of the customer formatted as E.164 |
birthday | string or null <date> birthday of the customer with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-01 |
object (CustomerMiscellaneousData) |
{- "customerId": "100003",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED",
- "addresses": [
- {
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
], - "data": {
- "myCustomerId": "1234CustomerId"
}
}
{- "customerId": "100003",
- "externalSystemId": "1748-E",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "salutation": "MR",
- "firstName": "John",
- "lastName": "Doe",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED",
- "changedDate": "2019-03-21T17:32:12Z",
- "registrationDate": "2019-03-21T17:32:12Z",
- "registrationSource": "www.example.com",
- "twoFactorEnabled": false,
- "addresses": [
- {
- "addressId": 10004,
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
], - "data": {
- "myCustomerId": "1234CustomerId"
}
}
This functionality verifies the log in data of a customer and executes the log in. The caller must decide if a username or email address is provided for login. If both are provided only the email address will be used.
username | string <= 100 characters username of the customer |
string <= 100 characters email of the customer | |
password required | string <= 100 characters password of the customer |
object (LoggingData) |
{- "username": "string",
- "email": "string",
- "password": "string",
- "loggingData": {
- "os": "string",
- "browser": "string",
- "source": "string",
- "sourceUrl": "string",
- "ipAddress": "string",
- "country": "st"
}
}
{- "customerId": "100003",
- "status": "ACTIVATED"
}
This functionality verifies the session transfer token and returns the customer id and customer status.
transferToken required | string <= 50 characters transfer token |
{- "customerId": "100003",
- "status": "ACTIVATED"
}
Search all access rights that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "accessRightId": 2000,
- "title": "A new access right",
- "uniqueId": "accessRight",
- "description": "Access right",
- "additionalData": {
- "key": "value"
}
}
]
}
Create credit wallet.
uniqueId | string^[0-9\-a-zA-Z]{2,30}$ unique id of the wallet for identification |
creditCount | integer <int64> [ 1 .. 100000000 ] credit count to create wallet with |
customerId | string^[0-9]{1,18}$ unique id of the customer the credit wallet belongs to |
{- "items": {
- "customerId": "42",
- "uniqueId": "company-wallet",
- "creditCount": 5
}
}
{- "items": {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
}
{- "items": [
- {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
]
}
Get credit wallet uploads.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "customerId": "42",
- "creditUploadId": 6000001,
- "uploadDate": "2022-01-03T17:32:12Z",
- "uniqueId": "company-wallet",
- "creditsAdded": 5,
- "title": "Added by subscription",
- "itemType": "SUBSCRIPTION_ITEM",
- "itemId": 90300000
}
]
}
Get credit wallet usages.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "customerId": "42",
- "creditUsageId": 5900001,
- "usageDate": "2022-01-02T17:32:12Z",
- "uniqueId": "company-wallet",
- "creditsUsed": 2,
- "reason": "Usage of product one"
}
]
}
Uploads a credit to a given credit wallet.
customerId | string^[0-9]{1,18}$ id of the customer the credit usage should be accounted to |
uniqueId | string^[0-9\-a-zA-Z]{2,30}$ unique id of the wallet to use |
title | string <= 100 characters title of upload |
creditCount | integer <int64> [ 1 .. 100000000 ] amount of credits to add |
{- "items": {
- "customerId": "42",
- "title": "New monthly credits",
- "uniqueId": "company-wallet",
- "creditCount": 2
}
}
{- "items": {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
}
Uses a credit from a given credit wallet.
customerId required | string^[0-9]{1,18}$ id of the customer the credit usage should be accounted to |
uniqueId required | string^[0-9\-a-zA-Z]{2,30}$ unique id of the wallet to use |
creditsUsed required | integer <int64> [ 1 .. 100000 ] amount of credits used |
reason required | string <= 100 characters reason for credit usage |
category | string <= 100 characters category for credit usage |
{- "items": {
- "customerId": "42",
- "uniqueId": "company-wallet",
- "creditsUsed": 2,
- "reason": "Usage of product one"
}
}
{- "items": {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
}
Get customer credit wallets.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
{- "items": [
- {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
]
}
Get credit wallet uploads.
customerId required | string unique id of the customer |
uniqueId required | string unique id of the wallet |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "customerId": "42",
- "creditUploadId": 6000001,
- "uploadDate": "2022-01-03T17:32:12Z",
- "uniqueId": "company-wallet",
- "creditsAdded": 5,
- "title": "Added by subscription",
- "itemType": "SUBSCRIPTION_ITEM",
- "itemId": 90300000
}
]
}
Get credit wallet usages.
customerId required | string unique id of the customer |
uniqueId required | string unique id of the wallet |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "customerId": "42",
- "creditUsageId": 5900001,
- "usageDate": "2022-01-02T17:32:12Z",
- "uniqueId": "company-wallet",
- "creditsUsed": 2,
- "reason": "Usage of product one"
}
]
}