@flopay/react 1.3.4 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -709,6 +709,24 @@ function PaymentStatus() {
709
709
  | `options.currency` | `string?` | ISO 4217 currency code (used when no `clientSecret`) |
710
710
  | `options.paymentMethodCreation` | `'manual' \| 'auto'` | How payment methods are created |
711
711
 
712
+ ### Privacy-safe operational telemetry
713
+
714
+ `FloPayCheckout` emits the same closed Flo-owned lifecycle/error/performance
715
+ contract as `@flopay/js`, including React render/interactivity and provider
716
+ readiness milestones. Collection is best-effort; merchant callbacks remain
717
+ available with their existing arguments and invocation order. Synchronous
718
+ throws and rejected callback promises are contained and logged only to the
719
+ merchant console; they are not uploaded as `CALLBACK_FAILED`. Set the single
720
+ `telemetry={false}` prop to opt out:
721
+
722
+ ```tsx
723
+ <FloPayCheckout sessionId={sessionId} nonce={nonce} telemetry={false} />
724
+ ```
725
+
726
+ No endpoint, custom tag, user context, message, stack, or metadata can be
727
+ configured. See [`docs/TELEMETRY.md`](../../docs/TELEMETRY.md) for the complete
728
+ privacy and retention contract.
729
+
712
730
  ### CheckoutFormProps
713
731
 
714
732
  | Prop | Type | Description |