react-native-hyperpay-sdk 0.2.0 → 0.5.0

package/OPPWAMobile.framework/Headers/OPPCheckoutProvider.h

@@ -0,0 +1,197 @@
+//
+// Copyright (c) 2019 by ACI Worldwide, Inc.
+// All rights reserved.
+//
+// This software is the confidential and proprietary information
+// of ACI Worldwide Inc ("Confidential Information"). You shall
+// not disclose such Confidential Information and shall use it
+// only in accordance with the terms of the license agreement
+// you entered with ACI Worldwide Inc.
+//
+
+@import Foundation;
+@import PassKit;
+@class OPPPaymentProvider;
+@class OPPTransaction;
+@class OPPCheckoutSettings;
+@class OPPCheckoutProvider;
+@class OPPApplePayRequestAuthorizationResult;
+@class OPPApplePayRequestShippingContactUpdate;
+@class OPPApplePayRequestShippingMethodUpdate;
+@protocol OPPCheckoutProviderDelegate;
+#import "OPPCheckoutPaymentMethod.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ A protocol for additional checkout callbacks.
+ */
+@protocol OPPCheckoutProviderDelegate <NSObject>
+@optional
+
+/// @name Validation methods
+
+/**
+ Called before submitting a transaction to the Server.
+ Use this callback to recreate checkout for specific payment brand or abort transaction.
+ @param checkoutProvider The instance of `OPPCheckoutProvider` that is calling delegate method.
+ @param transaction The transaction with masked sensitive data.
+ @param completion The completion block you should call to continue submitting transaction or abort it. In case of abortion checkout will be closed with error `OPPErrorCodeTransactionAborted`.
+ */
+- (void)checkoutProvider:(OPPCheckoutProvider *)checkoutProvider continueSubmitting:(OPPTransaction *)transaction completion:(void (^)(NSString * _Nullable checkoutID, BOOL abort))completion;
+
+/**
+ Called when card holder text field was changed or pressed Pay button on the payment detail view.
+ Use this callback to override the internal card holder validation.
+ @param checkoutProvider The instance of `OPPCheckoutProvider` that is calling delegate method.
+ @param cardHolder The card holder value.
+ @return `YES` if the card holder is valid, otherwise `NO`.
+ */
+- (BOOL)checkoutProvider:(OPPCheckoutProvider *)checkoutProvider validateCardHolder:(nullable NSString *)cardHolder;
+
+/// @name Safari services methods
+
+/**
+ Called when the user taps the 'Done' button on SFSafariViewController.
+ @param checkoutProvider The instance of `OPPCheckoutProvider` that is calling delegate method.
+ */
+- (void)checkoutProviderDidFinishSafariViewController:(OPPCheckoutProvider *)checkoutProvider;
+
+/// @name Apple Pay methods
+
+/**
+ Called when a new shipping method was selected.
+ The delegate must invoke the completion block with an updated array of `PKPaymentSummaryItem` objects.
+ @param checkoutProvider The instance of `OPPCheckoutProvider` that is calling delegate method.
+ @param shippingMethod The shipping method for this transaction.
+ @param completion The completion block you should call to update the shipping costs based on the shipping method.
+*/
+- (void)checkoutProvider:(OPPCheckoutProvider *)checkoutProvider applePayDidSelectShippingMethod:(PKShippingMethod *)shippingMethod handler:(void (^)(OPPApplePayRequestShippingMethodUpdate *update))completion;
+
+/**
+ Called when a new shipping address was selected.
+ The delegate must invoke the completion block with an updated array of `PKPaymentSummaryItem` objects.
+ @param checkoutProvider The instance of `OPPCheckoutProvider` that is calling delegate method.
+ @param contact The contact information needed for shipping.
+ @param completion The completion block you should call to update the shipping address.
+ */
+- (void)checkoutProvider:(OPPCheckoutProvider *)checkoutProvider applePayDidSelectShippingContact:(PKContact *)contact handler:(void (^)(OPPApplePayRequestShippingContactUpdate *update))completion;
+
+
+/**
+ Called when the payment request was authorized.
+ The delegate must invoke the completion block with an appropriate authorization status.
+ @param checkoutProvider The instance of `OPPCheckoutProvider` that is calling delegate method.
+ @param payment The result of authorizing a payment request and contains payment information, encrypted in the payment token.
+ @param completion The completion block you should call with an appropriate authorization status.
+ */
+- (void)checkoutProvider:(OPPCheckoutProvider *)checkoutProvider applePayDidAuthorizePayment:(PKPayment *)payment handler:(void (^)(OPPApplePayRequestAuthorizationResult *result))completion;
+
+@end
+
+
+/**
+ Abstract class for displaying an in-App payment page.
+ */
+@interface OPPCheckoutProvider : NSObject
+
+/// @name Properties
+
+/**
+ Checkout provider delegate.
+ */
+@property (nonatomic, weak) id<OPPCheckoutProviderDelegate> delegate;
+
+/// @name Initialization
+
+/**
+ Factory method to generate an `OPPCheckoutProvider` used for displaying an in-App payment pages.
+ @param provider The OPPPaymentProvider which is used for performing the transaction once all the data from the user is collected.
+ @param checkoutID The checkout Id of the transaction. Must be not `nil` or empty.
+ @param settings The `OPPCheckoutSettings` used for these payment pages. These settings are provided to customize the appearance and functionality of the payment pages. If `nil`, default settings will be created.
+
+ @return Returns an `OPPCheckoutProvider` for displaying in-App payment pages. Returns `nil` if `provider` or `checkoutID` are not set.
+ */
++ (nullable instancetype)checkoutProviderWithPaymentProvider:(OPPPaymentProvider *)provider checkoutID:(NSString *)checkoutID settings:(nullable OPPCheckoutSettings *)settings;
+
+/**
+ Designated initializer method to generate an `OPPCheckoutProvider` used for displaying an in-App payment pages.
+ @param provider The OPPPaymentProvider which is used for performing the transaction once all the data from the user is collected.
+ @param checkoutID The checkout Id of the transaction. Must be not `nil` or empty.
+ @param settings The `OPPCheckoutSettings` used for these payment pages. These settings are provided to customize the appearance and functionality of the payment pages. If `nil`, default settings will be created.
+ @return Returns an `OPPCheckoutProvider` for displaying in-App payment pages. Returns `nil` if `provider` or `checkoutID` are not set.
+ */
+- (nullable instancetype)initWithPaymentProvider:(OPPPaymentProvider *)provider checkoutID:(NSString *)checkoutID settings:(nullable OPPCheckoutSettings *)settings;
+
+/// @name Presenting checkout
+
+/**
+ Opens an in-App payment page for collecting user input and submitting a transaction. First the list of payment methods from the checkout settings will be displayed.
+ @param completionHandler A block executed when the transaction is completed. You need to send the request to your server to get the transaction status.
+ @param cancelHandler A block executed if the user closes the payment page prematurely.
+ */
+- (void)presentCheckoutForSubmittingTransactionCompletionHandler:(void (^)(OPPTransaction * _Nullable transaction, NSError * _Nullable error))completionHandler
+                                                   cancelHandler:(void (^ _Nullable )(void))cancelHandler;
+
+/**
+ Opens an in-App payment page for collecting user input and submitting a transaction.
+ Payment form for the choosen payment method will be opened. If no user input is required in app (e.g. PayPal), shopper will be redirected directly to the issuer web page.
+ @param paymentBrand The payment brand for transaction.
+ @param loadingHandler A block executed whenever SDK sends request to the server or receives the response. You can start or stop loading animation based on `inProgress` parameter.
+ @param completionHandler A block executed when the transaction is completed. You need to send the request to your server to get the transaction status.
+ @param cancelHandler A block executed if the user closes the payment page prematurely.
+ */
+- (void)presentCheckoutWithPaymentBrand:(NSString *)paymentBrand
+                         loadingHandler:(void (^ _Nullable )(BOOL inProgress))loadingHandler
+                      completionHandler:(void (^)(OPPTransaction * _Nullable transaction, NSError * _Nullable error))completionHandler
+                          cancelHandler:(void (^ _Nullable )(void))cancelHandler;
+
+/**
+ Closes the in-App payment page. The delegate is not informed if this method is being called.
+ @param animated Specifies whether the payment page should be dismissed using an animation or immediately without an animation.
+ @param completion The completion handler, if provided, will be invoked after the checkout screen will be dismissed.
+ */
+- (void)dismissCheckoutAnimated:(BOOL)animated completion: (void (^ __nullable)(void))completion;
+
+@end
+
+/// Deprecated methods
+@interface OPPCheckoutProvider (Deprecated)
+
+/**
+ Opens an in-App payment page for collecting user input and submitting a transaction. First the list of payment methods from the checkout settings will be displayed.
+ @param completionHandler A block executed when the transaction is completed. You need to send the request to your server to get the transaction status.
+ @param paymentBrandSelectedHandler A block executed when the shopper selected payment brand. You need to obtain a new checkout Id if the selected payment brand requires another payment type and return the value to SDK or `nil` in case of error using completion block.
+ @param cancelHandler A block executed if the user closes the payment page prematurely.
+ @warning **Deprecated:** Use `-presentCheckoutForSubmittingTransactionCompletionHandler:cancelHandler:` instead. Use `-[OPPCheckoutProviderDelegate checkoutProvider:continueSubmitting:completion:]` instead of implementing `paymentBrandSelectedHandler`.
+ */
+- (void)presentCheckoutForSubmittingTransactionCompletionHandler:(void (^)(OPPTransaction * _Nullable transaction, NSError * _Nullable error))completionHandler
+                                     paymentBrandSelectedHandler:(void (^ _Nullable )(NSString * _Nonnull paymentBrand, void (^completion)(NSString * _Nullable checkoutID)))paymentBrandSelectedHandler
+                                                   cancelHandler:(void (^ _Nullable )(void))cancelHandler DEPRECATED_MSG_ATTRIBUTE("- Use -presentCheckoutForSubmittingTransactionCompletionHandler:cancelHandler: instead.");
+
+/**
+ Opens an in-App payment page for collecting user input and submitting a transaction. First the list of payment methods from the checkout settings will be displayed.
+ @param completionHandler A block executed when the transaction is completed. You need to send the request to your server to get the transaction status.
+ @param paymentMethodSelectedHandler A block executed when the shopper selected payment brand. You need to obtain a new checkout Id if the selected payment brand requires another payment type and return the value to SDK or `nil` in case of error using completion block.
+ @param cancelHandler A block executed if the user closes the payment page prematurely.
+ @warning **Deprecated:** Use `-presentCheckoutForSubmittingTransactionCompletionHandler:paymentBrandSelectedHandler:cancelHandler:` instead
+ */
+- (void)presentCheckoutForSubmittingTransactionCompletionHandler:(void (^)(OPPTransaction * _Nullable transaction, NSError * _Nullable error))completionHandler
+                                    paymentMethodSelectedHandler:(void (^ _Nullable )(OPPCheckoutPaymentMethod paymentMethod, void (^completion)(NSString * _Nullable checkoutID)))paymentMethodSelectedHandler
+                                                   cancelHandler:(void (^ _Nullable )(void))cancelHandler DEPRECATED_MSG_ATTRIBUTE("- Use -presentCheckoutForSubmittingTransactionCompletionHandler:paymentBrandSelectedHandler:cancelHandler: instead.");
+
+/**
+ Opens an in-App payment page for collecting user input and submitting a transaction.
+ Payment form for the choosen payment method will be opened. If no user input is required in app (e.g. PayPal), shopper will be redirected directly to the issuer web page.
+ @param paymentMethod The payment method for transaction.
+ @param loadingHandler A block executed whenever SDK sends request to the server or receives the response. You can start or stop loading animation based on inProgress parameter.
+ @param completionHandler A block executed when the transaction is completed. You need to send the request to your server to get the transaction status.
+ @param cancelHandler A block executed if the user closes the payment page prematurely.
+ @warning **Deprecated:** Use `-presentCheckoutWithPaymentBrand:loadingHandler:completionHandler:cancelHandler:` instead
+ */
+- (void)presentCheckoutWithPaymentMethod:(OPPCheckoutPaymentMethod)paymentMethod
+                          loadingHandler:(void (^ _Nullable )(BOOL inProgress))loadingHandler
+                       completionHandler:(void (^)(OPPTransaction * _Nullable transaction, NSError * _Nullable error))completionHandler
+                           cancelHandler:(void (^ _Nullable )(void))cancelHandler DEPRECATED_MSG_ATTRIBUTE("- Use -presentCheckoutWithPaymentBrand:loadingHandler:completionHandler:cancelHandler: instead.");
+@end
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.framework/Headers/OPPCheckoutSettings.h

