| Warning |
|---|
The documentation is hidden from external users. |
An external system may update a transaction in PureSpectrum for a number of reasons such as:
...
Required Parameters must be present in the query string:
Status - st
Optional Parameters
QLC Codes - quota_id
Transaction can be changed only if is on these 3 states:
Buyer side in progress
Buyer drop
PS LOI threshold
API Parameters:
Request Parameter | Type | Description | Example |
|---|---|---|---|
st | integer - enum (17, 18, 20, 21, 30) | This is the PureSpectrum status code. Pass in the appropriate code corresponding to your desired status. 17 - OverQuota 18 - Termination 20 - Quality Termination 21 - Complete 30 - Dedupe | st=21 |
quota_id | string - comma separated values | This is the identifier of the quotas for which the respondent has qualified for. | abc123 |
Sample Request:
| Code Block | ||
|---|---|---|
| ||
POST /buyers/v2/surveys/:surveyId/transactions/transaction_id/status?st=21"a_id=1,2,3 |
Response:
Response Code:
200
Response Body:
| Code Block |
|---|
[] |
Other examples:
Once the survey respondent status is passed as “complete” through /surveydone endpoint, it is the final status of that transaction id. If tried to update the transaction using /status endpoint again, then it will throw the error as shown in below example -
Response Code:
400
...
Response Body:
| Code Block | ||
|---|---|---|
| ||
{ { "ps_error_code": 10011003, "ps_error_message":"Incorrect "This transaction id already has a final status code" }, |
Postman example:
...
Other Error Messages:
| Code Block | ||
|---|---|---|
| ||
{
"ps_error_code": 10021001,
"ps_error_message":"InsufficientIncorrect parameters - please check your requeststatus code"
},
{
"ps_error_code": 10031002,
"ps_error_message":"ThisInsufficient transactionparameters id- alreadyplease hascheck ayour final statusrequest"
},
{
"ps_error_code": 1004,
"ps_error_message":"Transaction ID Not found. Please check the survey id and transaction ID and try again."
},
{
"ps_error_code": 1005,
"ps_error_message":"Invalid or missing QLC codes"
} |
...