@fundly.ai/payment-sdk 1.5.0-beta.0 → 1.5.0-beta.2

package/README.md

@@ -595,51 +595,38 @@ The SDK automatically tracks payment events using CleverTap analytics. **No manu
 
 When the SDK mounts, it automatically initializes analytics with the appropriate environment settings based on the `environment` parameter in your `PaymentConfig`.
 
-### Tracked Events
+### Tracked Events (v2)
 
-The SDK automatically tracks these payment lifecycle events:
+The SDK tracks exactly two events in the payment lifecycle:
 
-1. **Payment_Initiated** - When any payment is started
-2. **Payment_Link_Generated** - When a payment link is created
-3. **Payment_QR_Generated** - When a dynamic QR code is created
-4. **Payment_Success** - When payment is successfully completed
-5. **Payment_Failed** - When payment fails
+#### 1. `Payment_SDK_Launched`
+Fires when the payment options screen fully loads.
 
-Each event includes:
-- Payment mode (CASH, CHEQUE, STATIC_QR, DYNAMIC_QR, PAYMENT_LINK)
-- Amount and invoice count
-- Salesman information (if provided)
-- Transaction ID and timestamp
-- Additional mode-specific data
+Key fields included:
+- `invoice_count`, `payment_amount`, `payment_type`, `partial_payment`
+- `supplier_id`, `supplier_name`, `user_type`, `user_uuid`
+- `session_id`, `platform`, `sdk_version`, `sdk_entry_point`
+- `is_payment_enabled`, `status`
+- All 9 `payment_option_*` availability booleans
+- `scan_channel`, `scan_origin`, `salesman_name`
+- Carry-forward fields from upstream: `view_id`, `scan_id`, `bill_id`, `bill_type`, `bill_status`, `bill_total_amount`, `outstanding_amount`, `notification_id`, `notification_channel` (null for non-QR/non-notification flows)
 
-### Custom Analytics Provider (Optional)
+#### 2. `Payment_Initiated`
+Fires when the user selects a payment method and proceeds.
 
-If you want to use a different analytics provider or disable CleverTap:
+Key fields included:
+- `fundly_transaction_id`, `invoice_count`, `partial_payment`
+- `payment_amount`, `payment_type`, `payment_method`, `payment_mode`
+- `payment_channel`, `payment_gateway`, `otp_required`, `retry_count`
+- `supplier_id`, `supplier_name`, `user_type`, `user_uuid`
+- `session_id`, `platform`, `mobile_changed`
+- FUNDLY_PAY loan fields where applicable
 
-```typescript
-import { analyticsService, IAnalyticsProvider } from '@fundly.ai/payment-sdk';
-
-// Disable analytics
-analyticsService.configure({
-  enabled: false
-});
+> **Note:** `Payment_Transaction` is **not** fired by the SDK. It is owned by the backend.
 
-// Or use your custom provider
-class MyAnalyticsProvider implements IAnalyticsProvider {
-  trackPaymentInitiated(data) { /* your implementation */ }
-  trackPaymentLinkGenerated(data) { /* your implementation */ }
-  trackPaymentQRGenerated(data) { /* your implementation */ }
-  trackPaymentSuccess(data) { /* your implementation */ }
-  trackPaymentFailed(data) { /* your implementation */ }
-}
-
-analyticsService.configure({
-  enabled: true,
-  provider: new MyAnalyticsProvider()
-});
-```
+### Analytics Failures
 
-**Note:** Custom configuration should be done before rendering the `PaymentOptionPage` component.
+All analytics calls are wrapped in try/catch. A tracking failure will never block or interrupt the payment flow.
 
 ---
 

package/dist/components/fundlyPayDrawer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fundlyPayDrawer.d.ts","sourceRoot":"","sources":["../../src/components/fundlyPayDrawer.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAmD,MAAM,OAAO,CAAC;AAExE,OAAO,6CAA6C,CAAC;AACrD,OAAO,uDAAuD,CAAC;AAY/D,UAAU,oBAAoB;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,4BAA4B,CAAC,EAAE,aAAa,EAAE,CAAC;IAC/C,6BAA6B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,iCAAiC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnD;AAED,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAikCnD,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"fundlyPayDrawer.d.ts","sourceRoot":"","sources":["../../src/components/fundlyPayDrawer.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAmD,MAAM,OAAO,CAAC;AAExE,OAAO,6CAA6C,CAAC;AACrD,OAAO,uDAAuD,CAAC;AAY/D,UAAU,oBAAoB;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,4BAA4B,CAAC,EAAE,aAAa,EAAE,CAAC;IAC/C,6BAA6B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,iCAAiC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnD;AAED,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAmkCnD,CAAC;AAEF,eAAe,eAAe,CAAC"}