MCPcopy Create free account
hub / github.com/Roy3838/Observer / generate_partner_code

Function generate_partner_code

api/payments.py:378–433  ·  view source on GitHub ↗

Generate a unique, single-use Stripe promotion code for a partner's lead. Auth: X-Partner-Key header (the partner's secret auth code). Each generated code: - Applies the partner's coupon (e.g. 50% off the first month) - Can be redeemed exactly once (max_redemptions=1) — so it

(partner: dict = Depends(get_partner))

Source from the content-addressed store, hash-verified

376 tags=["Partner"]
377)
378async def generate_partner_code(partner: dict = Depends(get_partner)):
379 """
380 Generate a unique, single-use Stripe promotion code for a partner's lead.
381
382 Auth: X-Partner-Key header (the partner's secret auth code).
383
384 Each generated code:
385 - Applies the partner's coupon (e.g. 50% off the first month)
386 - Can be redeemed exactly once (max_redemptions=1) — so it cannot be shared/farmed
387 - Expires after PARTNER_CODE_TTL_DAYS
388
389 The lead redeems it in the normal checkout via "Add promotion code" (already
390 enabled on the Pro/Max checkout sessions). No app frontend changes required.
391
392 Tracking is Stripe-native: PromotionCode.list(coupon=<partner coupon>) gives
393 generated count (len) and conversions (sum of times_redeemed).
394 """
395 coupon_id = partner["coupon_id"]
396 partner_id = partner["id"]
397 if not coupon_id:
398 raise HTTPException(status_code=400, detail="This partner key is not set up for discount codes.")
399
400 try:
401 # Newer Stripe API versions nest the coupon under `promotion` instead of a
402 # top-level `coupon` param (the latter now 400s as "unknown parameter").
403 promo = await asyncio.to_thread(
404 stripe.PromotionCode.create,
405 promotion={"type": "coupon", "coupon": coupon_id},
406 max_redemptions=1,
407 expires_at=int(time.time()) + PARTNER_CODE_TTL_DAYS * 24 * 60 * 60,
408 metadata={"partner": partner_id},
409 )
410
411 # Report the actual discount from the coupon when available (don't hardcode 50%).
412 # Handle both shapes: legacy `promo.coupon` and newer `promo.promotion.coupon`.
413 discount_label = None
414 coupon_obj = getattr(promo, "coupon", None)
415 if coupon_obj is None:
416 promotion_obj = getattr(promo, "promotion", None)
417 coupon_obj = getattr(promotion_obj, "coupon", None) if promotion_obj is not None else None
418 percent_off = getattr(coupon_obj, "percent_off", None) if coupon_obj is not None else None
419 if percent_off:
420 discount_label = f"{percent_off:g}% off first month"
421
422 logger.info(f"Generated promo code {promo.code} for partner '{partner_id}' (coupon {coupon_id})")
423 return {
424 "code": promo.code,
425 "partner": partner_id,
426 "discount": discount_label,
427 "expires_in_days": PARTNER_CODE_TTL_DAYS,
428 "message": "Share this single-use code with your lead. They enter it at checkout.",
429 }
430
431 except Exception as e:
432 logger.error(f"Failed to generate promo code for partner '{partner_id}': {e}")
433 raise HTTPException(status_code=500, detail="Could not generate promotion code.")
434
435

Callers

nothing calls this directly

Calls 2

infoMethod · 0.80
errorMethod · 0.80

Tested by

no test coverage detected