@@ -0,0 +1,185 @@
+//
+// Copyright (c) 2019 by ACI Worldwide, Inc.
+// All rights reserved.
+//
+// This software is the confidential and proprietary information
+// of ACI Worldwide Inc ("Confidential Information"). You shall
+// not disclose such Confidential Information and shall use it
+// only in accordance with the terms of the license agreement
+// you entered with ACI Worldwide Inc.
+//
+
+#import <Foundation/Foundation.h>
+#import "OPPCheckoutPaymentMethod.h"
+#import <PassKit/PassKit.h>
+@class OPPCheckoutTheme;
+@class OPPSecurityPolicy;
+
+/// An enumeration for the possible store payment details modes.
+typedef NS_ENUM(NSInteger, OPPCheckoutStorePaymentDetailsMode) {
+    /// Always store payment details for future use.
+    OPPCheckoutStorePaymentDetailsModeAlways,
+    /// Display the option to prompt the user permissions to store payment details for future use.
+    OPPCheckoutStorePaymentDetailsModePrompt,
+    /// Never store payment details.
+    OPPCheckoutStorePaymentDetailsModeNever
+};
+
+/// An enumeration for the possible modes to skip CVV check.
+typedef NS_ENUM(NSInteger, OPPCheckoutSkipCVVMode) {
+    /// Always request CVV for card payments.
+    OPPCheckoutSkipCVVModeNever,
+    /// Skip CVV check only for payments by stored cards.
+    OPPCheckoutSkipCVVModeForStoredCards,
+    /// Always skip CVV check. CVV field won't be displayed in card payment forms.
+    OPPCheckoutSkipCVVModeAlways
+};
+
+/// An enumeration for the possible display modes of card brands on payment method selection screen.
+typedef NS_ENUM(NSInteger, OPPCheckoutCardBrandsDisplayMode) {
+    /// Display card brands in the list along with other payment methods.
+    OPPCheckoutCardBrandsDisplayModeSeparate,
+    /// Display all card brands grouped in one row. This mode allows shopper to skip choosing concrete card brand, the brand will be detected automatically based on card number.
+    OPPCheckoutCardBrandsDisplayModeGrouped
+};
+
+/// An enumeration for the possible ways of automatic card brand detection
+typedef NS_ENUM(NSInteger, OPPCheckoutBrandDetectionType) {
+    /// Uses regular expressions to analyze card number (supports a limited number of brands)
+    OPPCheckoutBrandDetectionTypeRegex,
+    /// Searches card bin in the bin list (more precise)
+    OPPCheckoutBrandDetectionTypeBinList
+};
+
+/**
+ Class which encapsulates settings for the built-in in-App payment page. Use this to customize both the visual elements of the payment pages as well as functionality. This includes changing colors and texts, defining payment methods.
+ */
+NS_ASSUME_NONNULL_BEGIN
+@interface OPPCheckoutSettings : NSObject
+
+/// @name Properties
+
+/**
+ The custom theme for the payment forms. Default is `OPPCheckoutThemeStyleLight`.
+ @see `OPPCheckoutThemeStyle`
+ */
+@property (nonatomic, readonly) OPPCheckoutTheme *theme;
+
+/**
+ This URL will receive the result of an asynchronous payment. Must be sent URL encoded.
+ */
+@property (nonatomic, copy, nullable) NSString *shopperResultURL;
+
+/**
+ The list of payment brands to be shown.
+ */
+@property (nonatomic, copy) NSArray<NSString *> *paymentBrands;
+
+/** 
+ A constant that specifies the store payment details mode. Default is `OPPCheckoutStorePaymentDetailsModeNever`.
+ */
+@property (nonatomic) OPPCheckoutStorePaymentDetailsMode storePaymentDetails;
+
+/**
+ A constant that specifies whether request CVV or not. Default is `OPPCheckoutSkipCVVModeNever`.
+ */
+@property (nonatomic) OPPCheckoutSkipCVVMode skipCVV;
+
+/**
+ A flag that specifies whether show card holder name in the card detail view or not. Default is `YES`.
+ */
+@property (nonatomic, getter=isCardHolderVisible) BOOL cardHolderVisible;
+
+/**
+ List of possible numbers of installments.
+ */
+@property (nonatomic, copy) NSArray<NSNumber *> *installmentOptions;
+
+/**
+ A flag that specifies whether payment should be split into installments.
+ */
+@property (nonatomic, getter=isInstallmentEnabled) BOOL installmentEnabled;
+
+/**
+ Set of security policies to confirm payment. 
+ Increase security for tokens or specific payment methods with Touch ID/Face ID or passcode.
+ */
+@property (nonatomic, copy, nullable) NSArray<OPPSecurityPolicy *> *securityPolicies;
+
+/**
+ The language used for language specific labels in ISO 639-1 language identifier.
+ If the language is not supported English will be used.
+ If language is `nil`, app wil use the first supported language from language settings.
+ */
+@property (nonatomic, copy, nullable) NSString *language;
+
+/** Encapsulates a request for payment, including information about payment processing capabilities and the payment amount. */
+@property (nonatomic, nullable) PKPaymentRequest *applePayPaymentRequest;
+
+/** Sets the country to be used for Klarna checkout in ISO 3166-1 alpha-2 country identifier. By default, uses `countryCode` from device locale if supported. Otherwise, use `DE`. */
+@property (nonatomic, copy, nullable) NSString *klarnaCountry;
+
+/** Sets the fee to be used for the "Billing agreement" link during a Klarna Invoice checkout. */
+@property (nonatomic, nullable) NSDecimalNumber *klarnaInvoiceFee;
+
+/** Sets the fee to be used for the "Read more" link during a Klarna Installments checkout. */
+@property (nonatomic, nullable) NSDecimalNumber *klarnaInstallmentsFee;
+
+/**
+ A flag that specifies whether show IBAN field on the Giropay payment form or not. Default is `NO`.
+ */
+@property (nonatomic, getter=isIBANRequired) BOOL IBANRequired;
+
+/**
+ A mode that specifies how to display card brands on payment method selection screen.
+ Default is `OPPCheckoutCardBrandsDisplayModeGrouped`.
+ */
+@property (nonatomic) OPPCheckoutCardBrandsDisplayMode cardBrandsDisplayMode;
+
+/**
+ A flag that specifies whether show total amount in the checkout or not.
+ If `YES`, amount is shown on the payment method selection screen and in the 'Pay' buttons.
+ Default is `NO`.
+ */
+@property (nonatomic) BOOL displayTotalAmount;
+
+/**
+ Type of automatic card brand detection to be used.
+ Default is `OPPCheckoutBrandDetectionTypeRegex`.
+ */
+@property (nonatomic) OPPCheckoutBrandDetectionType brandDetectionType;
+
+/**
+ Sets the preferred order of the detected card brands to be shown under the card number text field.
+ By default order from `paymentBrands` is used.
+ */
+@property (nonatomic, copy) NSArray<NSString *> *brandDetectionPriority;
+
+/**
+ A flag that specifies whether show multiple detected brands under card number text field or keep them hidden by default.
+ Default is `YES`.
+ */
+@property (nonatomic) BOOL showDetectedBrands;
+
+/// @name Deprecated
+
+/**
+ The custom URL scheme for your app. This must be configured if your app integrates a payment option that may switch to either Mobile Safari or to another app to finish the payment authorization workflow.
+ @warning **Deprecated**. The property is no longer used.
+ */
+@property (nonatomic, copy) NSString *schemeURL DEPRECATED_ATTRIBUTE;
+
+/**
+ The description to show on the payment page above the total amount.
+ @warning **Deprecated**. The property is no longer used.
+ */
+@property (nonatomic, copy, nullable) NSString *paymentTitle DEPRECATED_ATTRIBUTE;
+
+/**
+ The payment methods to be shown. Expected an `NSArray` of `NSNumbers` representing different `OPPCheckoutPaymentMethod` enums.
+ @warning **Deprecated**. Use `paymentBrands` instead.
+ */
+@property (nonatomic, copy) NSArray<NSNumber *> *paymentMethods DEPRECATED_ATTRIBUTE;
+
+@end
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.framework/Headers/OPPCheckoutTheme.h

