Reward Points Management

Retrieving reward points of all customers

get

Retrieves a detailed summary of added and redeemed reward points for all customers of a given tenant. The tenant name is selected based on the access token.

Note: Only employees are authorized to perform this action.

Required scopes

This endpoint requires the following scopes:

• : Nedeed to view reward points information

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Responses

200Success

application/json

401Error

application/json

403

Given authorization scopes are not sufficient and do not match required scopes.

application/json

500

Internal error

application/json

get

/reward-points/summaryBatch

HTTPcURLJavaScriptPython

GET /reward-points/summaryBatch HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "customerId": "20242913",
    "activePoints": 2000,
    "summary": {
      "addedPointsList": [
        {
          "id": "1c32ce73-8765-42a7-92af-ff370a0a59d6",
          "reference-id": "<string>",
          "description": "<string>",
          "points": 2000,
          "createdAt": "2023-05-11T18:32:18.591+00:00",
          "allPointsAfterCreation": 2000,
          "usedPoints": 140,
          "validUntil": "2023-11-11T12:00:50.406+00:00",
          "usedWith": [
            "d85c0570-1d51-4611-bf2f-c67452384626",
            "b5085a36-a5f0-450d-a011-9f92902f3900"
          ]
        },
        {
          "id": "b9919f33-3a0b-4fd7-acdb-217edd4fc110",
          "reference-id": null,
          "description": "Chargeback - redeemed voucher could not be created.",
          "points": 50,
          "createdAt": "2023-05-11T18:32:38.564+00:00",
          "allPointsAfterCreation": 2000,
          "usedPoints": 0,
          "validUntil": "2026-05-11T18:32:38.564+00:00",
          "usedWith": []
        },
        {
          "id": "42cd0799-9965-4983-8548-e7ad79160572",
          "reference-id": null,
          "description": "Chargeback - redeemed voucher could not be created.",
          "points": 90,
          "createdAt": "2023-05-11T18:32:50.981+00:00",
          "allPointsAfterCreation": 2000,
          "usedPoints": 0,
          "validUntil": "2026-05-11T18:32:50.981+00:00",
          "usedWith": []
        }
      ],
      "redeemedPointsList": [
        {
          "id": "d85c0570-1d51-4611-bf2f-c67452384626",
          "description": "test desc",
          "points": 50,
          "createdAt": "2023-05-11T18:32:38.501+00:00",
          "allPointsAfterCreation": 1950
        },
        {
          "id": "b5085a36-a5f0-450d-a011-9f92902f3900",
          "description": "For 90 points you can have a voucher for 10 euros generated. You can also pass this voucher on to friends and acquaintances.",
          "points": 90,
          "createdAt": "2023-05-11T18:32:50.946+00:00",
          "allPointsAfterCreation": 1910
        }
      ]
    }
  }
]

Retrieving reward points of a customer

get

Fetches the number of reward points for a particular customer of a given tenant. The tenant name is retrieved from the access token.

Note: Only employees are authorized to perform this action.

Required scopes

This endpoint requires the following scopes:

• : Nedeed to view reward points information

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

customerIdstringRequired

Unique identifier of a customer, generated when the customer is created through the Customer Service.

Responses

200Success

application/json

Responseinteger

400

Request syntactically incorrect. Details of the error are included in the response payload.

application/json

403

Given authorization scopes are not sufficient and do not match required scopes.

application/json

500

Internal error

application/json

get

/reward-points/customer/{customerId}

HTTPcURLJavaScriptPython

