Download OpenAPI specification:Download
This is the API description for accessing the plenigo customer API.
Check if customer has a valid access right for one or multiple access rights identified by the provided access right unique ids.
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 addresses 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": [
- {
- "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"
}
]
}
Create a new address with the data provided.
type required | string Enum: "INVOICE" "DELIVERY" address type |
customerId required | string^[0-9]{1,18}$ unique id of the customer the address belongs to |
preferred | boolean flag indicating if address is default selection for address type |
businessAddress | boolean flag indicating if address represents a private or a business address |
salutation | string Enum: "DIVERSE" "MR" "MRS" "NONE" salutation to identify the correct designation of a customer |
title | string <= 100 characters title of the 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 |
companyName | string <= 100 characters company name - first name and last name or company name are required |
additionalCompanyInfo | string <= 100 characters additional information belonging to the company |
street | string <= 100 characters street name |
streetNumber | string <= 100 characters street number |
additionalStreetInfo | string <= 100 characters additional information describing address |
postbox | string <= 100 characters postbox id |
postcode | string <= 100 characters postcode |
city | string <= 100 characters city |
state | string <= 2 characters state |
country | string = 2 characters country code formatted as ISO 3166-1 alpha-2 |
vatNumber | string <= 20 characters VAT number of a member country of the European Union |
phoneNumber | string <= 100 characters ^\+?[1-9]\d{1,14}$ phone number of the customer formatted as E.164 |
deliveryInformation | string <= 100 characters delivery information |
academicTitle | string <= 100 characters academic title |
jobPosition | string <= 100 characters job position |
validationStatus | string Enum: "NONE" "VALID" "INVALID" "SUSPECT" "OVERRIDDEN" validation status of the address |
validationHash | string validation hash of a valid address |
{- "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"
}
{- "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"
}
Get address that is identified by the passed address id.
addressId required | integer <int64> unique id of the address |
{- "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"
}
Update an address that is identified by the passed address id with the data provided. If fields were filled before and are now passed empty these fields will be cleared.
addressId required | integer <int64> unique id of the address |
preferred | boolean flag indicating if address is default selection for address type |
businessAddress | boolean flag indicating if address represents a private or a business address |
salutation | string Enum: "DIVERSE" "MR" "MRS" "NONE" salutation to identify the correct designation of a customer |
title | string <= 100 characters title of the 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 |
companyName | string <= 100 characters company name - first name and last name or company name are required |
additionalCompanyInfo | string <= 100 characters additional information belonging to the company |
street | string <= 100 characters street name |
streetNumber | string <= 100 characters street number |
additionalStreetInfo | string <= 100 characters additional information describing address |
postbox | string <= 100 characters postbox id |
postcode | string <= 100 characters postcode |
city | string <= 100 characters city |
state | string <= 2 characters state |
country | string = 2 characters country code formatted as ISO 3166-1 alpha-2 |
vatNumber | string <= 20 characters VAT number of a member country of the European Union |
phoneNumber | string <= 100 characters ^\+?[1-9]\d{1,14}$ phone number of the customer formatted as E.164 |
deliveryInformation | string <= 100 characters delivery information |
academicTitle | string <= 100 characters academic title |
jobPosition | string <= 100 characters job position |
validationStatus | string Enum: "NONE" "VALID" "INVALID" "SUSPECT" "OVERRIDDEN" validation status of the address |
validationHash | string validation hash of a valid address |
{- "preferred": true,
- "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"
}
{- "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"
}
Delete an address that is identified by the passed address id. Only addresses that are not associated with a subscription can be deleted. If such an address shall be deleted it must first be disconnected from the subscription.
addressId required | integer <int64> unique id of the address |
{- "success": true
}
Get all future addresses that correspond to the given address id.
addressId required | integer <int64> unique id of the address |
{- "items": [
- {
- "activationDate": "2019-03-21",
- "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"
}, - {
- "activationDate": "2019-06-21",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "32",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
]
}
Create a new future address with the data provided. An address can only have two future addresses
addressId required | integer <int64> unique id of the address |
date required | string <date> date of the future address |
overrideValidation | boolean flag if the validation should be ignored |
businessAddress | boolean flag indicating if address represents a private or a business address |
salutation | string Enum: "DIVERSE" "MR" "MRS" "NONE" salutation to identify the correct designation of a customer |
title | string <= 100 characters title of the 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 |
companyName | string <= 100 characters company name - first name and last name or company name are required |
additionalCompanyInfo | string <= 100 characters additional information belonging to the company |
street | string <= 100 characters street name |
streetNumber | string <= 100 characters street number |
additionalStreetInfo | string <= 100 characters additional information describing address |
postbox | string <= 100 characters postbox id |
postcode | string <= 100 characters postcode |
city | string <= 100 characters city |
state | string <= 2 characters state |
country | string = 2 characters country code formatted as ISO 3166-1 alpha-2 |
vatNumber | string <= 20 characters VAT number of a member country of the European Union |
phoneNumber | string <= 100 characters ^\+?[1-9]\d{1,14}$ phone number of the customer formatted as E.164 |
deliveryInformation | string <= 100 characters delivery information |
academicTitle | string <= 100 characters academic title |
jobPosition | string <= 100 characters job position |
validationStatus | string Enum: "NONE" "VALID" "INVALID" "SUSPECT" "OVERRIDDEN" validation status of the address |
validationHash | string validation hash of a valid address |
{- "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"
}
{- "activationDate": "2019-03-21",
- "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"
}
Update a future address that is identified by the passed date with the data provided. If fields were filled before and are now passed empty these fields will be cleared.
addressId required | integer <int64> unique id of the address |
date required | string <date> date of the future address |
overrideValidation | boolean flag if the validation should be ignored |
businessAddress | boolean flag indicating if address represents a private or a business address |
salutation | string Enum: "DIVERSE" "MR" "MRS" "NONE" salutation to identify the correct designation of a customer |
title | string <= 100 characters title of the 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 |
companyName | string <= 100 characters company name - first name and last name or company name are required |
additionalCompanyInfo | string <= 100 characters additional information belonging to the company |
street | string <= 100 characters street name |
streetNumber | string <= 100 characters street number |
additionalStreetInfo | string <= 100 characters additional information describing address |
postbox | string <= 100 characters postbox id |
postcode | string <= 100 characters postcode |
city | string <= 100 characters city |
state | string <= 2 characters state |
country | string = 2 characters country code formatted as ISO 3166-1 alpha-2 |
vatNumber | string <= 20 characters VAT number of a member country of the European Union |
phoneNumber | string <= 100 characters ^\+?[1-9]\d{1,14}$ phone number of the customer formatted as E.164 |
deliveryInformation | string <= 100 characters delivery information |
academicTitle | string <= 100 characters academic title |
jobPosition | string <= 100 characters job position |
validationStatus | string Enum: "NONE" "VALID" "INVALID" "SUSPECT" "OVERRIDDEN" validation status of the address |
validationHash | string validation hash of a valid address |
{- "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"
}
{- "activationDate": "2019-03-21",
- "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"
}
Delete a future address that is identified by the passed date.
addressId required | integer <int64> unique id of the address |
date required | string <date> date of the future address |
{- "success": true
}
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 |
{- "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"
}
]
}
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"
}
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 |
{- "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"
}
]
}
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"
}
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"
}
Returns snippet design data
companyId required | string unique id of a company |
{- "backgroundColor": "string",
- "firstColor": "string",
- "secondColor": "string",
- "font": "string",
- "fontColor": "string",
- "linkColor": "string",
- "snippetCss": "string",
- "snippetJavaScript": "string"
}
Search all corporate accounts 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. |
{- "items": [
- {
- "corporateAccountId": 9310,
- "customerId": "100003",
- "title": "A new offer",
- "plenigoOfferId": "O_123456789123456789",
- "usersAmount": 5,
- "users": [
- {
- "corporateAccountUserId": 9401,
- "email": "wildflower@example.com",
- "salutation": "MR",
- "firstName": "John",
- "lastName": "Doe",
- "status": "ACTIVE",
- "customerId": "100006",
- "corporateAccountCode": "123456789123"
}
], - "accessRightItems": [
- {
- "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,
- "accessRightItemId": "P_TTA1E7173120881551",
- "internAccessRightItemId": "P_TTA1E7173120881551",
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
]
}
Get the corporate account of the customer.
corporateAccountId required | integer <int64> unique id of the corporate account |
{- "corporateAccountId": 9310,
- "customerId": "100003",
- "title": "A new offer",
- "plenigoOfferId": "O_123456789123456789",
- "usersAmount": 5,
- "users": [
- {
- "corporateAccountUserId": 9401,
- "email": "wildflower@example.com",
- "salutation": "MR",
- "firstName": "John",
- "lastName": "Doe",
- "status": "INVITED",
- "corporateAccountCode": "1234567891234567"
}
], - "accessRightItems": [
- {
- "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,
- "accessRightItemId": "P_TTA1E7173120881551",
- "internAccessRightItemId": "P_TTA1E7173120881551",
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
Create a corporate account user for the given corporate account.
corporateAccountId required | integer <int64> unique id of the corporate account |
sendMail | boolean flag indicating if an email should be send |
email required | string <email> <= 100 characters email address of the customer that should belong to this corporate account user |
salutation required | string Enum: "DIVERSE" "MR" "MRS" "NONE" salutation to identify the correct designation of a customer |
firstName required | string <= 100 characters first name of the customer - first name and last name or company name are required |
lastName required | string <= 100 characters last name of the customer - first name and last name or company name are required |
{- "email": "wildflower@example.com",
- "salutation": "MR",
- "firstName": "John",
- "lastName": "Doe"
}
{- "corporateAccountId": 9310,
- "customerId": "100003",
- "title": "A new offer",
- "plenigoOfferId": "O_123456789123456789",
- "usersAmount": 5,
- "users": [
- {
- "corporateAccountUserId": 9401,
- "email": "wildflower@example.com",
- "salutation": "MR",
- "firstName": "John",
- "lastName": "Doe",
- "status": "INVITED",
- "corporateAccountCode": "1234567891234567"
}
], - "accessRightItems": [
- {
- "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,
- "accessRightItemId": "P_TTA1E7173120881551",
- "internAccessRightItemId": "P_TTA1E7173120881551",
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
Delete a corporate account user for the given corporate account.
corporateAccountId required | integer <int64> unique id of the corporate account |
corporateAccountUserId required | integer <int64> unique id of the corporate account user |
{- "corporateAccountId": 9310,
- "customerId": "100003",
- "title": "A new offer",
- "plenigoOfferId": "O_123456789123456789",
- "usersAmount": 5,
- "users": [
- {
- "corporateAccountUserId": 9401,
- "email": "wildflower@example.com",
- "salutation": "MR",
- "firstName": "John",
- "lastName": "Doe",
- "status": "INVITED",
- "corporateAccountCode": "1234567891234567"
}
], - "accessRightItems": [
- {
- "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,
- "accessRightItemId": "P_TTA1E7173120881551",
- "internAccessRightItemId": "P_TTA1E7173120881551",
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
Resend a corporate account user invitation email for the given corporate account.
corporateAccountId required | integer <int64> unique id of the corporate account |
corporateAccountUserId required | integer <int64> unique id of the corporate account user |
{- "success": true
}
Check if a corporate account user code is valid.
code required | string [ 16 .. 19 ] characters unique code for the corporate account user |
{- "code": "1234-5678-9123-4567"
}
{- "corporateAccountId": 9310,
- "plenigoOfferId": "O_123456789123456789",
- "status": "INVITED"
}
Use a corporate account user code.
code required | string [ 16 .. 19 ] characters unique code for the corporate account user |
{- "code": "1234-5678-9123-4567"
}
{- "errorCode": 99400,
- "errorMessage": "Provided data cannot be processed.",
- "validationErrors": [
- {
- "field": "customerId",
- "error": "numeric",
- "value": "C1454646"
}
]
}
Search all foreign orders that correspond to the given search conditions and belong to 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": [
- {
- "orderId": 12200,
- "changedDate": "2019-03-21T17:32:12Z",
- "status": "DONE",
- "type": "ORDER",
- "orderDate": "2019-03-21T17:32:12Z",
- "accumulatedPrice": 12,
- "currency": "EUR",
- "paymentMethod": "PAYPAL",
- "paymentMethodId": 100231,
- "invoiceCustomerId": 100003,
- "invoiceAddress": {
- "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"
}, - "items": [
- {
- "position": 1,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_MZA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "A simple cup",
- "taxType": "PHYSICALPRODUCT",
- "price": 12,
- "tax": 19,
- "taxCountry": "DE",
- "quantity": 12,
- "deliveryCustomerId": "100003",
- "deliveryAddress": {
- "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"
}
}
]
}
]
}
Search all invoices 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": [
- {
- "invoiceId": 12200,
- "changedDate": "2019-03-21T17:32:12Z",
- "invoiceDate": "2019-03-21T17:32:12Z",
- "accumulatedPrice": 12,
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMetodId": 145,
- "invoiceCustomerId": 100003,
- "invoiceAddress": {
- "businessAddress": true,
- "salutation": "MR",
- "title": "Prince",
- "firstName": "Michael",
- "lastName": "Example",
- "companyName": "Example Ltd.",
- "additionalCompanyInfo": "London",
- "street": "King Street",
- "streetNumber": "4",
- "additionalStreetInfo": "Appartment 5",
- "postcode": "E-3245",
- "city": "London",
- "country": "GB",
- "vatNumber": "GB123456789"
}, - "items": [
- {
- "position": 1,
- "title": "A simple cup",
- "price": 12,
- "tax": 19,
- "taxCountry": "DE",
- "quantity": 12,
- "deliveryCustomerId": "100003",
- "deliveryAddress": {
- "businessAddress": true,
- "salutation": "MR",
- "title": "Prince",
- "firstName": "Michael",
- "lastName": "Example",
- "companyName": "Example Ltd.",
- "additionalCompanyInfo": "London",
- "street": "King Street",
- "streetNumber": "4",
- "additionalStreetInfo": "Appartment 5",
- "postcode": "E-3245",
- "city": "London",
- "country": "GB",
- "vatNumber": "GB123456789"
}
}
]
}
]
}
Search all 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": [
- {
- "orderId": 12200,
- "changedDate": "2019-03-21T17:32:12Z",
- "status": "DONE",
- "type": "ORDER",
- "orderDate": "2019-03-21T17:32:12Z",
- "accumulatedPrice": 12,
- "currency": "EUR",
- "paymentMethod": "PAYPAL",
- "paymentMethodId": 100231,
- "invoiceCustomerId": 100003,
- "invoiceAddress": {
- "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"
}, - "items": [
- {
- "position": 1,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_MZA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "A simple cup",
- "taxType": "PHYSICALPRODUCT",
- "price": 12,
- "tax": 19,
- "taxCountry": "DE",
- "quantity": 12,
- "deliveryCustomerId": "100003",
- "deliveryAddress": {
- "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"
}
}
]
}
]
}
Get pdf file that contains the order item voucher represented by the passed order id.
orderId required | integer <int64> unique id of the order |
orderItemPosition required | integer <int> position of the order item |
{- "pdf": "string"
}
Resend the order item voucher email to the customer.
orderId required | integer <int64> unique id of the order |
orderItemPosition required | integer <int> position of the order item |
{- "success": true
}
Get purchased addon that is identified by the passed address id.
purchasedAddonId required | integer <int64> unique id of the purchase addon |
{- "purchasedAddonId": 0,
- "deliveryCustomerId": "string",
- "addonType": "BONUS",
- "plenigoAddonId": "stringstringstringst",
- "accessRightUniqueId": "string",
- "orderId": 0,
- "orderItemPosition": 0,
- "status": "CANCELLED",
- "deliveryCondition": "AFTER_PAYMENT",
- "deliveryDate": "2019-08-24T14:15:22Z",
- "trackingData": {
- "trackingId": "string",
- "trackingUrl": "string",
- "serviceProvider": "string",
- "sendingDate": "2019-08-24T14:15:22Z",
- "arrivalDate": "2019-08-24T14:15:22Z",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Search all payment methods that correspond to the given search conditions.
{- "amazonPayAccounts": [
- {
- "amazonPayAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "25727275674275",
- "active": true,
- "preferred": true
}
], - "bankAccounts": [
- {
- "bankAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "owner": "John Doe",
- "iban": "DE19123412341234123412",
- "active": true,
- "preferred": true
}
], - "creditCards": [
- {
- "creditCardId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "owner": "John Doe",
- "cardType": "MASTERCARD",
- "paymentProvider": "STRIPE",
- "providerToken": "C13487324913",
- "obfuscatedNumber": "132412432xxxxx1234",
- "validTo": "2019-07-01",
- "active": true,
- "preferred": true
}
], - "payPalAccounts": [
- {
- "payPalAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "billingAgreementId": "B-1234124324124",
- "active": true,
- "preferred": true
}
]
}
Get all allowed payment methods for a specific offer.
plenigoOfferId required | string plenigo offer id |
{- "allowedPaymentMethods": [
- "BILLING",
- "CREDIT_CARD"
]
}
Search all AmazonPay accounts accounts 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": [
- {
- "amazonPayAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
]
}
Create a new AmazonPay account with the data provided.
chargePermissionId required | string <= 50 characters the amazon pay charge permission id |
preferred | boolean flag indicating if amazon pay account is the preferred amazon pay account - only one amazon pay account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "chargePermissionId": "S02-7331650-8246451",
- "preferred": true
}
{- "amazonPayAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
Get AmazonPay account that is identified by the passed bank account id.
amazonPayAccountId required | integer <int64> unique id of the AmazonPay account |
{- "amazonPayAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
Update an AmazonPay account that is identified by the passed bank account id with the data provided.
amazonPayAccountId required | integer <int64> unique id of the AmazonPay account |
chargePermissionId required | string <= 50 characters the amazon pay charge permission id |
preferred | boolean flag indicating if amazon pay account is the preferred amazon pay account - only one amazon pay account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "chargePermissionId": "S02-7331650-8246451",
- "preferred": true
}
{- "amazonPayAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
Delete an AmazonPay account. This is only possible if bank account is not associated with a subscription. Otherwise the subscription association must be removed first.
amazonPayAccountId required | integer <int64> unique id of the AmazonPay account |
{- "success": true
}
Search all bank accounts 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": [
- {
- "bankAccountId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "iban": "GB19123412341234123412",
- "mandateId": "12342342",
- "mandateDate": "2019-03-21T17:32:12Z",
- "active": true,
- "preferred": true
}
]
}
Create a new bank account with the data provided.
customerId required | string^[0-9]{1,18}$ unique id of the payment mandate - if not sent plenigo will generate a new one together with a mandate date |
mandateId | string unique id of the payment mandate |
mandateDate | string or null <date> date the payment mandate was created with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
pspMandateId | string <= 100 characters psp mandate id |
owner required | string <= 30 characters name on bank account |
iban required | string [ 18 .. 32 ] characters |
bic | string [ 8 .. 11 ] characters BIC - only necessary for countries outside the EU |
preferred | boolean flag indicating if bank account is the preferred bank account - only one bank account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "customerId": "100003",
- "owner": "John Doe",
- "iban": "GB19123412341234123412",
- "mandateId": "12342342",
- "mandateDate": "2019-03-21T17:32:12Z",
- "preferred": true
}
{- "bankAccountId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "iban": "GB19123412341234123412",
- "mandateId": "12342342",
- "mandateDate": "2019-03-21T17:32:12Z",
- "active": true,
- "preferred": true
}
Creates a new PayOne SEPA mandate.
owner required | string <= 30 characters name on bank account |
iban required | string [ 18 .. 32 ] characters |
bic | string [ 8 .. 11 ] characters BIC - only necessary for countries outside the EU |
preferred | boolean flag indicating if bank account is the preferred bank account - only one bank account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "owner": "John Doe",
- "iban": "GB19123412341234123412"
}
{- "mandateId": "PO_33423412432",
- "mandateText": "<b>Mandate-ID</b>",
- "mandateStatus": "open"
}
Get bank account that is identified by the passed bank account id.
bankAccountId required | integer <int64> unique id of the bank account |
{- "bankAccountId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "iban": "GB19123412341234123412",
- "mandateId": "12342342",
- "mandateDate": "2019-03-21T17:32:12Z",
- "active": true,
- "preferred": true
}
Update a bank account that is identified by the passed bank account id with the data provided.
bankAccountId required | integer <int64> unique id of the bank account |
owner required | string <= 30 characters name on bank account |
iban required | string [ 18 .. 32 ] characters |
bic | string [ 8 .. 11 ] characters BIC - only necessary for countries outside the EU |
preferred | boolean flag indicating if bank account is the preferred bank account - only one bank account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "owner": "John Doe",
- "iban": "GB19123412341234123412"
}
{- "bankAccountId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "iban": "GB19123412341234123412",
- "mandateId": "12342342",
- "mandateDate": "2019-03-21T17:32:12Z",
- "active": true,
- "preferred": true
}
Delete a bank account. This is only possible if bank account is not associated with a subscription. Otherwise the subscription association must be removed first.
bankAccountId required | integer <int64> unique id of the bank account |
{- "success": true
}
Search all credit cards 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": [
- {
- "creditCardId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "cardType": "MASTERCARD",
- "paymentProvider": "STRIPE",
- "providerToken": "C13487324913",
- "obfuscatedNumber": "132412432xxxxx1234",
- "validTo": "2019-07-01",
- "active": true,
- "preferred": true
}
]
}
Create a new credit card with the data provided.
owner required | string <= 30 characters name on credit card |
cardType | string Enum: "VISA" "MASTERCARD" "AMERICAN_EXPRESS" "DISCOVER" "DINERS_CLUB" "JCB" type of the credit card provided |
providerToken required | string <= 100 characters unique credit card token provided by the payment service provider to identify credit card |
obfuscatedNumber required | string <= 30 characters obfuscated credit card number |
validTo required | string or null <date> date the credit card is valid to with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-01 - must be in the future |
preferred | boolean flag indicating if credit card is the preferred credit card - only one credit card can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "owner": "John Doe",
- "cardType": "MASTERCARD",
- "providerToken": "C13487324913",
- "obfuscatedNumber": "132412432xxxxx1234",
- "validTo": "2019-07-01",
- "preferred": true
}
{- "creditCardId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "cardType": "MASTERCARD",
- "paymentProvider": "STRIPE",
- "providerToken": "C13487324913",
- "obfuscatedNumber": "132412432xxxxx1234",
- "validTo": "2019-07-01",
- "active": true,
- "preferred": true
}
Get credit card that is identified by the passed credit card id.
creditCardId required | integer <int64> unique id of the credit card |
{- "creditCardId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "cardType": "MASTERCARD",
- "paymentProvider": "STRIPE",
- "providerToken": "C13487324913",
- "obfuscatedNumber": "132412432xxxxx1234",
- "validTo": "2019-07-01",
- "active": true,
- "preferred": true
}
Update a bank account that is identified by the passed address id with the data provided.
creditCardId required | integer <int64> unique id of the credit card |
owner required | string <= 30 characters name on credit card |
cardType | string Enum: "VISA" "MASTERCARD" "AMERICAN_EXPRESS" "DISCOVER" "DINERS_CLUB" "JCB" type of the credit card provided |
providerToken required | string <= 100 characters unique credit card token provided by the payment service provider to identify credit card |
obfuscatedNumber required | string <= 30 characters obfuscated credit card number |
validTo required | string or null <date> date the credit card is valid to with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-01 - must be in the future |
preferred | boolean flag indicating if credit card is the preferred credit card - only one credit card can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "owner": "John Doe",
- "cardType": "MASTERCARD",
- "providerToken": "C13487324913",
- "obfuscatedNumber": "132412432xxxxx1234",
- "validTo": "2019-07-01",
- "preferred": true
}
{- "creditCardId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "cardType": "MASTERCARD",
- "paymentProvider": "STRIPE",
- "providerToken": "C13487324913",
- "obfuscatedNumber": "132412432xxxxx1234",
- "validTo": "2019-07-01",
- "active": true,
- "preferred": true
}
Delete a credit card. This is only possible if credit card is not associated with a subscription. Otherwise the subscription association must be removed first.
creditCardId required | integer <int64> unique id of the credit card |
{- "success": true
}
Search all iDeal accounts 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": [
- {
- "iDealAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "owner": "John Doe",
- "obfuscatedIban": "GB19123412341234123412",
- "pspAccountId": "pk_TYooMQauvdEDq54NiTphI7jx",
- "fingerprint": "Xt5EWLLDS7FJjR1c",
- "active": true
}
]
}
Create a new iDeal account with the data provided.
owner required | string <= 30 characters name on bank account |
obfuscatedIban required | string <= 32 characters obfuscated IBAN |
pspAccountId required | string <= 100 characters payment service provider iDeal account id |
fingerprint required | string <= 100 characters fingerprint to check account uniqueness |
preferred required | boolean flag indicating if iDeal account is the preferred one |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "owner": "John Doe",
- "obfuscatedIban": "GB19123412341234123412",
- "pspAccountId": "pk_TYooMQauvdEDq54NiTphI7jx",
- "fingerprint": "Xt5EWLLDS7FJjR1c"
}
{- "iDealAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "owner": "John Doe",
- "obfuscatedIban": "GB19123412341234123412",
- "pspAccountId": "pk_TYooMQauvdEDq54NiTphI7jx",
- "fingerprint": "Xt5EWLLDS7FJjR1c",
- "active": true
}
Get iDeal account that is identified by the passed iDeal account id.
iDealAccountId required | integer <int64> unique id of the iDeal account |
{- "iDealAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "owner": "John Doe",
- "obfuscatedIban": "GB19123412341234123412",
- "pspAccountId": "pk_TYooMQauvdEDq54NiTphI7jx",
- "fingerprint": "Xt5EWLLDS7FJjR1c",
- "active": true
}
Update an iDeal account that is identified by the passed iDeal account id with the data provided.
iDealAccountId required | integer <int64> unique id of the iDeal account |
owner required | string <= 30 characters name on bank account |
obfuscatedIban required | string <= 32 characters obfuscated IBAN |
pspAccountId required | string <= 100 characters payment service provider iDeal account id |
fingerprint required | string <= 100 characters fingerprint to check account uniqueness |
preferred required | boolean flag indicating if iDeal account is the preferred one |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "owner": "John Doe",
- "obfuscatedIban": "GB19123412341234123412",
- "pspAccountId": "pk_TYooMQauvdEDq54NiTphI7jx",
- "fingerprint": "Xt5EWLLDS7FJjR1c"
}
{- "iDealAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "owner": "John Doe",
- "obfuscatedIban": "GB19123412341234123412",
- "pspAccountId": "pk_TYooMQauvdEDq54NiTphI7jx",
- "fingerprint": "Xt5EWLLDS7FJjR1c",
- "active": true
}
Delete an iDeal account. This is only possible if iDeal account is not associated with a subscription. Otherwise the subscription association must be removed first.
iDealAccountId required | integer <int64> unique id of the iDeal account |
{- "success": true
}
Search all PayPal accounts accounts 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": [
- {
- "payPalAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "billingAgreementId": "B-1234124324124",
- "active": true,
- "preferred": true
}
]
}
Create a new PayPal account with the data provided.
billingAgreementId required | string <= 30 characters PayPal billing agreement |
preferred | boolean flag indicating if PayPal account is the preferred PayPal account - only one PayPal account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "billingAgreementId": "B-1234124324124",
- "preferred": true
}
{- "billingAgreementId": "B-1234124324124",
- "changedDate": "2019-03-21T17:32:12Z",
- "active": true,
- "preferred": true
}
Get PayPal account that is identified by the passed bank account id.
payPalAccountId required | integer <int64> unique id of the PayPal account |
{- "billingAgreementId": "B-1234124324124",
- "changedDate": "2019-03-21T17:32:12Z",
- "active": true,
- "preferred": true
}
Update a PayPal account that is identified by the passed bank account id with the data provided.
payPalAccountId required | integer <int64> unique id of the PayPal account |
billingAgreementId required | string <= 30 characters PayPal billing agreement |
preferred | boolean flag indicating if PayPal account is the preferred PayPal account - only one PayPal account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "billingAgreementId": "B-1234124324124",
- "preferred": true
}
{- "billingAgreementId": "B-1234124324124",
- "changedDate": "2019-03-21T17:32:12Z",
- "active": true,
- "preferred": true
}
Delete a PayPal account. This is only possible if bank account is not associated with a subscription. Otherwise the subscription association must be removed first.
payPalAccountId required | integer <int64> unique id of the PayPal account |
{- "success": true
}
Search all PostFinance accounts accounts 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": [
- {
- "postFinanceAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
]
}
Create a new PostFinance account with the data provided.
chargePermissionId required | string <= 50 characters the PostFinance charge permission id |
preferred | boolean flag indicating if PostFinance account is the preferred PostFinance account - only one PostFinance account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "chargePermissionId": "S02-7331650-8246451",
- "preferred": true
}
{- "postFinanceAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
Get PostFinance account that is identified by the passed bank account id.
postFinanceAccountId required | integer <int64> unique id of the PostFinance account |
{- "postFinanceAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
Update a PostFinance account that is identified by the passed bank account id with the data provided.
postFinanceAccountId required | integer <int64> unique id of the PostFinance account |
chargePermissionId required | string <= 50 characters the PostFinance charge permission id |
preferred | boolean flag indicating if PostFinance account is the preferred PostFinance account - only one PostFinance account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "chargePermissionId": "S02-7331650-8246451",
- "preferred": true
}
{- "postFinanceAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
Delete a PostFinance account. This is only possible if bank account is not associated with a subscription. Otherwise the subscription association must be removed first.
postFinanceAccountId required | integer <int64> unique id of the PostFinance account |
{- "success": true
}
Search all Twint accounts accounts 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": [
- {
- "twintAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
]
}
Create a new Twint account with the data provided.
chargePermissionId required | string <= 50 characters the Twint charge permission id |
preferred | boolean flag indicating if Twint account is the preferred Twint account - only one Twint account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "chargePermissionId": "S02-7331650-8246451",
- "preferred": true
}
{- "twintAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
Get Twint account that is identified by the passed bank account id.
twintAccountId required | integer <int64> unique id of the Twint account |
{- "twintAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
Update a Twint account that is identified by the passed bank account id with the data provided.
twintAccountId required | integer <int64> unique id of the Twint account |
chargePermissionId required | string <= 50 characters the Twint charge permission id |
preferred | boolean flag indicating if Twint account is the preferred Twint account - only one Twint account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "chargePermissionId": "S02-7331650-8246451",
- "preferred": true
}
{- "twintAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
Delete a Twint account. This is only possible if bank account is not associated with a subscription. Otherwise the subscription association must be removed first.
twintAccountId required | integer <int64> unique id of the Twint account |
{- "success": true
}
Pre authorize credit card through PayOne.
owner required | string <= 50 characters Owner of the credit card |
pseudoCardPan required | string <= 30 characters Pseudo card pan provided by PayOne form result |
successUrl required | string <uri> <= 255 characters success url to redirect to after 3D secure check was successful |
errorUrl required | string <uri> <= 255 characters error url to redirect to after 3D secure check failed |
backUrl required | string <uri> <= 255 characters back url to redirect to if customer aborts the process |
{- "owner": "John Doe",
- "pseudoCardPan": "13412543498773232",
}
{- "status": "SUCCESS"
}
Retrieve Stripe credit card details for temporary token.
owner | string Credit card owner |
creditCardId | string Stripe credit card id |
{- "owner": "John Doe",
- "creditCardId": "14234792430143"
}
{- "owner": "John Doe",
- "cardType": "VISA",
- "providerToken": "cc_34242342423234",
- "obfuscatedNumber": "XXXXXXXXXXXXXXX4232",
- "validTo": "12/2020"
}
Retrieve Stripe iDeal details for temporary token.
setupIntentId | string Setup intent id |
{- "setupIntentId": "pk_TYooMQauvdEDq54NiTphI7jx"
}
{- "obfuscatedIban": "GBXXXXXXXXXXXXXXX3412",
- "pspAccountId": "pk_TYooMQauvdEDq54NiTphI7jx",
- "fingerprint": "Xt5EWLLDS7FJjR1c"
}
Initialize PayPal billing agreement and start billing agreement process.
successUrl | string <uri> <= 255 characters success url to redirect customer to after billing agreement was accepted |
cancellationUrl | string <uri> <= 255 characters url to redirect customer to if the billing agreement process is cancelled |
{
}
{- "tokenId": "BA-34234134123424",
}
Create PayPal billing agreement.
tokenId | string <= 40 characters billing agreement id |
{- "tokenId": "B-13434134123424"
}
{- "id": "52341234123"
}
Add two factor authenticator to the current session user.
token | string <= 100 characters The jwt token to validate the step. |
twoFactorToken | string = 6 characters The two factor token. |
{- "token": "enk328952342knl234DAD",
- "twoFactorToken": 123456
}
{- "success": true
}
{- "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"
}
}
}
Change age verification pin.
password | string <= 8 characters age pin |
{- "pin": "1234"
}
{- "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"
}
}
}
Change first name and last name of the session user.
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 |
{- "firstName": "John",
- "lastName": "Doe"
}
{- "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"
}
}
}
Change password of the session user.
password required | string <= 100 characters current password of the customer |
newPassword required | string <= 100 characters new password of the customer |
{- "password": "oldPassword",
- "newPassword": "newPassword"
}
{- "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"
}
}
}
Start change email process of the session user.
string <email> <= 100 characters new email of the customer |
{- "email": "test@example.com"
}
{- "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
Change username of the session user.
username | string <= 100 characters new username of the customer |
{- "username": "user1"
}
{- "success": true
}
Initialize process for adding a two factor authenticator for the current session user.
{- "companyId": "string",
- "nextStep": "ADDITIONAL_DATA",
- "twoFactorBarCodeImage": "string",
- "verificationToken": "string",
- "additionalInformation": { },
- "token": "string"
}
Resend email with verification token.
token required | string The token to validate the step. |
{- "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
{- "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
Verify age verification pin.
password | string <= 8 characters age pin |
{- "pin": "1234"
}
{- "success": true
}
Verifies the current password.
password | string <= 100 characters password to check |
{- "password": "BestPassword"
}
{- "success": true
}
Verify new email address by email verification token.
token | string <= 100 characters The jwt token to validate the step. |
verificationToken | string = 6 characters The verification token. |
{- "token": "enk328952342knl234DAD",
- "verificationToken": 123456
}
{- "success": true
}
{- "items": [
- {
- "sessionId": "0ujssxh0cECutqzMgbtXSGnjorm",
- "browser": "Mozilla/5.0 (Android 4.4; Mobile; rv:41.0) Gecko/41.0 Firefox/41.0",
- "os": "Android 4.4",
- "createdAt": "2019-01-01T07:53:23.450961Z"
}
]
}
Validates a transfer token and returns the session information in case of a transfer token.
companyId required | string unique id of a company |
transferToken required | string <= 50 characters transfer token |
{- "customerSession": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
Get settings needed for snippets.
language | string = 2 characters language of the request - two letter language code according to ISO 639-1 |
{- "paymentProvider": "STRIPE",
- "designs": {
- "backgroundColor": "#d92020",
- "firstColor": "#0e30dd",
- "secondColor": "#18e71f",
- "font": "",
- "fontColor": "#322f2f",
- "linkColor": "#000000",
- "snippetCss": "body {\\r\\n color: green;\\r\\n}\\r\\nbutton {\\r\\n background: red;\\r\\n color: white;\\r\\n}",
- "snippetJavaScript": ""
}
}
Returns translation for text module.
plenigoOfferId required | string plenigo offer id |
language required | string = 2 characters language to use - two letter language code according to ISO 639-1 |
{- "language": "st",
- "text": "string",
- "preferred": true
}
Search all 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": [
- {
- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptionItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
]
}
Search all cross client 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": [
- {
- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptionItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
]
}
Get subscription that is identified by the passed subscription id.
subscriptionId required | integer <int64> unique id of the subscription |
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Change the address that is associated with a subscription.
subscriptionId required | integer <int64> unique id of the subscription |
addressId required | integer <int64> id of the address to add to the subscription |
addressType required | string Enum: "INVOICE" "DELIVERY" address type of the address to change |
{- "addressId": 28023,
- "addressType": "INVOICE"
}
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Cancel a subscription to the next regular end date.
subscriptionId required | integer <int64> unique id of the subscription |
cancellationReasonUniqueId | string unique id of the cancellation reason |
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Cancel a running subscription to a given date.
subscriptionId required | integer <int64> unique id of the subscription |
cancellationReasonUniqueId | string unique id of the cancellation reason |
cancellationDate | string or null <date> date subscription should end with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 |
{- "cancellationDate": "2019-02-01"
}
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Get possible cancellation dates of a running subscription.
subscriptionId required | integer <int64> unique id of the subscription |
cancellationReasonUniqueId | string unique id of the cancellation reason |
{- "items": [
- "2019-09-01",
- "2019-10-01",
- "2019-11-01"
]
}
Undo cancellation of a subscription that is cancelled but has not reached the end of its runtime yet.
subscriptionId required | integer <int64> unique id of the subscription |
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Change payment method of a subscription.
subscriptionId required | integer <int64> unique id of the subscription |
paymentMethod required | string Enum: "AMAZON_PAY" "BANK_ACCOUNT" "BILLING" "CREDIT_CARD" "PAYPAL" payment method used to pay for the subscription |
paymentMethodId required | integer <int64> id of the payment method that is associated with this subscription |
[- {
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230
}
]
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Pause a subscription during the given time range. Only subscriptions with the same accounting period and term can be paused.
subscriptionId required | integer <int64> unique id of the subscription |
startPauseDate required | string or null <date> date subscription pause should be start with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 |
endPauseDate required | string or null <date> date subscription pause should be end with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 |
pauseType | string Enum: "PAYMENT_ONLY" "STANDARD" type of the pause |
{- "startPauseDate": "2019-02-01",
- "endPauseDate": "2019-02-21"
}
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Delete the pause of a subscription.
subscriptionId required | integer <int64> unique id of the subscription |
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Get possible pause dates of a running subscription.
subscriptionId required | integer <int64> unique id of the subscription |
{- "items": [
- "2019-09-01",
- "2019-10-01",
- "2019-11-01"
]
}
Pause a subscription delivery during the given time range.
subscriptionId required | integer <int64> unique id of the subscription |
startPauseDate required | string or null <date> date subscription pause should be start with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 |
endPauseDate required | string or null <date> date subscription pause should be end with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 |
pauseType | string Enum: "PAYMENT_ONLY" "STANDARD" type of the pause |
{- "startPauseDate": "2019-02-01",
- "endPauseDate": "2019-02-21"
}
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Delete the pause of a subscription delivery.
subscriptionId required | integer <int64> unique id of the subscription |
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Get all subscriptions that belong to a specific subscription chain that is identified by the passed chain id.
chainId required | integer <int64> unique id of the subscription chain |
{- "items": [
- {
- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptionItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
]
}
Returns additional data associated with the chain associated with the provided chain id.
chainId required | integer <int64> unique id of the subscription chain |
{- "data": {
- "myChainInfo": "newChain"
}
}
Get cross client subscription that is identified by the passed subscription id.
subscriptionId required | integer <int64> unique id of the subscription |
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Get all cross client subscriptions that belong to a specific subscription chain that is identified by the passed chain id.
chainId required | integer <int64> unique id of the subscription chain |
{- "items": [
- {
- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptionItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
]
}
Get credit wallets.
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",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
]
}
Get credit wallet by unique id.
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",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
}
Get credit wallet uploads.
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.
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"
}
]
}
{- "customerId": "string",
- "optIns": {
- "key": "EMAIL",
- "value": {
- "optInId": 0,
- "uniqueId": "string",
- "changedDate": "2019-08-24T14:15:22Z",
- "status": "NONE"
}
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Update opt-ins of a customer.
object |
{- "optIns": {
- "key": "EMAIL",
- "value": {
- "status": "NONE"
}
}
}
{- "customerId": "string",
- "optIns": {
- "key": "EMAIL",
- "value": {
- "optInId": 0,
- "uniqueId": "string",
- "changedDate": "2019-08-24T14:15:22Z",
- "status": "NONE"
}
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}