Skip to main content

​
End-to-end checklist

  1. Use an isolated test store/campaign. There is no Orders API dry-run flag. Use isSample: true to test ingestion without commissions; a sample cannot later be converted into an earning order by replay.
  2. Open an approved submission’s generated tracking link. Preserve ss through redirects.
  3. Before consent, confirm getVisitorId() returns null and the pixel has not sent events.
  4. Grant analytics and marketing consent. Confirm a visitor ID and successful browser requests to /api/commerce/pixel/YOUR_PIXEL_CODE. Exercise product, cart, and checkout-start actions.
  5. Save that visitor ID with your checkout on the server. If using a SideShift-provided account, also capture the optional advertising context.
  6. Verify payment through your payment system, then send the confirmed order. Check HTTP 200 and the store’s tracking diagnostics. Acceptance alone does not guarantee attribution.
  7. Replay the same order. Expect duplicate: true. Send a cumulative partial refund using the original order ID, payment timestamp, and amount. Confirm the existing order updates without creating another order.
  8. Withdraw consent. Confirm the visitor ID is cleared and no new SideShift events or retries occur.
Testing actual commissions requires a deliberately authorized non-sample order, eligible accepted creator terms, and a qualifying click. Testing advertising purchase delivery additionally requires a qualifying live destination and purchase; a successful page validation is not proof of that flow.

​
Troubleshooting

The browser has bounded delivery retries, not guaranteed delivery. Use a durable retry queue for server orders and honor rate limits. Keep your own payment/order records as the source of truth.