If you’d like to receive callbacks beyond the default Success conversions, you can enable optional callbacks for Pending and Rejected statuses. See the Conversion Status Definitions page for more details here.
Pending Conversion Callbacks
When enabled, GoKart will send a callback as soon as a conversion enters a Pending state`.
Useful when:
You have configured a Pending Time and want visibility into the conversion before it becomes
SuccessYou want to display a “Pending Reward” state inside your app or dashboard
Best Practice:
Do not reward users based on Pending callbacks.
Rewards should only be issued once the conversion reaches Success.
Rejected Conversion Callbacks
When enabled, GoKart will send a callback whenever a conversion is marked Rejected (invalid, duplicate, failed validation, did not meet requirements, etc.).
This callback indicates:
The user should not be rewarded and their conversion did not meet requirements
If the user was previously rewarded for a successful conversion, and the conversion is later invalidated, you may need to revoke or adjust the reward
Helpful for:
Fraud and quality monitoring
Reversing rewards for conversions later rejected
Keeping your internal records aligned with GoKart’s final outcome
Conversion Status Update Callback Integration
GoKart may send additional callbacks when the status of an existing conversion changes. Typical transitions include:
Pending→SuccessSuccess→RejectedPending→Rejected
How It Works
Each time the status of a conversion is updated, GoKart sends a callback with the updated
Statusfield.All status update callbacks reuse the original
conversionId
GoKart does not create a new conversion record when a status changes.
What Your System Should Do
Look up the existing conversion using the
conversionIdUpdate your internal conversion and reward status accordingly
Do not treat the update as a new conversion
Revoke or adjust rewards when applicable. (GoKart does not perform reversals on your behalf.)
Example Flow
Initial callback
conversionId = 123,status = PendingStatus update
conversionId = 123,status = Success
→ Reward the userLater status update
conversionId = 123,status = Rejected
→ Revoke or adjust the user’s reward