v1
latestOpenAPI 3.0.32026-07-243003151.2 MBProduct Exchange
This API endpoint allows the exchange of one or more products for another set of products. The basket request attribute includes both the product(s) being returned salesKey=REFUND and the new product(s) being purchased salesKey=SALE. The basket will then be readjudicated based on the offers that were available in the original transaction, against the new items in the basket, and any points rewards will be adjusted accordingly.
Headers
This request HTTP header advertises which content encoding (usually a compression algorithm) the calling application is able to understand. The server selects one of the proposals, use it and informs the client of its choice with the Content-Encoding Response header. Currently supported gzip and deflate. Please note if this request header is not present, no compression will be used.
This general HTTP header controls (or rather influences) whether the network connection stays open after the current request finishes. If the sent value is keep-alive, the connection should stay in a special state, allowing to be reused for subsequent requests to the same server. Please note these connections will be closed after reaching timeout threshold controlled by EES server (usually after 5 seconds).
Standard HTTP header to inform EES API what type of content was passed in request payload
Client ID, This will be provided by EES and is unique to the company calling the API.
Request Security Hash, calculated using SHA-256 function from concatenated full Request URI Path with Query String(s), Payload and Client Secret
Unique Reference for the API transaction within the calling company.
Optional header provided by the calling application for EES AIR to identify what was the external Subsystem Id / Name.
Optional header(s) provided by the calling application to EES AIR. Please note this header name has to follow pattern X-CUSTOM-*
Optional HTTP header, if present, it will instruct EES AIR to override the real HTTP Method, used during this connection. This is due to some networking or software limitations on Client side, allowing the calling application to perform only GET or POST calls.
The ability to specify the date and time that should be used to adjudicate. This can be used to create transactions for past events, whilst ensuring the consumer receives the rewards that they were eligible for at that time. This functionality is only available for events less than 6 months in the past. Please note requested transaction date-time has to use ATOM Date-Time format Y-m-d\TH:i:sP, (e.g. 2017-12-31T23:59:59+09:00).
Request body
Response
EES AIR has successfully processed a Request