The Conversion Callback is how GoKart notifies your system whenever a conversion is tracked.
This involves configuring your API to handle requests from GoKart, notifying you about the conversion details for each user.
Your system should only reward users after successfully receiving this callback from GoKart.
How It Works
When a user completes an offer, GoKart sends a POST request to your configured Conversion Callback URL
This request contains the core conversion fields used to:
Identify the user
Identify the offer
Determine reward amounts
Log the event in your system
Your API consumes this request, applies your business logic, and rewards (or updates) the user accordingly
Add Conversion Callback URL in your Account Settings:
Log in to your GoKart account.
Navigate to your Profile.
In the Callback tab, add the URL of your API endpoint where GoKart will send the conversion notifications.
Configure Your API Endpoint:
Ensure that your API endpoint is prepared to handle POST requests from GoKart.
This endpoint should be capable of processing the conversion data and rewarding the user accordingly.
GoKart supports only one Conversion Callback URL per account.
All conversion events (including multi-event offers and optional status updates) are sent to this single endpoint.
Multiple callback URLs are currently not supported.
If you need to route conversions differently (e.g., across multiple sites or environments), this must be handled within your own system logic after receiving the callback.
Callback Payload Format
GoKart delivers conversion callbacks as a JSON-based webhook via an HTTP
POSTrequest.The callback data is sent in the request body as a fully populated JSON payload, containing the entire conversion schema with all available fields (e.g., conversion ID, offer ID, event ID, etc.).
It is not a query-parameter–based or URL-templated callback where only selected parameters defined in the callback URL are dynamically substituted.
See example schema here.
Key Details:
For details on how to handle new fields in our API schema, please see our SDK API Schema Disclaimer.
By default, GoKart sends callbacks only for conversions logged as successful. If you also want to receive callbacks for Pending or Rejected conversions, you must explicitly enable these options in your callback settings.
The callback URL supports a maximum length of 500 characters. Any URL exceeding this limit will return an error upon saving.
GoKart does not perform reversals or handle rewarding. If you need to issue or reclaim previously issued rewards must be handled in your own system.
(Optional) Enable callbacks for Pending and Rejected conversions.
For details on how to handle callbacks for Pending and Rejected conversions, please see our guide here.