From 7589058b91f4dcdeb33d17abc71cc3179cc69347 Mon Sep 17 00:00:00 2001 From: caelum0x Date: Sun, 6 Sep 2026 10:36:04 +0300 Subject: [PATCH] docs(talent): correct placement-path comments from Polar to Creem The recruiter placement/unlock path charges and settles through Creem (creemService + signed creemWebhooks checkout.completed), but the talentBillingService header, its settlement section comment, and the controller's requestUnlock JSDoc still described a Polar adapter / Polar order webhook. Correct those comments so the money path reads unambiguously as Creem. Verified before changing: @polar-sh/sdk and POLAR_WEBHOOK_SECRET remain in active use by subscriptionService, storeController, and polarWebhooks for subscriptions and the creator store, so they are intentionally left in place. Comment-only change; no behavior change. Co-Authored-By: Claude Fable 5 --- .../backend/src/controllers/talentBillingController.ts | 2 +- gitgram/backend/src/services/talentBillingService.ts | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/gitgram/backend/src/controllers/talentBillingController.ts b/gitgram/backend/src/controllers/talentBillingController.ts index 5a01e4fd..d2c7c6b3 100644 --- a/gitgram/backend/src/controllers/talentBillingController.ts +++ b/gitgram/backend/src/controllers/talentBillingController.ts @@ -41,7 +41,7 @@ export const talentBillingController = { /** * POST /opportunities/:id/unlocks * Recruiter opens (or replays) a paid unlock for a matched candidate. Returns a - * Polar checkout URL, or `alreadyUnlocked` when the entitlement is already paid. + * Creem checkout URL, or `alreadyUnlocked` when the entitlement is already paid. */ requestUnlock: asyncHandler(async (req: AuthRequest, res: Response) => { const opportunityId = req.params.id; diff --git a/gitgram/backend/src/services/talentBillingService.ts b/gitgram/backend/src/services/talentBillingService.ts index 5aad679f..2a4a65b6 100644 --- a/gitgram/backend/src/services/talentBillingService.ts +++ b/gitgram/backend/src/services/talentBillingService.ts @@ -4,8 +4,8 @@ * This is the recruiter monetization the talent graph was designed for but never * wired: a recruiter (the opportunity owner) pays a placement/access fee to * unlock a matched candidate's contact details and full evidence. The fee is - * charged through the shared Polar adapter (the same provider used for - * subscriptions and the store) and settled by the Polar `order.created` webhook. + * charged through the Creem adapter (a merchant-of-record supporting Turkey-based + * sellers) and settled by the signed Creem `checkout.completed` webhook. * * Design notes: * - Fee math is pure and configuration-driven (see the `*FeeCents` helpers). @@ -15,7 +15,7 @@ * (opportunity, candidate, recruiter); a repeated unlock never opens a second * charge, and settlement is a no-op once the entitlement is already paid. * - Every function accepts injectable dependencies so the flow can be unit - * tested without a live Postgres, Polar, or the matcher (same pattern as + * tested without a live Postgres, Creem, or the matcher (same pattern as * `findTalentMatches`). */ import prisma from '../utils/prisma'; @@ -249,7 +249,7 @@ export async function requestCandidateUnlock( } // --------------------------------------------------------------------------- -// Settlement (Polar order webhook) + entitlement check +// Settlement (Creem checkout.completed webhook) + entitlement check // --------------------------------------------------------------------------- export interface SettlePlacementParams {