Conversion rejection
The conversion rejection endpoint lets advertisers send a server-to-server request to Integr8 to reject a conversion that was previously approved, or to update the rejection reason on an already-rejected conversion. Use it when fraudulent or invalid conversions are detected after the initial attribution.
Endpoint format
Section titled “Endpoint format”https://INTEGRATION_DOMAIN/?new_rejected_reason=REASON&transaction_id=TRANSACTION_IDParameters
Section titled “Parameters”| Parameter | Required | Description |
|---|---|---|
transaction_id |
Yes | The unique ID of the conversion to reject |
new_rejected_reason |
Yes | The rejection reason code, for example fraud, chargeback, or duplicate |
Behavior
Section titled “Behavior”| Conversion state | Result |
|---|---|
| Approved | Status changes to Rejected with the supplied reason. |
| Already Rejected | Rejection reason is updated to the new value. |
transaction_id not found |
No action taken, no error returned. |
Get the endpoint URL
Section titled “Get the endpoint URL”Offer-level rejection URL is tied to a single offer:
- Go to Offers > Offers Management and open a specific offer.
- On the General tab, scroll down then expand the Conversion Tracking dropdown card.
- Open the Rejection tab inside the card.
- Copy the URL and share it with the advertiser.
Global rejection URL works for every offer in the account:
- Go to Offers > Global Tracking.
- Open the Rejection tab.
- Copy the URL and share it with the advertiser.
NOTE: The global URL is the better default for advertisers running multiple offers; one URL handles rejections across every offer without generating separate URLs.
Security
Section titled “Security”- Share the rejection endpoint only with trusted advertisers.
- All requests must use HTTPS.
- Watch postback logs for unexpected rejection patterns.
- There is no undo for status changes made via this endpoint. Confirm the integration is correct before sharing the URL.
Related
Section titled “Related”- Affiliate postback setup to forward rejection events to publishers.
- Conversion tracking for the original conversion ingestion path.