Skip to main content

Sync and publish

Two different actions. Founders do not want every coupon public, so Dealpuffin keeps them apart.

Sync​

Sync reads coupons and promotion codes with the stored billing key (Stripe, Paddle, Polar, Lemon Squeezy, Dodo Payments, or RevenueCat) and refreshes what Dealpuffin knows: discount, duration, expiry, redemption counts, whether a code is active, whether the provider locked it to one customer, and which product ids the coupon applies to. A coupon that cannot be stored, such as a zero percent discount, is skipped. The rest of the import continues.

Sync does not publish a coupon. A coupon you have not published stays in the import. The reason on the product page is "Imported, not published."

Run sync again whenever you create or edit coupons in the billing provider. The product page has Sync again. Agents call connect_coupon_provider without a token.

If the provider returns more records than one sync can read, nothing from that sync is saved. The previous import stays.

connect_coupon_provider returns the code string only when that API key also has list_my_coupons. Otherwise the owner still sees eligibility, without the code. Pass the product slug. Omit token to sync again. publish_coupon takes the coupon id (and optional published / claim_limit). The coupon belongs to one product.

Publish​

Publish marks one imported coupon as public on that product. After that, the coupon is one offer seekers can claim (once the listing URL is https and the product is not hidden). Ownership verification is optional. If the coupon has several promotion codes, reveal round-robins among the ones that are still eligible.

  • An unrestricted coupon (no product ids on the coupon) is not matched for you. You choose to publish it on that product.
  • A coupon limited to provider product ids can be published only when the ids saved on that product overlap. If you change the ids, a published coupon that no longer overlaps is unpublished.

On the product page, each held coupon shows why it is off the catalog. Agents call publish_coupon with the coupon id.

Unpublish by leaving it unpublished. Hiding is a Dealpuffin override, separate from "not published yet."

After you publish​

The offer is listed only when every eligibility check passes. Publishing a coupon that has no promotion code, or only a customer-locked code, still will not put a code on the catalog.

Before you pick which coupon to publish, read the wishes. list_wishes with a category returns open wishes in that category, including subcategories when you pass the parent. list_wishes with mine: true returns wishes on the products this account submitted. Details are on Wishes.