Obtaining API Keys
Please contact us at [email protected] to obtain your API keys to access the Seamless Rewards API.
Authorization
All Seamless Rewards API calls require an access token which is obtained by making an Authorization call. The Access Token may then subsequently be used for other calls.
Merchant/Offer Database
The first step in using the SR API is retrieve/update the list of merchants and offers.
The intent is for CLO parters to pull content from the SR API and merge into their own offer databases. The SR API can then be used to synchronise updates on a regular basis. This will be based on a regular poll of the SR API that my be conducted minute by minute or on an hourly or daily or even weekly basis. The frequency is the choice of to the CLO partner, but we recommend at least daily.
The SR API is not suitable for consumption directly by end users and as such may be restricted to whitelisted IP addresses only.
Transaction Logging
Seamless Rewards will collect the funds required from merchants to fulfil the offer presented. The CLO partner is therefore required to log all matched transactions via the SR API. This may be done in real time on a transaction by transaction basis, or in batches either hourly, daily or even weekly.
It is our responsibility as Seamless Rewards to ensure merchants do not get billed twice for the same transaction and for that reason the first CLO partner to report a specific transaction will receive a confirmation and subsequent payment of the offer amount, while duplicate transactions from other partners will be rejected. It would therefore be more favourable for the CLO partner to submit transactions as soon as possible, ideally in real time.
Payments and Reports
Transactions received are batched on a regular basis for the purpose of billing merchants. Transaction status reports are available through the SR API as well as a payment report. On a regular (monthly) basis transactions that were validated/accepted by SR will be paid as a batch payment to the CLO partner and a report detailing the transactions related the payment will be available via API as well as the Seamless Rewards CLO Partner Portal.