Docs
HomeAPI ReferenceAI AgentsMCP

Shopify App Integration

Sell ROOPON packages on your Shopify checkout. Affiliate merchants earn revenue share; ROOPON handles entries and draws. This is not the discount-partner directory program.

Who this is for

Affiliate merchants with a Shopify store — checkout upsells and order bumps. For local discount businesses, see become a partner.

Install

  1. 1

    Install from the Shopify App Store

    Search for ROOPON Giveaways or use https://apps.shopify.com/roopon-giveaways.
  2. 2

    OAuth connect

    ROOPON creates or links your merchant account from the store owner email. Accept merchant terms when prompted.
  3. 3

    Open the embedded app

    Manage sync, orders, and billing inside Shopify Admin → Apps → ROOPON Giveaways, or sign in at /shopify when opened with embed params.

Product sync

Sync active ROOPON packages as Shopify products. Use them as cart upsells, checkout bumps, or standalone catalogue items. Ended giveaways are auto-drafted via the end-giveaways safety cron.

  • GET /api/shopify/giveaways/sync — manifest for package variants
  • POST /api/shopify/products/sync — register synced product IDs

Orders & webhooks

Shopify sends order webhooks to ROOPON. Qualifying line items create entries and record revenue split (typically 40% merchant / 60% ROOPON via app billing).

POST
/api/shopify/webhooks· Shopify HMAC

Edge handler: supabase/functions/shopify-webhook

Embedded app API

Used inside Shopify Admin (session token + optional ROOPON session).

GET
/api/shopify/embedded/dashboard· Shopify session token
POST
/api/shopify/embedded/link-account· Shopify + ROOPON JWT
GET
/api/shopify/giveaways/sync· Partner session / embed

OAuth

GET
/api/shopify/auth· Public (starts OAuth)
GET
/api/shopify/auth/callback· Shopify OAuth callback

Merchant terms & billing

Revenue share and ROOPON's portion are defined in merchant terms. App billing runs through Shopify — separate from the referral-link affiliate PayPal program.

Merchant terms

WooCommerce docsInstall on Shopify

Merchant marketing page — overview, FAQ, and install CTA for store owners (not technical reference).