Integrations and migration
How to connect a checkout and configure sales postbacks
Create a sales integration, install its URL in your checkout, preserve attribution, and validate the first postback.
Connect your checkout so that each confirmed purchase can return to Moviie and be matched to the video involved in the sale. The integration uses a unique URL and, when required by the platform, a signature secret.
Before you begin
You need access to the checkout's webhook or postback settings. Also confirm that your video CTA points to the payment page used by this integration.
When an integration is active, Moviie adds an attribution key to a compatible checkout URL. It does not overwrite a value that is already present in the same parameter.
Create the integration
- Open Sales in Moviie's main navigation.
- Select New integration. If this is your first one, you can also select Start setup.
- Under Choose the platform, select your checkout. Use Generic webhook, Zapier, Make, or n8n when you need to define the event contract.
- Enter a name that identifies the product or operation, such as “Main product.”
- Keep the suggested Attribution parameter. Change it only when the checkout setup requires a different field.
- Enter the requested secret, such as a Hottok or Secret Key, when the field appears.
- Select Create integration and wait for test.
Moviie generates the unique URL after creation.
Configure the postback in your checkout
Copy the Postback URL from the integration card. Then:
- Open the platform's webhooks, notifications, or postbacks area.
- Create a configuration and paste the Moviie URL.
- Select approved purchase and renewal. Include refund and chargeback when the platform offers those events.
- Preserve Moviie's attribution parameter on the way to checkout.
- Save the configuration.
The Connect checkout screen provides platform-specific instructions and links to the official documentation when a guide is available.
Run both tests
Select Test on the integration card. This confirms that the internal URL receives the event and validates Moviie's signature. The test remains visible in health but never counts toward the funnel or revenue.
Next, send a test from the checkout itself. This second test validates the external path, including the URL, secret, and selected events. If the platform has no test action, use a controlled transaction and confirm the result before considering the integration ready.
Confirm the first attributed sale
- Open Health on the integration card.
- Confirm that the delivery is Processed.
- Return to Sales and check Attribution found.
- Open Funnel by video to find the sale and revenue in the correct period.
A purchase enters the funnel only after approval, within the 30-day window, and with an attribution key from a valid session.
Use your own webhook
For Generic webhook, Zapier, Make, and n8n, open Mapping to identify where the payload contains order, event, amount, currency, Moviie key, and date. You must also map your system's statuses to Moviie's accepted events.
Each save creates a new mapping version. Validate a real delivery before using the data for decisions.
Pause, rotate, or remove the integration
- Pause keeps the setup, but new deliveries are ignored until reactivation.
- Rotate URL creates a new address. The previous URL remains accepted for 48 hours so you can update the checkout without interrupting collection.
- Remove stops new deliveries. Existing sales and postbacks remain in history.
Do not publish the unique URL or share the signature secret.
Keep learning
Keep going
Guides that help with the next step.