@flopay/react 1.9.28 → 1.9.30

package/README.md

@@ -487,7 +487,7 @@ export function ComposedCheckout({ session, nonce }: { session: CheckoutSession;
 | `children` | `ReactNode?` | Custom layout rendered instead of the default `SplitCardForm` |
 | `telemetry` | `boolean?` | Set `false` to opt out of operational telemetry |
 | `onComplete` | `(result: PaymentResult) => void` | Payment succeeded or was authorized |
-| `onDecline` | `(decline: DeclineEvent) => void` | A payment was declined or authentication failed |
+| `onDecline` | `(decline: DeclineEvent) => void` | A payment was declined or authentication failed. The event carries `sessionId` when a session exists |
 | `onError` | `(error: FloPayError) => void` | A checkout error occurred |
 | `onSessionCompleted` | `(successUrl: string) => void` | The session was already completed |
 | `onButtonClick` | `(method: CheckoutButtonMethod) => void` | A payment method button was clicked |
@@ -543,8 +543,8 @@ Also accepts every standard `button` attribute, such as `onClick`, `disabled`, a
 | `theme` | `ThemeId?` | Theme for the button and its fallback checkout |
 | `appearance` / `buttonsStyles` | objects | Appearance overrides |
 | `onSuccess` | `(event: FloPayAutomaticPaymentSuccessEvent) => void` | Payment completed |
-| `onDecline` | `(decline: DeclineEvent) => void` | Payment declined |
-| `onError` | `(error: FloPayError) => void` | Payment or setup error |
+| `onDecline` | `(decline: DeclineEvent) => void` | Payment declined. Carries the failed session's `sessionId` |
+| `onError` | `(error: FloPayError) => void` | Payment or setup error. Carries `sessionId` when the failure happened after the session was created |
 | `children` | `ReactNode?` | Button content |
 
 ### SplitCardFormProps
@@ -628,6 +628,7 @@ Checkout errors reach `onError` (and the `error` render prop) as `FloPayError` v
 | `external_payment_method_failed` | `api_error` | A wallet, PayPal, or alternative method failed technically after the buyer clicked it. The chooser offers a retry. |
 | `InvalidCardSetupSurface` | `validation_error` | `FloPayCheckout` was given a card-setup session; use `FloPayCardSetup`. |
 | `three_ds_aborted` / `three_ds_timeout` | `api_error` | The buyer cancelled, or did not finish, the authentication challenge for a saved card in confirm or auto mode. |
+| `checkout_processing_timeout` | `api_error` | The payment's outcome is not known yet: the SDK could not confirm it in time and it may still complete. Do not resubmit; reconcile from `payment.*` webhooks. `FloPayAutomaticPaymentButton` reports it through `onError`, not `onDecline`, shows a "don't pay again" notice under the button, and opens no fallback checkout. |
 | `stored_payment_method_unsupported` | `api_error` | The backend-selected saved method cannot be used for this transaction. Show the supplied buyer-safe instruction and let the buyer choose another method. |
 | `InvalidPaymentProcessResponse` | `api_error` | Saved-payment processing returned a response the SDK could not use. |