Security - S2S Postbacks

For a more secure option, you can provide a S2S URL for completes and reconciliations/reversals.


Completes Callback

The callback will fire only when a respondent completes the survey. The Parameters appended to the callback depend on those you select in the entry link or as optional parameters to included for completed surveys

Note that we use the POST method when sending the Complete S2S callback

Information Returned

The URL will pass back the following info:

  • Session ID

  • Member ID

  • CPI Value

  • Survey ID (if selected)

  • Survey LOI (if selected)

Example URL

https://company.com/purespectrum/s2s?&transactionId=[SupplierSessionID]&memberId=[SupplierMemberID]&cpi=1.00&survey_LOI=10&surveyID=12345678&asr_s_hash=123abc456def91011xyz

The CPI value can only be returned for completes when using a S2S callback, and will not be appended in the completes redirect link

If you’ve added a Hashkey, this will return appended as “&asr_s_hash=”
Security and hashing will be covered in the next section of the documentation.

Reconciliation/Reversal Callback

In order to be notified once a buyer has reconciled one of your respondent’s transactions, you will need to enter postbacks for those use cases. You can define a Postback URL for the following 2 scenarios:

  • A user status gets changed from a complete to a non complete 

  • A user status gets changed from a non complete to a complete 

Note that we use the GET method when sending the Reconciliation S2S callbacks

Information Returned

The URL will pass back the following info:

  • The CPI value

  • Session ID

  • Old status

  • New Status

Example URL

http://test.com/completetononcomplete?ps_rstatus=33&oldStatus=21&supSid=12345678&supCpi=1.20&ps_s_hash=123abc456def91011xyz

 

For more information on Hashing and Security, please click the following link:

Security - IP Whitelisting