Feat: PayPal Credit OTP and Save Payment Hooks (#774)

* add initial files and credit otp hook

* add unit test for credit otp hook

* update paypal-payments instance with credit save payment and add corresponding hook

* add doc comment above credit save payment property in paypal payments instance interface

* fix paypal save payment session hook to support redirect and direct app switch

* update package export for credit hooks and add redirect and app-switch logic to credit save payment

* remove comment

* add tests for credit save payment

* chore: add changesets

* address PR comments

* add doc comments to the credit and paypal save payment hooks

* remove comments

Author: EvanReinstein

.changeset/icy-webs-relate.md

@@ -0,0 +1,5 @@
+---
+"@paypal/react-paypal-js": patch
+---
+
+Adds Credit One Time Payment and Credit Save Payment react hooks

.changeset/nine-games-burn.md

@@ -0,0 +1,5 @@
+---
+"@paypal/paypal-js": patch
+---
+
+Updates the paypal-payments instance to include the Credit save payment method.

packages/paypal-js/types/v6/components/paypal-payments.d.ts

@@ -117,6 +117,8 @@ export type SavePaymentSession = Omit<BasePaymentSession, "start"> & {
         presentationModeOptions: PayPalPresentationModeOptions,
         paymentSessionPromise?: Promise<{ vaultSetupToken: string }>,
     ) => Promise<void>;
+    hasReturned?: () => boolean;
+    resume?: () => Promise<void>;
 };
 
 export type PayLaterOneTimePaymentSessionOptions =
@@ -272,4 +274,34 @@ export interface PayPalPaymentsInstance {
     createPayPalCreditOneTimePaymentSession: (
         paymentSessionOptions: PayPalCreditOneTimePaymentSessionOptions,
     ) => OneTimePaymentSession;
+    /**
+     * Creates a PayPal Credit save payment session for storing PayPal Credit payment methods for future use.
+     *
+     * @remarks
+     * This method allows you to set up vault payment sessions where customers can save
+     * their PayPal Credit payment method for future transactions without re-entering details.
+     * Available in supported countries.
+     *
+     * @param paymentSessionOptions - Configuration options for the PayPal Credit save payment session
+     * @returns A session object that can be used to start the PayPal Credit vault setup flow
+     *
+     * @example
+     * ```typescript
+     * const savePayPalCreditSession = sdkInstance.createPayPalCreditSavePaymentSession({
+     *   vaultSetupToken: 'your-vault-setup-token',
+     *   onApprove: (data) => {
+     *     console.log('PayPal Credit payment method saved:', data);
+     *   },
+     *   onCancel: () => {
+     *     console.log('Save PayPal Credit payment canceled');
+     *   },
+     *   onError: (data) => {
+     *     console.error('Save PayPal Credit payment error:', data);
+     *   }
+     * });
+     * ```
+     */
+    createPayPalCreditSavePaymentSession: (
+        paymentSessionOptions: SavePaymentSessionOptions,
+    ) => SavePaymentSession;
 }

packages/react-paypal-js/src/v6/hooks/usePayLaterOneTimePaymentSession.ts

@@ -36,7 +36,7 @@ export function usePayLaterOneTimePaymentSession({
 }: PayLaterOneTimePaymentSessionProps): BasePaymentSessionReturn {
     const { sdkInstance, loadingStatus } = usePayPal();
     const isMountedRef = useIsMountedRef();
-    const sessionRef = useRef<OneTimePaymentSession | null>(null); // handle cleanup
+    const sessionRef = useRef<OneTimePaymentSession | null>(null);
     const proxyCallbacks = useProxyProps(callbacks);
     const [error, setError] = useError();