GET /reward-points/customer/{customerId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

2000

Creating a new reward points entry for a customer

post

Creates a new reward points entry for a particular customer of a given tenant. The tenant name is retrieved from the access token.

Required scopes

This endpoint requires the following scopes:

• : Needed to manage reward points

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

customerIdstringRequired

Unique identifier of a customer, generated when the customer is created through the Customer Service.

Query parameters

siteCodestringOptional

Site code, defined when a site is created.

Default: main

Body

application/json

customerIdstringOptional

Responses

200Success

No content

400

Request syntactically incorrect. Details of the error are included in the response payload.

application/json

401Error

application/json

403

Given authorization scopes are not sufficient and do not match required scopes.

application/json

409Error

application/json

500

Internal error

application/json

post

/reward-points/customer/{customerId}

HTTPcURLJavaScriptPython

POST /reward-points/customer/{customerId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 319

{
  "customerId": "C4289081720",
  "startPoints": {
    "id": "12345fee-0b83-48aa-95dc-11e3dcf84aaa",
    "reference-id": "123456",
    "description": "points added",
    "points": 20,
    "createdAt": "2019-08-24T14:15:22Z",
    "allPointsAfterCreation": 20,
    "usedPoints": 5,
    "validUntil": "2019-08-24T14:15:22Z",
    "usedWith": [
      "5237bcac-c548-4e49-8626-03dab65376d6"
    ]
  }
}

No content

Deleting reward points of a customer

delete

Deletes a reward points entry of a specified customer for a given tenant. The tenant name is retrieved from the access token.

Required scopes

This endpoint requires the following scopes:

• : Needed to manage reward points

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

customerIdstringRequired

Unique identifier of a customer, generated when the customer is created through the Customer Service.

Responses

200Success

No content

401Error

application/json

403

Given authorization scopes are not sufficient and do not match required scopes.

application/json

500

Internal error

application/json

delete

/reward-points/customer/{customerId}

HTTPcURLJavaScriptPython

DELETE /reward-points/customer/{customerId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Retrieving a reward points summary for a single customer

get

Retrieves a detailed summary of added and redeemed reward points of a single specified customer for a given tenant. The tenant name is retrieved from the access token.

Note: Only employees are authorized to perform this action.

Required scopes

This endpoint requires the following scopes:

• : Nedeed to view reward points information

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

customerIdstringRequired

Unique identifier of a customer, generated when the customer is created through the Customer Service.

Responses

200Success

application/json

401Error

application/json

403

Given authorization scopes are not sufficient and do not match required scopes.

application/json

404

Entity not found.

application/json

500

Internal error

application/json

get

/reward-points/customer/{customerId}/summary

HTTPcURLJavaScriptPython

GET /reward-points/customer/{customerId}/summary HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "customerId": "123",
  "activePoints": 1153,
  "summary": {
    "addedPointsList": [
      {
        "id": "zzpscd12uimlmybtthb",
        "reference-id": "B7011746",
        "description": "Bonuspunkte für Bestellung B7011746",
        "points": 209,
        "createdAt": "2020-09-03T09:45:02.248+00:00",
        "allPointsAfterCreation": 209,
        "usedPoints": 209,
        "validUntil": "2023-09-02T22:00:00.000+00:00",
        "usedWith": [
          "e7522b99-2448-44b5-8f68-8bffcc207d18"
        ]
      },
      {
        "id": "c9joe623gl4obochkrmy8i",
        "reference-id": "B7011745",
        "description": "Bonuspunkte für Bestellung B7011745",
        "points": 209,
        "createdAt": "2020-09-03T09:45:02.318+00:00",
        "allPointsAfterCreation": 418,
        "usedPoints": 209,
        "validUntil": "2023-09-02T22:00:00.000+00:00",
        "usedWith": [
          "e7522b99-2448-44b5-8f68-8bffcc207d18"
        ]
      }
    ],
    "redeemedPointsList": [
      {
        "id": "e7522b99-2448-44b5-8f68-8bffcc207d18",
        "description": "Für 600 Punkte können Sie sich einen Gutschein über 5 Euro generieren lassen. Diesen Gutschein können Sie auch an Freunde und Bekannte weitergeben.",
        "points": 600,
        "createdAt": "2020-09-03T12:44:22.747+00:00",
        "allPointsAfterCreation": 2953
      }
    ]
  }
}

Adding reward points for a customer

post

Adds reward points to a specific customer's account for a given tenant. The tenant name is retrieved from the access token.

Note: Only employees are authorized to perform this action.

Required scopes

This endpoint requires the following scopes:

• : Needed to manage reward points

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

customerIdstringRequired

Unique identifier of a customer, generated when the customer is created through the Customer Service.

Query parameters

siteCodestringOptional

Site code, defined when a site is created.

Default: main

Body

application/json

idstringOptional

reference-idstring · nullableOptional

Order Id for which the points were created

descriptionstringOptional

Auto-generated description

pointsintegerRequired

Number of points added in the operation

createdAtstring · date-timeOptional

validUntilstring · date-timeOptional

The date until when the points can be redeemed

allPointsAfterCreationintegerOptional

Number of points after creation

usedPointsintegerOptional

Number of points already used

usedWithstring[]Optional

Responses

201Success

400

Request syntactically incorrect. Details of the error are included in the response payload.

application/json

401Error

application/json

403

Given authorization scopes are not sufficient and do not match required scopes.

application/json

500

Internal error

application/json

post

/reward-points/customer/{customerId}/addPoints

HTTPcURLJavaScriptPython

POST /reward-points/customer/{customerId}/addPoints HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 280

{
  "id": "12345fee-0b83-48aa-95dc-11e3dcf84aaa",
  "reference-id": "123456",
  "description": "points added",
  "points": 123,
  "createdAt": "2023-10-24T14:15:22Z",
  "allPointsAfterCreation": 56778,
  "usedPoints": 5,
  "validUntil": "2029-08-24T14:15:22Z",
  "usedWith": [
    "5237bcac-c548-4e49-8626-03dab65376d6"
  ]
}

No content

Redeeming reward points of a customer

post

Redeems reward points for a specified customer for a given tenant without generating a coupon. The tenant name is retrieved from the access token.

Note: Only employees are authorized to perform this action.

Required scopes

This endpoint requires the following scopes:

• : Needed to manage reward points

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

customerIdstringRequired

Unique identifier of a customer

Body

application/json

idstringOptional

Identifier of the redeemed points

descriptionstringOptional

A comment for the redeem operation

pointsintegerRequired

The amount of the redeemed points

createdAtstring · date-timeOptional

Timestamp when the points were redeemed

allPointsAfterCreationintegerOptional

Number of points after creation

Responses

201Success

400

Request syntactically incorrect. Details of the error are included in the response payload.

application/json

401Error

application/json

403

Given authorization scopes are not sufficient and do not match required scopes.

application/json

500

Internal error

application/json

post

/reward-points/customer/{customerId}/redeemPoints

HTTPcURLJavaScriptPython

POST /reward-points/customer/{customerId}/redeemPoints HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "description": "points redeemed",
  "points": 50
}

No content