Glossary

Terms are in alphabetical order.

Bearer token. The token returned by getToken and sent as Authorization: Bearer YOUR_TOKEN. It is valid for ten hours and is scoped to your publisher, not to an individual user.

Brand. A merchant that appears in the catalogue, for example a retailer. It is identified by a brand-id.

Cashback. A reward earned when a customer buys through an affiliate link. It is a share of the commission.

Gift card. A digital voucher issued through Spendstream’s supplier and sent to your customer.

Hosted payment page. A payment page provided by our payment provider, reached through a link from paymentLink, where the customer pays by card.

Offer. What a customer can earn or buy at a brand, presented in the catalogue.

Prepaid balance. Funds you hold with Spendstream, also called a float, from which gift card orders are drawn on the prepaid model.

Promotion. A publisher-specific offer for a brand, identified by a promotion-id. The promo_id you send to purchase endpoints is this identifier, not a brand identifier.

Publisher. The business that integrates Spendstream to offer rewards to its own users. Every request is scoped to one publisher.

Client commission. The commission attributable to the publisher, shown in responses as client-commission.

Transaction. A record of a purchase or reward, identified by a Spendstream transaction identifier.

User. One of your customers, identified by the UID you supply.

User reward. The reward passed on to the customer, for example cashback, site credit or free entries.

Webhook. A notification that Spendstream sends to your endpoint when something changes. Only TRANSACTION_UPDATED and USER_UPDATED are sent today.