fix(referrals): name Kilo Pass Impact reward unit

Author: jeanduplessis

.specs/impact-referrals.md

@@ -18,6 +18,7 @@ Updated 2026-05-06 -- require Impact Advocate reward redemption after local Kilo
 Updated 2026-05-12 -- note price-versioned KiloClaw billing preserves referral semantics.
 Updated 2026-05-22 -- renamed to `.specs/impact-referrals.md` and expanded to Kilo Pass referrals.
 Updated 2026-05-28 -- classify enforced Stripe EFW refunds as adverse payments.
+Updated 2026-05-29 -- name the Impact-facing Kilo Pass reward unit `Kilo Pass Bonus Credits`.
 
 ## Conventions
 
@@ -628,8 +629,8 @@ application, and Kilo Pass redeems after local referral bonus allocation.
      local reward eligibility, application, cancellation, or reversal.
 
 158a. For Kilo Pass, when a local referral bonus reward is allocated/granted, the system MUST queue asynchronous Impact
-      Advocate reward lookup and single-reward redemption using the reward amount and USD unit so Impact reporting
-      matches Kilo allocation state.
+      Advocate reward lookup and single-reward redemption using the USD-denominated reward amount and the
+      `Kilo Pass Bonus Credits` unit so Impact reporting matches Kilo allocation state.
 
 158b. Kilo Pass Impact Advocate reward redemption MUST be idempotently queued per local reward and MUST NOT block paid
       conversion processing, reward ledger creation, reward application, billing settlement, or user access.
@@ -772,6 +773,10 @@ application, and Kilo Pass redeems after local referral bonus allocation.
 
 ## Changelog
 
+### 2026-05-29 -- Name the Kilo Pass Impact reward unit
+
+Kilo Pass reward synchronization sends the `Kilo Pass Bonus Credits` unit to Impact Advocate while retaining the USD-denominated local reward amount.
+
 ### 2026-05-28 -- Enforced EFW refunds are adverse payments
 
 Classified an enforced Stripe Early Fraud Warning refund as an adverse qualifying payment for both covered products. Pending or earned-but-unapplied rewards cancel, already-applied rewards require support review, and later refund or chargeback delivery must remain idempotent.

apps/web/src/lib/impact/kilo-pass-referrals.test.ts

@@ -18,9 +18,16 @@ jest.mock('@/lib/impact/advocate', () => {
     sendImpactAdvocateRewardLookupPayload: jest.fn(async () => ({
       ok: true,
       statusCode: 200,
-      rewards: [{ id: 'impact-kilo-pass-reward', type: 'CREDIT', amount: 24.5, unit: 'USD' }],
+      rewards: [
+        {
+          id: 'impact-kilo-pass-reward',
+          type: 'CREDIT',
+          amount: 24.5,
+          unit: 'Kilo Pass Bonus Credits',
+        },
+      ],
       responseBody:
-        '{"rewards":[{"id":"impact-kilo-pass-reward","type":"CREDIT","amount":24.5,"unit":"USD"}]}',
+        '{"rewards":[{"id":"impact-kilo-pass-reward","type":"CREDIT","amount":24.5,"unit":"Kilo Pass Bonus Credits"}]}',
     })),
     sendImpactAdvocateRewardRedemptionPayload: jest.fn(async () => ({
       ok: true,
@@ -114,9 +121,16 @@ beforeEach(async () => {
   mockSendImpactAdvocateRewardLookupPayload.mockResolvedValue({
     ok: true,
     statusCode: 200,
-    rewards: [{ id: 'impact-kilo-pass-reward', type: 'CREDIT', amount: 24.5, unit: 'USD' }],
+    rewards: [
+      {
+        id: 'impact-kilo-pass-reward',
+        type: 'CREDIT',
+        amount: 24.5,
+        unit: 'Kilo Pass Bonus Credits',
+      },
+    ],
     responseBody:
-      '{"rewards":[{"id":"impact-kilo-pass-reward","type":"CREDIT","amount":24.5,"unit":"USD"}]}',
+      '{"rewards":[{"id":"impact-kilo-pass-reward","type":"CREDIT","amount":24.5,"unit":"Kilo Pass Bonus Credits"}]}',
   });
   mockSendImpactAdvocateRewardRedemptionPayload.mockResolvedValue({
     ok: true,
@@ -383,7 +397,7 @@ describe('Kilo Pass Impact referral conversions', () => {
               userId: 'referee@example.com',
               rewardTypeFilter: 'CREDIT',
             }),
-            redemption: { amount: 24.5, unit: 'USD' },
+            redemption: { amount: 24.5, unit: 'Kilo Pass Bonus Credits' },
           }),
         }),
         expect.objectContaining({
@@ -396,7 +410,7 @@ describe('Kilo Pass Impact referral conversions', () => {
               userId: 'referrer@example.com',
               rewardTypeFilter: 'CREDIT',
             }),
-            redemption: { amount: 24.5, unit: 'USD' },
+            redemption: { amount: 24.5, unit: 'Kilo Pass Bonus Credits' },
           }),
         }),
       ])
@@ -413,7 +427,7 @@ describe('Kilo Pass Impact referral conversions', () => {
       { programKey: ImpactAdvocateProgramKey.KiloPass }
     );
     expect(mockSendImpactAdvocateRewardRedemptionPayload).toHaveBeenCalledWith(
-      { rewardId: 'impact-kilo-pass-reward', amount: 24.5, unit: 'USD' },
+      { rewardId: 'impact-kilo-pass-reward', amount: 24.5, unit: 'Kilo Pass Bonus Credits' },
       { programKey: ImpactAdvocateProgramKey.KiloPass }
     );
 
@@ -837,7 +851,7 @@ describe('Kilo Pass Impact referral conversions', () => {
             state: 'redeemed',
             request_payload: expect.objectContaining({
               programKey: ImpactAdvocateProgramKey.KiloPass,
-              redemption: { amount: 24.5, unit: 'USD' },
+              redemption: { amount: 24.5, unit: 'Kilo Pass Bonus Credits' },
             }),
           })
         )

apps/web/src/lib/impact/kiloclaw-referrals.ts

@@ -129,7 +129,7 @@ const REFERRAL_REWARD_ACTOR = {
 
 const SIGNUP_REFERRAL_TOUCH_CAPTURE_GRACE_MS = 10 * 60 * 1000;
 const IMPACT_ADVOCATE_KILOCLAW_REWARD_UNIT = 'MONTH';
-const IMPACT_ADVOCATE_KILO_PASS_REWARD_UNIT = 'USD';
+const IMPACT_ADVOCATE_KILO_PASS_REWARD_UNIT = 'Kilo Pass Bonus Credits';
 
 function getDatabaseClient(database?: DatabaseClient): DatabaseClient {
   return database ?? db;