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))
| 376 | tags=["Partner"] |
| 377 | ) |
| 378 | async 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 |