Campaign Feedback Service

Service which processes requests for ClickToLoad events

Endpoints

Load a Pending Reward (Encoded)

POST campaignfeedback/loadPendingEventReward.json

Load a pending reward into a guest account.

The following authentication methods are allowed for this endpoint:

JSON Parameters:
 
  • merchantId (Integer) – (required) Paytronix-assigned merchant ID to perform the operation in.
  • code (String) – (required) Base64 encoded string of name/value pairs that indicates merchantId, printed card number and event ID.
"result": "success"
JSON Parameters:
 
  • result (String) – (required) success
  • printedCardNumber (String) – (required) The primary printed card number of the account checked in.
  • adjustmentInformation (List[Object]) – (required) Information of reward that was loaded during this request. See AdjustmentInformation for format of the object.
"result": "failure"
JSON Parameters:
 
  • result (String) – (required) failure
  • errorCode (String) – (required) The error code of the failure.
  • errorMessage (String) – (required) The (human readable) error message of the failure.
  • printedCardNumber (String) – (required) If present, it indicates that the was able to extract a printed card number from the request.

Load a Pending Reward (Encrypted)

POST campaignfeedback/loadRewardForEvent.json

Load a pending reward into a guest account.

The following authentication methods are allowed for this endpoint:

JSON Parameters:
 
  • merchantId (Integer) – (required) Paytronix-assigned merchant ID to perform the operation in.
  • code (String) – (required) Encrypted base64 encoded string of name/value pairs that indicates merchantId, printed card number and event ID.
"result": "success"
JSON Parameters:
 
  • result (String) – (required) success
  • printedCardNumber (String) – (required) The primary printed card number of the account checked in.
  • adjustmentInformation (Object) – (required) Information of reward that was loaded during this request. See [[#AdjustmentInformation]] for format of the object.
"result": "failure"
JSON Parameters:
 
  • result (String) – (required) failure
  • errorCode (String) – (required) The error code of the failure.
  • errorMessage (String) – (required) The (human readable) error message of the failure.
  • printedCardNumber (String) – (required) If present, it indicates that the was able to extract a printed card number from the request.

Load a Pending Reward

POST campaignfeedback/loadRewardForPrintedCardNumber.json

Load a pending reward into a guest account.

The following authentication methods are allowed for this endpoint:

JSON Parameters:
 
  • merchantId (Integer) – (required) Paytronix-assigned merchant ID to perform the operation in.
  • printedCardNumber (String) – (required) The printed card number whose reward will be loaded.
  • eventCode (String) – (required) event ID.
"result": "success"
JSON Parameters:
 
  • result (String) – (required) success
  • printedCardNumber (String) – (required) The primary printed card number of the account checked in.
  • adjustmentInformation (Object) – (required) Information of reward that was loaded during this request. See [[#AdjustmentInformation]] for format of the object.
"result": "failure"
JSON Parameters:
 
  • result (String) – (required) failure
  • errorCode (String) – (required) The error code of the failure.
  • errorMessage (String) – (required) The (human readable) error message of the failure.
  • printedCardNumber (String) – (required) If present, it indicates that the was able to extract a printed card number from the request.

Reply Objects

AdjustmentInformation
JSON Parameters:
 
  • walletCode (Int) – (required) Wallet code of loaded reward.
  • name (String) – (required) Name of loaded reward.
  • amount (Decimal) – (required) Loaded amount.
  • expiration (Date) – (optional) The date that the reward will expire.
  • singularName (String) – (optional) Singular version of the reward name.
  • pluralName (String) – (optional) Plural version of the reward name.
  • tinyName (String) – (optional) Tiny version of reward name.
  • shortName (String) – (optional) Short version of reward name.
  • longName (String) – (optional) Long version of reward name.

Error Codes

The caller of the endpoint can use the returned message to display to the end user or, if different wording is desired, can provide their own mapping of code to message.

Code Message
event_reward.system_error System error
event_reward.invalid_code Invalid code
event_reward.invalid_merchant Invalid merchant
event_reward.invalid_card Invalid card
event_reward.invalid_account Invalid account
event_reward.invalid_user Invalid user
event_reward.invalid_event Invalid event
event_reward.invalid_wallet_spec Invalid wallet specification
event_reward.invalid_store Invalid store
event_reward.account_not_active Account not active
event_reward.card_not_active Card not active
event_reward.account_not_in_event Account not associated to event
event_reward.reward_already_loaded Reward already loaded
event_reward.transaction_denied Unable to load reward