@@ -0,0 +1,268 @@
+//
+// Copyright (c) 2019 by ACI Worldwide, Inc.
+// All rights reserved.
+//
+// This software is the confidential and proprietary information
+// of ACI Worldwide Inc ("Confidential Information"). You shall
+// not disclose such Confidential Information and shall use it
+// only in accordance with the terms of the license agreement
+// you entered with ACI Worldwide Inc.
+//
+
+@import Foundation;
+@import UIKit;
+
+/**
+ An enumeration of the in-App payment pages styles.
+ */
+typedef NS_ENUM(NSInteger, OPPCheckoutThemeStyle) {
+    /// Ready to use light style for the payment pages.
+    OPPCheckoutThemeStyleLight,
+    /// Ready to use dark style for the payment pages.
+    OPPCheckoutThemeStyleDark
+};
+
+/**
+ Class which used to visually style in-App payment pages by customizing colors and fonts.
+ There are two ready to use styles. You can leave it as is or override some properties.
+ */
+
+NS_ASSUME_NONNULL_BEGIN
+@interface OPPCheckoutTheme : NSObject
+
+/// @name Designated initializer
+
+/** 
+ Creates and returns theme initialized with the `OPPCheckoutThemeStyle`.
+ @param style Style for checkout screens.
+ */
+- (instancetype)initWithThemeStyle:(OPPCheckoutThemeStyle)style NS_DESIGNATED_INITIALIZER;
+
+/// @name Properties
+/**
+ Predefined style for checkout screens (default is light theme).
+ */
+@property (nonatomic) OPPCheckoutThemeStyle style;
+
+/// @name General colors of the payment pages UI
+
+/**
+ Background color for any views in this theme.
+ */
+@property (nonatomic) UIColor *primaryBackgroundColor;
+
+/**
+ Text color for any important labels in a view.
+ */
+@property (nonatomic) UIColor *primaryForegroundColor;
+
+/**
+ The color of the confirmation buttons.
+ */
+@property (nonatomic) UIColor *confirmationButtonColor;
+
+/**
+ Accent color used for active elements (like text fields, switch element).
+ */
+@property (nonatomic) UIColor *accentColor;
+
+/**
+ Text color for confirmation buttons.
+ */
+@property (nonatomic) UIColor *confirmationButtonTextColor;
+
+/**
+ Input field text color.
+ */
+@property (nonatomic) UIColor *textFieldTextColor;
+
+/**
+ Placeholder color for text fields.
+ */
+@property (nonatomic) UIColor *textFieldPlaceholderColor;
+
+/**
+ Border color of inactive text field. accentColor is used for active state.
+ */
+@property (nonatomic) UIColor *textFieldBorderColor;
+
+/**
+ Color for rendering any error messages or views.
+ */
+@property (nonatomic) UIColor *errorColor;
+
+/// @name Activity indicator views
+
+/**
+ Indicator view processing style that is shown over primary background color.
+ */
+@property (nonatomic) UIActivityIndicatorViewStyle activityIndicatorPrimaryStyle;
+
+/**
+ Indicator view processing style that is shown over secondary background color.
+ */
+@property (nonatomic) UIActivityIndicatorViewStyle activityIndicatorSecondaryStyle;
+
+
+/// @name Navigation bar customization
+
+/**
+ Navigation bar tint color.
+ */
+@property (nonatomic) UIColor *navigationBarTintColor;
+
+/**
+ Navigation bar background color.
+ */
+@property (nonatomic) UIColor *navigationBarBackgroundColor;
+
+/**
+ Text attributes for navigation bar title.
+ */
+@property (nonatomic, copy) NSDictionary *navigationBarTextAttributes;
+
+/**
+Text attributes for navigation bar item titles.
+ */
+@property (nonatomic, copy, nullable) NSDictionary *navigationItemTextAttributes;
+
+/**
+ Custom text for the right bar button in the navigation bar.
+ Localized text is expected. SDK is NOT localizing this text.
+ Default value is "Cancel".
+ */
+@property (nonatomic, copy, nullable) NSString *cancelBarButtonText;
+
+/**
+ Custom image for the right bar button in the navigation bar.
+ If image is not set `cancelBarButtonText` is shown.
+ */
+@property (nonatomic, nullable) UIImage *cancelBarButtonImage;
+
+
+/// @name Payment method list customization
+
+/*
+Tint color for cell on the table view.
+ */
+@property (nonatomic) UIColor *cellTintColor;
+
+/**
+ Highlighted background color for cell on the table view.
+ */
+@property (nonatomic) UIColor *cellHighlightedBackgroundColor;
+
+/**
+ Text label highlighted color.
+ */
+@property (nonatomic) UIColor *cellHighlightedTextColor;
+
+/**
+ Text font for cell on the table view.
+ */
+@property (nonatomic) UIFont *cellTextFont;
+
+
+/**
+ Background color of section.
+ */
+@property (nonatomic) UIColor *sectionBackgroundColor;
+
+/**
+ Text color of section title.
+ */
+@property (nonatomic) UIColor *sectionTextColor;
+
+/**
+ Font of section title.
+ */
+@property (nonatomic) UIFont *sectionFont;
+
+/**
+ Color for separator lines.
+ */
+@property (nonatomic) UIColor *separatorColor;
+
+/**
+ Background color for payment brand icons.
+ */
+@property (nonatomic) UIColor *paymentBrandIconBackgroundColor;
+
+/**
+ Border color for payment brand icons.
+ */
+@property (nonatomic) UIColor *paymentBrandIconBorderColor;
+
+/**
+ Background color for stored payment method icons.
+ */
+@property (nonatomic) UIColor *storedPaymentMethodIconBackgroundColor;
+
+/**
+ Border color for stored payment method icons.
+ */
+@property (nonatomic) UIColor *storedPaymentMethodIconBorderColor;
+
+
+/// @name Fonts customization
+
+/**
+ Text font for any important labels in a view.
+ */
+@property (nonatomic) UIFont *primaryFont;
+
+/**
+ Text font for any other labels in a view.
+ */
+@property (nonatomic) UIFont *secondaryFont;
+
+/**
+ Text font for any text fields.
+ */
+@property (nonatomic) UIFont *textFieldFont;
+
+/**
+ Text font for confirmation button.
+ */
+@property (nonatomic) UIFont *confirmationButtonFont;
+
+/**
+ Text font for rendering any error messages.
+ */
+@property (nonatomic) UIFont *errorFont;
+
+/**
+ Text font for amount label.
+ */
+@property (nonatomic) UIFont *amountLabelFont;
+
+
+/// @name Deprecated
+
+/**
+ Background color for payment method icons.
+ @warning **Deprecated:** Use `paymentBrandIconBackgroundColor` instead.
+ */
+@property (nonatomic) UIColor *paymentMethodIconBackgroundColor DEPRECATED_ATTRIBUTE;
+
+/**
+ Background color of text fields.
+ @warning **Deprecated:** since 2.11.0.
+ */
+@property (nonatomic) UIColor *textFieldBackroundColor DEPRECATED_ATTRIBUTE;
+
+/**
+ Background color for any supplemental views inside a view.
+ @warning **Deprecated:** The property is no longer used.
+ */
+@property (nonatomic) UIColor *secondaryBackgroundColor DEPRECATED_ATTRIBUTE;
+
+/**
+ Text color for any supplementary labels in a view.
+ @warning **Deprecated:** The property is no longer used.
+ */
+@property (nonatomic) UIColor *secondaryForegroundColor DEPRECATED_ATTRIBUTE;
+
+
+@end
+NS_ASSUME_NONNULL_END