These endpoints only work for merchants with tiers enabled. Access benefits via this set of endpoints.
This endpoint will return all benefits for a merchant under a given tier. It will return an array of benefits. Each benefit will have a type field that will identify the type of benefit.
The tier segment ID.
Your private Inveterate API key.
Returned upon successful direct action to our database. Action is immediate.
Returned upon a malformed request. Check your API key, URL parameters, and body parameters when this error is returned. Generally, if you see this error, that also means NO action was taken on our backend.
Returned for all other errors. Generally these come from our backend. Some multipart functions may execute somewhat and then fail, causing some data to be updated.
This endpoint will return one specific benefit given a benefit type and segment ID. Note that the benefit type is a string character. For a list of all benefit types, look at the default type value in each schema.
The tier segment ID.
The benefit type.
Your private Inveterate API key.
Returned upon successful direct action to our database. Action is immediate.
Returned upon a malformed request. Check your API key, URL parameters, and body parameters when this error is returned. Generally, if you see this error, that also means NO action was taken on our backend.
Returned for all other errors. Generally these come from our backend. Some multipart functions may execute somewhat and then fail, causing some data to be updated.
This endpoint will take a benefit type, segment ID, and any other values in the relevant schema and send a request to our backend to update the benefit with the new information. Keep in mind that, like with the POST method, this is a request against our backend. Thus, the effect will not be immediate.
The tier segment ID.
The benefit identification name/type.
Your private Inveterate API key.
Returned upon successful request made to our backend. Requests that return this code may take a small amount of time after successful API return to fully update.
Returned upon a malformed request. Check your API key, URL parameters, and body parameters when this error is returned. Generally, if you see this error, that also means NO action was taken on our backend.
Returned for all other errors. Generally these come from our backend. Some multipart functions may execute somewhat and then fail, causing some data to be updated.
Returns all tiers/segments for a given merchant. Merchant is pulled from the public API key for security reasons.
Whether or not to include benefits in the response.
Your private Inveterate API key.
Returned upon successful direct action to our database. Action is immediate.
Returned upon a malformed request. Check your API key, URL parameters, and body parameters when this error is returned. Generally, if you see this error, that also means NO action was taken on our backend.
Returned for all other errors. Generally these come from our backend. Some multipart functions may execute somewhat and then fail, causing some data to be updated.
Returns a single tier/segment for a given merchant. Merchant is pulled from the public API key for security reasons.
The tier segment ID.
Whether or not to include benefits in the response.
Your private Inveterate API key.
Returned upon successful direct action to our database. Action is immediate.
Returned upon a malformed request. Check your API key, URL parameters, and body parameters when this error is returned. Generally, if you see this error, that also means NO action was taken on our backend.
Returned for all other errors. Generally these come from our backend. Some multipart functions may execute somewhat and then fail, causing some data to be updated.
Returns all campaigns belonging to a specific Tier identified by its segmentId
The tier segment ID.
Your private Inveterate API key.
Returned upon successful direct action to our database. Action is immediate.
Returned upon a malformed request. Check your API key, URL parameters, and body parameters when this error is returned. Generally, if you see this error, that also means NO action was taken on our backend.
Returned for all other errors. Generally these come from our backend. Some multipart functions may execute somewhat and then fail, causing some data to be updated.
{
"message": "text",
"data": {}
}GET /v2.0/admin/tiers/{id}/benefits HTTP/1.1
Host:
X-Inveterate-Api-Key: text
Accept: */*
{
"message": "text",
"data": {}
}GET /v2.0/admin/tiers/{id}/benefits/{type} HTTP/1.1
Host:
X-Inveterate-Api-Key: text
Accept: */*
{
"message": "text",
"data": {}
}PATCH /v2.0/admin/tiers/{id}/benefits/{type} HTTP/1.1
Host:
X-Inveterate-Api-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 92
{
"creditAmount": 1,
"name": "text",
"days": 1,
"description": "text",
"type": "SIGNUP_STORE_CREDITS"
}GET /v2.0/admin/tiers HTTP/1.1
Host:
X-Inveterate-Api-Key: text
Accept: */*
{
"message": "text",
"data": {}
}GET /v2.0/admin/tiers/{id} HTTP/1.1
Host:
X-Inveterate-Api-Key: text
Accept: */*
{
"message": "text",
"data": {}
}GET /v2.0/admin/tiers/{id}/campaigns HTTP/1.1
Host:
X-Inveterate-Api-Key: text
Accept: */*
{
"message": "text",
"data": {}
}