feat(payment): PAYPAL-3520 Max capture amount failure (#2485)

* feat(payment): PAYPAL-3520 instrument_declined error handling

* feat(payment): PAYPAL-3520 added paypal button widget

* feat(payment): PAYPAL-3520 updates after review

packages/braintree-integration/.eslintrc.json

@@ -23,7 +23,9 @@
                 "@typescript-eslint/consistent-type-assertions": "off",
                 "jest/no-conditional-expect": "off",
                 "@typescript-eslint/no-unsafe-call": "off",
-                "@typescript-eslint/no-empty-function": "off"
+                "@typescript-eslint/no-empty-function": "off",
+                "@typescript-eslint/no-throw-literal": "off",
+                "@typescript-eslint/no-floating-promises": "off"
             }
         }
     ]

packages/braintree-integration/src/braintree-paypal-constants.ts

@@ -0,0 +1,4 @@
+export const LOADING_INDICATOR_STYLES = {
+    'background-color': 'rgba(0, 0, 0, 0.4)',
+    'z-index': '1000',
+};

packages/braintree-integration/src/braintree-paypal/braintree-paypal-payment-initialize-options.ts

@@ -1,9 +1,16 @@
 import {
+    BraintreeError,
     BraintreeFormOptions,
     BraintreeThreeDSecureOptions,
 } from '@bigcommerce/checkout-sdk/braintree-utils';
+import { StandardError } from '@bigcommerce/checkout-sdk/payment-integration-api';
 
 export interface BraintreePaypalPaymentInitializeOptions {
+    /**
+     * The CSS selector of a container where the payment widget should be inserted into.
+     */
+    containerId?: string;
+
     threeDSecure?: BraintreeThreeDSecureOptions;
 
     /**
@@ -18,6 +25,30 @@ export interface BraintreePaypalPaymentInitializeOptions {
      * The location to insert the Pay Later Messages.
      */
     bannerContainerId?: string;
+
+    /**
+     * A callback right before render Smart Payment Button that gets called when
+     * Smart Payment Button is eligible. This callback can be used to hide the standard submit button.
+     */
+    onRenderButton?(): void;
+
+    /**
+     * A callback for submitting payment form that gets called
+     * when buyer approved PayPal account.
+     */
+    submitForm?(): void;
+
+    /**
+     * A callback that gets called if unable to submit payment.
+     *
+     * @param error - The error object describing the failure.
+     */
+    onPaymentError?(error: BraintreeError | StandardError): void;
+
+    /**
+     * A callback for displaying error popup. This callback requires error object as parameter.
+     */
+    onError?(error: unknown): void;
 }
 
 export interface WithBraintreePaypalPaymentInitializeOptions {