Promotion Validation Framework

UBIO validates promotions by checking whether the system can reach a conclusion, then whether the promotion delivers the advertised benefit.

A successful validation does not necessarily mean a valid promotion. A validation is successful when UBIO can determine whether the promotion is VALID or INVALID. Only attempts that cannot reach a conclusion are classified as COULD NOT VALIDATE.

Decision Tree

Valid Error Codes

VALID results can include an error code when UBIO can confirm the promotion or promo code is valid, but the supplied data needs correction. For example, the link, product, or predicted applicability context may not match where the promotion actually works. These codes do not make the result invalid.

Error Code	Meaning
VALID_WITH_CORRECTIONS	Promotion or promo code is valid, but the supplied link, product, or applicability data needs correction.

Invalid Reasons

Category	Meaning	Example codes
Merchant / Promotion Issue	Validation succeeded, but the offer did not work.	PROMO_CODE_IS_NOT_WORKING PROMO_CODE_NOT_APPLICABLE_TO_THIS_PRODUCT DISCOUNT_IS_NOT_APPLIED

Could Not Validate Reasons

Category	Meaning	Example codes
Website Issue	Merchant site prevented validation.	WEBSITE_LOADING_ISSUE BOT_DETECTION ACCOUNT_BLOCKED PRODUCT_OUT_OF_STOCK
Automation / Infrastructure Issue	UBIO validation system could not complete the run.	AGENT_ERROR PROXY_CONNECTION_ISSUE NETWORK_UNREACHABLE

A validation is successful when UBIO can reach a conclusion.
Both VALID and INVALID are successful validations.
COULD NOT VALIDATE means no conclusion could be reached.

Framework Hierarchy

Most non-VALID outcomes follow this hierarchy:

Validation Result → Error Category → Error Code

Level	Purpose
Validation Result	The top-level outcome: VALID, INVALID, or COULD NOT VALIDATE.
Error Category	The grouped reason for an INVALID or COULD NOT VALIDATE result.
Error Code	The specific machine-readable code for the result.

VALID validation results can have error codes. They do not have error categories.

Result Summary

Validation Result	Meaning	Category
VALID	Validation reached a conclusion and the promotion or promo code is valid.	None
INVALID	Validation reached a conclusion and the promotion did not work.	Merchant / Promotion Issue
COULD NOT VALIDATE	Validation could not reach a conclusion.	Website Issue or Automation / Infrastructure Issue