EAeagleeye
Reward Bank

Create a Reward Bank with Rewards

This API endpoint allows the calling application to create a Reward Bank with Rewards

post/banks/pointsreward

Request

  • Base URL
    https://resources.uk.eagleeye.com
  • URL
    https://resources.uk.eagleeye.com/banks/pointsreward
  • Auth
    none declared. Required headers: X-EES-AUTH-CLIENT-ID, X-EES-AUTH-HASH

Headers

X-EES-AUTH-CLIENT-IDstring string required

Client ID, This will be provided by EES and is unique to the company calling the API.

X-EES-AUTH-HASHstring string required

Request Security Hash, calculated using SHA-256 function from concatenated full Request URI Path with Query String(s), Payload and Client Secret.

X-EES-TRANSACTION-IDstring string

Unique Reference for the API transaction within the calling company.

X-CUSTOM-SUBSYSTEM-IDstring string

Optional header provided by the calling application for EES AIR to identify what was the external Subsystem Id / Name. Please note this header is not essential for AIR to process a Request, this header and its value will be intercepted by AIR and will show up in Wallet Event Notifications, if applicable.

X-CUSTOM-KEYstring string

Optional header(s) provided by the calling application to EES AIR. Please note a) this header name has to follow pattern X-CUSTOM-* (i.e. X-CUSTOM-EMAIL) b) this header is not essential for AIR to process a Request, this header and its value will be intercepted by AIR and will show up in Wallet Event Notifications, if applicable.

Request body

nameName required(unresolved $ref)
referenceReference (unresolved $ref)
modeMode required(unresolved $ref)
statusStatus required(unresolved $ref)
exchangeLimitExchangeLimit (unresolved $ref)

Response

EES AIR has successfully processed a Request

pointsRewardBankIdstring string required

EES AIR Points Exchange Bank ID

status'ACTIVE' | 'INACTIVE' | 'SUSPENDED' string required

Points Exchange Bank Status

mode'PUBLIC' | 'PERSONAL' string required

Bank's mode: PERSONAL - only nominated Consumers can see and exchange rewards from this Bank, (nominee list could change while running a Scheme and/or Reward Bank); PUBLIC - all Consumers could see and exchange rewards using this Reward Bank)

namestring string required

Bank Name

referencestring string required

Points Exchange Bank External Reference

dateCreatedstring ees-datetime required

Points Exchange Bank Created Date-time (ATOM format)

lastUpdatedstring ees-datetime required

Points Exchange Bank Last updated Date-time (ATOM format)

exchangeLimitinteger nullable required

Number of times a Wallet or Wallet Link can exchange rewards from this Bank

Example response

{
  "pointsRewardBankId": "1172",
  "status": "ACTIVE",
  "mode": "PUBLIC",
  "reference": "000001185",
  "name": "My Points Exchange Bank",
  "dateCreated": "2019-07-02T13:54:43+00:00",
  "lastUpdated": "2020-03-09T13:20:17+00:00",
  "exchangeLimit": 2
}

Changes

No recorded changes to this operation across all 1 revision of this API.