Create

This API endpoint allows the calling application to create a new AIR Account

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

JSON Payload

string

EES AIR Wallet ID for which an Account will be created. Please note: this attribute is mandatory for EES AIR Wallet Clients

string
enum
required

EES AIR Resource Type

Allowed:
string
required

EES AIR Resource ID (Campaign ID, Programme ID, Scheme ID, Plan ID, etc.)

string
enum

EES AIR Account Status (Please note: enum below is different compared to all available Account Statuses)

Allowed:
string | null

Client specific Account State (available items will be agreed during Client onboarding if applicable)

meta
object

Key-Value object, please note key name length should be less then 255 characters and key values should be less then 255 characters

transactionDetails
object

Key-Value object, please note key name length should be less then 255 characters and key values should be less then 255 characters

dates
object
int32

Account Initial Balance; if applicable for an Account Type

balances
object

The object of balances. Some balances only apply to certain types of accounts. See notes below on balances.

location
object
overrides
consumer
object
delivery
object

Delivery details for Token based accounts (Coupon and Stored Value). If defined AIR will try to deliver EMAIL or SMS delivery notification to requested end-Client.

boolean

Optional flag for Token accounts to create a barcode image for the generated Token.

string

Optional token value to be assigned to a new token account if the campaign is configured to allow it.

Headers
string
enum
Defaults to ''

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.

Allowed:
string
enum
Defaults to close

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).

Allowed:
string
Defaults to application/json

Standard HTTP header to inform EES API what type of content was passed in request payload

string
required

Client ID, provided by EES during on-boarding. Please note: the authentication mechanic requires the receipt of the full payload so any headers that would chunk the request up, such as transfer-encoding: chunked could potentially cause authentication failures.

string
required

Request Authentication Hash, calculated by concatenating Request URI Path with API prefix, Request Query String(s) if applicable, Request Payload if applicable and Client Secret. Please note: the authentication mechanic requires the receipt of the full payload so any headers that would chunk the request up, such as transfer-encoding: chunked could potentially cause authentication failures.

string

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).

string

Optional Unique Reference for the API Request (Transaction) within the calling company

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.

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.

Responses

Language
Credentials
LoadingLoading…
Response
Choose an example:
application/json