Notifications

Notifications Best Practices

Help Center

Status

Email Support

Thanx

Thanx provides a number of ways to integrate with the Thanx platform via a powerful REST API, webhooks, and SDKs.

Overview

Design

Design Best Practices

Card Enrollment

Card Enrollment Best Practices

Sign Up

Sign Up Best Practices

Loyalty & Rewards

Loyalty & Rewards Best Practices

Feedback & Support

Feedback & Support Best Practices

Legal

When you are ready for your integration to be certified, let your customer success representative know. Certification of a new integration takes 1-2 weeks to allow for adequate evaluation time. If certification fails, this timeline will begin again.

Certification

Points Integration

This section calls out some patterns in this API.

Patterns

This section describes the headers expected by the Thanx API.

Headers

Thanx suggests that you provide a signature with every request.

Request Signature

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

Errors

Create User

This endpoint will return the specified user's information.

Get User

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

Get Current User

This endpoint updates the specified user's information.

Update 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 provides a way to retrieve a signature for card encryption. The public key and certificate returned can be used with the card encryption SDK.

Get Signature

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

Delete Card

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.

Activate Reward

This endpoint marks the reward as used, transitioning reward state 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 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 presigned url where an image or file can be uploaded.

Get Upload URL

This endpoint returns a user's referral links, one for each merchant the credentials have access to.

Get Referral Links

Archive Overview

This endpoint describes the user's current loyalty statuses.

Get Loyalty Statuses

Intro

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

Get Users

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

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.

Introduction

Consumer API

Partner API

Loyalty API

Webhooks

SDKs

Notifications Best Practices