Offer fulfillment allows you to initiate, update, and retrieve the lifecycle of an offer fulfillment, after a personalized offer has been accepted. Whether the personalized offer triggers a direct billing change, a hosted checkout flow, or a redirect-based workflow, these APIs track acceptance, execution status, and completion, providing a consistent interface for fulfillment tracking and notifications.
Features of this object:
- Records fulfillment IDs for tracking and reference.
- Captures status (
in_progress,completed,failed). - Stores redirect/checkout URLs as needed.
- Contains timestamps for creation, completion, or failure.
- Includes error codes and messages for failure analysis.
Sample Offer fulfillmentJSON
API Index URL
Offer fulfillments attributes
The processing mode of the option. This indicates how the offer option is fulfilled: e.g., a direct billing change, a checkout flow, or a redirect to a URL.
The offer fulfillment is processed by Chargebee
The offer fulfillment is processed using Chargebee hosted checkout
The offer fulfillment is processed by your system
Chargebee triggers webhook and fulfillment is processed by your system
Chargebee sends an email as configured in the Growth application and the fulfillment is processed by your system
Current status of the offer fulfillment process.
The offer fulfillment is underway (not yet completed).
The offer was successfully applied . For URL redirects, this might be returned immediately if the action is completed, potentially along with a redirect_url if the user should be navigated to a specific page.
The offer fulfillment failed. The error object
field will be present to provide more details in this case.
A URL to which the user should be redirected. Returned only if the offer's processing type is billing_update or url_redirect
Timestamp when the fulfillment failed (present only when status = failed).
Timestamp when the fulfillment succeeded (present only when status = completed).