Help Center

Status

Email Support

Thanx

Overview

Consumer API

Partner API

Loyalty API

Webhooks

Data Exports

All Ordering / Loyalty integration API endpoints described below must include the following headers.

Headers

Introduction

Points Integration

Thanx sends users push notifications in a variety of situations, such as when they make a purchase or earn a reward.

Push Notifications

Deep Linking

Design

Design Best Practices

Card Enrollment

Card Enrollment Best Practices

Onboarding & Authentication

Loyalty & Rewards

Loyalty & Rewards Best Practices

Feedback & Support

Feedback & Support Best Practices

Messaging

Messaging Best Practices

This section calls out some patterns in this API.

Patterns

This section describes the headers expected by the Thanx API.

Thanx uses standard HTTP error codes to communicate the success / failure of a request.

Errors

Legal

A Consumer API integration must be certified before production credentials are made available.

Certification

Create User

This endpoint will return information for the currently logged in user.

Get User

This endpoint updates the specified user's information.

Update User

Submits a request for user account closure

Delete User

This section describes the process of authenticating with Thanx via Thanx SSO.

Single Sign-On (SSO) Overview

Legal Requirements

This endpoint triggers the passwordless login flow.

Acquire Authorization Code

Use this endpoint to acquire a user's access token.

Acquire Access Token

Use this endpoint to revoke a user's access token.

Revoke Access Token

This endpoint describes locations accessible for the provided client ID. If a merchant_id is provided the locations will be further filtered.

Get Locations

This endpoint returns the configuration for a merchant's features. If a merchant does not have a particular feature defined or enabled, the value for the associated feature key will be empty.

Get Features

This endpoint registers a new card with Thanx.

Create Card

This section describes endpoints that enable a third party to fetch and register a user's cards. This endpoint describes all registered cards for the given user.

Get Cards

This endpoint archives a registered card. The card is unenrolled from Visa/Mastercard/Amex.

Delete Card

The Thanx platform supports a number of different reward redemption types — allowing for significant flexibility in what brands can offer to their users.


Reward Overview

Get Rewards

This endpoint returns the reward corresponding to the ID in the path.

Get Reward

This endpoint activates the reward, transitioning reward state from available to active. For bonus points (also know as static rewards), this endpoint sets the reward state to used after activation (see [overview](/consumer/rewards/overview) for more information).

Activate Reward

This endpoint marks an unused reward as used, transitioning the reward state from active to used.

Finalize Reward

This endpoint grants the user a reward associated with the campaign provided.

Grant Reward

This section describes endpoints that enable a third party to fetch and update a user's tags. This endpoint describes all attribute tags for the given user.

Get Tags

This endpoint updates an attribute tag for the given user. The tag associated with the key in the request will be created or updated with the values passed in.

Update Tags

This endpoint deletes an attribute tag with the given ID.

Delete Tag

This endpoint returns a user's communication settings. The notification key reflects a user's settings for receiving push notifications in their app or via text if they don't have an app installed. The email key reflects a user's settings for receiving emails.

Get Communication Settings

This endpoint allows the update of a user's notification / email settings.

Update Communication Settings

This endpoint creates or updates a push registration record for a user's device.

Create Push Registration

This endpoint returns the points experiences for the merchant.

Get Points Experiences

This endpoint returns a single points experience specified by ID.

Get Points Experience

This endpoint returns the specified points experience balance for the given user

Get Points Balance

This endpoint returns the configured points products.

Get Points Products

This endpoint returns the configured points multipliers for the experience.

Get Points Multipliers

This endpoint exchanges the user's points for the specified points product

Exchange Points Product

This section describes endpoints that enable a third party to fetch the configuration of a merchant's tiers. This endpoint describes tier configurations for the merchants accessible via the provided credentials.

Get Tiers Configurations

This endpoint describes the user's current tier statuses.

Get Tier Statuses

Grant Tier Status

This endpoint describes the user's current feedback records.

Get Feedbacks

This endpoint returns the feedback record corresponding with the ID in the path.

Get Feedback

This endpoint will update a user's feedback record.

Update Feedback

This endpoint submits a purchase to our system for processing. Because this purchase is processed asynchronously, there is no response JSON. Please allow up to a couple minutes to receive this purchase back from the GET /purchases endpoint.

Create Purchase

This section describes endpoints that enable a third party to fetch a user's purchases. This endpoint describes all available purchases.

Get Purchases

This endpoint returns the purchase associated with the id in the path.

Get Purchase

This endpoint updates an attribute tag for the given purchase. The tag associated with the key in the request will be created or updated with the values passed in.

Update Purchase Tags

This endpoint submits a receipt for processing.

Create Receipt

This endpoint describes the receipts in Thanx.

Get Receipts

This endpoint provides a pre-signed url where an image or file can be uploaded.

Get Upload URL

Archive Overview

This endpoint describes the user's current loyalty statuses.

Get Loyalty Statuses

Returns API scopes accessible to the current credentials

Get Scopes

This endpoint will return all accessible merchants records

Get Merchants

This endpoint will return all accessible location records

Create Subscriber

This endpoint will return all the users of the specified merchant.

Get Users

This endpoint will return one particular user of the specified merchant.

Create Access Token

This endpoint submits a purchase to Thanx for processing. This allows for issuance of loyalty points to the given user.

Upsert Tags

Delete Tags

Get Feedback Records

Respond to Feedback

This endpoint returns a user's communication settings for the specified merchant. The notification key reflects a user's settings for receiving push notifications in their app or via text if they don't have an app installed. The email key reflects a user's settings for receiving emails.

Get User's Communication Settings

This endpoint allows the update of a user's notification / email settings for the specified merchant.

Update User's Communication Settings

POS Coupon Codes Integration

This endpoint allows the retrieval of a user account information, including the user's rewards.

Get Account

This endpoint is used to notify Thanx of the states that a basket is in, apply rewards to the order, and accrue loyalty progress or points for the order.

Header	Type	Required	Description
`Authorization`	string	Required unless `Reward-Redemption-Token` is supplied	All Thanx Loyalty API endpoints are protected and must be authorized via end user access tokens. These access tokens can be retrieved through an integration with Thanx SSO. The format of the header should be: `Bearer access_token`
`Content-Type`	string	Required	The only accepted value is `application/json`
`Accept`	string	Required	The Accept header specifies which version of the Thanx API that should be used. The current version is `v1` for the vendor `thanx`. This header is required for every request. The value should be `application/vnd.thanx-v1+json`. Thanx will notify you when a new API version is available.
`Merchant-Key`	string	Required	The Merchant key header identifies the merchant in Thanx. The value for this key will be provided to you by Thanx.
`User-Agent`	string	Required	eg. `{partner}/1.0.0`. This value should be set to something that indicates the name of the partner. This is useful for debugging purposes.
`Reward-Redemption-Token`	string	Required if POS coupon codes integration enabled	See details on here.

Loyalty API

Guides

Reference

Headers