Error Codes

The Purchase Validation API always responds with HTTP status 200. When an error occurs, the response body contains an error_code field and a message field instead of a valid response payload. Check for the presence of error_code in every response before processing the result.

Error Code Reference

Code	Message	Description	Guidance
Err00	Unexpected error	An unclassified internal error occurred.	Retry the request. If the error persists, contact BlinkReceipt support with the request payload.
Err01	Missing license_key parameter	The license_key field was not included in the request.	Add your license_key to the request body.
Err02	Invalid license_key	The provided license_key is not recognized or has been revoked.	Verify the key value in your BlinkReceipt account.
Err03	Missing required parameter	One or more required fields are absent from the request.	Ensure license_key, purchased_date (form) or products (JSON), and at least one product with product_description and unit_price are present.
Err04	Product Intelligence Failure!	The product intelligence subsystem encountered an internal error while processing the submitted products.	Retry the request. If the error is consistent for a specific product, verify that product_description and unit_price are well-formed.
Err05	PVP error	The promotion validation subsystem encountered an internal error.	Retry the request. If the error is consistent, verify that promo_slugs values are valid slugs configured for your account.
Err06	Duplicate Detection Failure!	The duplicate detection subsystem encountered an internal error.	Retry the request. If the error persists, contact BlinkReceipt support.

Error Response Shape

All error responses follow the same structure:

{
  "error_code": "Err01",
  "message": "Missing license_key parameter"
}

Err02 additionally includes an error field with more detail:

{
  "error_code": "Err02",
  "message": "Invalid license_key",
  "error": "license_key invalid"
}

Handling Errors

A defensive client should always inspect the response body before processing it:

{
  "error_code": "Err03",
  "message": "Missing required parameter"
}

If error_code is present, surface the message to your logging pipeline and do not attempt to read products, qualifiedPromotions, or any other success-only fields from the response.