react-native-hyperpay-sdk 0.39.0 → 1.0.1

package/OPPWAMobile.xcframework/Info.plist

@@ -5,27 +5,29 @@
 	<key>AvailableLibraries</key>
 	<array>
 		<dict>
+			<key>BinaryPath</key>
+			<string>OPPWAMobile.framework/OPPWAMobile</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_armv7</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
 			<string>OPPWAMobile.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>armv7</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
 		</dict>
 		<dict>
+			<key>BinaryPath</key>
+			<string>OPPWAMobile.framework/OPPWAMobile</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_i386_x86_64-simulator</string>
+			<string>ios-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>OPPWAMobile.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>i386</string>
 				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>

package/OPPWAMobile.xcframework/ios-arm64/OPPWAMobile.framework/Headers/NSString+Security.h

@@ -0,0 +1,13 @@
+//  © Copyright ACI Worldwide, Inc. 2018, 2026
+
+@import Foundation;
+
+/// :nodoc:
+@interface NSString (Security)
+
+- (nonnull NSData *)data;
+- (nullable NSData *)data64Encoded;
+
+- (void)wipe;
+
+@end

package/OPPWAMobile.xcframework/ios-arm64/OPPWAMobile.framework/Headers/OPPAffirmProcessor.h

@@ -0,0 +1,43 @@
+//  © Copyright ACI Worldwide, Inc. 2018, 2026
+
+#import <Foundation/Foundation.h>
+#import "OPPPaymentProvider.h"
+@class OPPTransaction;
+/**
+ Completion block for affirm payment processing.
+ */
+typedef void (^CompletionBlock)(OPPTransaction * _Nonnull, NSError * _Nullable);
+
+
+NS_ASSUME_NONNULL_BEGIN
+/**
+ Class to process affirm transaction.
+ */
+@interface OPPAffirmProcessor : NSObject
+
+/// :nodoc:
+- (instancetype)init NS_UNAVAILABLE;
+
+/**
+ Creates an object representing an affirm processor.
+ 
+ @param transaction Transaction object to process, and it should not be nil.
+ @param mode Provider mode to set environment.
+ @param error Error occured while initializing the processor.
+ @return Returns an object representing an affirm processor.
+ */
+- (nullable instancetype)initWithTransaction:(nonnull OPPTransaction *)transaction
+                                        mode:(OPPProviderMode)mode
+                                       error:(NSError * _Nullable __autoreleasing * _Nullable)error;
+/**
+ Method to process affirm transaction
+ 
+ @param presentingViewController Viewcontroller to present affirm transaction processing view.
+ @param completionBlock Completion block to handle transaction or error.
+ */
+- (void)process:(nonnull UIViewController *)presentingViewController
+           with:(nonnull CompletionBlock)completionBlock;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.xcframework/ios-arm64/OPPWAMobile.framework/Headers/OPPAfterpayUtil.h

@@ -0,0 +1,19 @@
+//  © Copyright ACI Worldwide, Inc. 2018, 2026
+
+#import <Foundation/Foundation.h>
+
+@class OPPTransaction;
+
+/// :nodoc:
+NS_ASSUME_NONNULL_BEGIN
+
+@interface OPPAfterpayUtil : NSObject
+
++ (nullable NSError *)configureAfterPayFamilyBrandsWithTransaction:(nonnull OPPTransaction *)transaction;
++ (void)showAfterPayViewController:(nonnull NSURL *)url
+                       transaction:(nonnull OPPTransaction *)transaction
+                        completion:(void (^ _Nonnull)(NSString * _Nonnull))completion;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.xcframework/ios-arm64/OPPWAMobile.framework/Headers/OPPCardDetailsComponent.h

@@ -0,0 +1,23 @@
+//  © Copyright ACI Worldwide, Inc. 2018, 2026
+
+
+#import <Foundation/Foundation.h>
+#import <UIKit/UIKit.h>
+@class OPPCheckoutProvider;
+@class OPPToken;
+
+/// :nodoc:
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface OPPCardDetailsComponent : NSObject
+- (nullable instancetype)initWithCheckoutProvider:(OPPCheckoutProvider *)checkoutProvider 
+                                     paymentBrand:(NSString *)paymentBrand
+                                   viewController:(UIViewController *)viewController;
+- (nullable instancetype)initWithCheckoutProvider:(OPPCheckoutProvider *)checkoutProvider 
+                                            token:(OPPToken *)token
+                                   viewController:(UIViewController *)viewController;
+- (instancetype)init NS_UNAVAILABLE;
+@end
+
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.xcframework/ios-arm64/OPPWAMobile.framework/Headers/OPPCardDetailsModel+BrandDetection.h

@@ -0,0 +1,16 @@
+//  © Copyright ACI Worldwide, Inc. 2018, 2026
+
+
+#import "OPPCardDetailsModel.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// :nodoc:
+
+@interface OPPCardDetailsModel (BrandDetection)
+- (void)cmb_detectBrandsForCardNumber:(nullable NSString *)cardNumber
+                           completion:(void(^)(NSArray<NSString *> * _Nullable detectedBrands, NSError * _Nullable error))completion;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.xcframework/ios-arm64/OPPWAMobile.framework/Headers/OPPCardDetailsModel+Validation.h

@@ -0,0 +1,21 @@
+//  © Copyright ACI Worldwide, Inc. 2018, 2026
+
+
+#import "OPPCardDetailsModel.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// :nodoc:
+
+@interface OPPCardDetailsModel (Validation)
+- (nullable NSString *)cmv_validateCardNumber:(NSString *)cardNumber paymentBrand:(NSString *)paymentBrand;
+- (nullable NSString *)cmv_validateCardHolderName:(NSString *)cardHolderName;
+- (nullable NSString *)cmv_validateCardExpiryDate:(NSString *)expiryDate paymentBrand:(NSString *)paymentBrand;
+- (nullable NSString *)cmv_validateCVV:(NSString *)cvv paymentBrand:(NSString *)paymentBrand;
+- (nullable NSString *)cmv_validateCountryCode:(NSString *)countryCode;
+- (nullable NSString *)cmv_validateMobilePhone:(NSString *)mobilePhone;
+@end
+
+
+
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.xcframework/ios-arm64/OPPWAMobile.framework/Headers/OPPCardDetailsModel+Visibility.h

@@ -0,0 +1,16 @@
+//  © Copyright ACI Worldwide, Inc. 2018, 2026
+
+
+#import "OPPCardDetailsModel.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// :nodoc:
+
+@interface OPPCardDetailsModel (Visibility)
+- (BOOL)cmv_shouldHideHolderName;
+- (BOOL)cmv_shouldHideCVV;
+- (BOOL)cmv_shouldHidePhone;
+@end
+
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.xcframework/ios-arm64/OPPWAMobile.framework/Headers/OPPCardDetailsModel.h

@@ -0,0 +1,47 @@
+//  © Copyright ACI Worldwide, Inc. 2018, 2026
+
+
+#import <Foundation/Foundation.h>
+@class OPPCheckoutProvider;
+@class OPPToken;
+@class OPPCheckoutSettings;
+@class OPPBillingAddress;
+@import SafariServices;
+@class OPPPaymentParams;
+@class OPPTokenPaymentParams;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// :nodoc:
+
+@interface OPPCardDetailsModel : NSObject
+
+- (instancetype)init NS_UNAVAILABLE;
+- (nullable instancetype)initWithCheckoutProvider:(OPPCheckoutProvider *)checkoutProvider
+                                     paymentBrand:(NSString *)paymentBrand;
+- (nullable instancetype)initWithCheckoutProvider:(OPPCheckoutProvider *)checkoutProvider
+                                            token:(OPPToken *)token;
+
+@property (nonatomic, nullable) OPPCheckoutProvider *checkoutProvider;
+@property (nonatomic) OPPCheckoutSettings *checkoutSettings;
+@property (nonatomic, copy) NSString *paymentBrand;
+@property (nonatomic, nullable) OPPToken *token;
+@property (nonatomic, nullable) OPPBillingAddress *address;
+@property (nonatomic, assign) NSUInteger numberOfInstallments;
+@property (nonatomic, copy) NSString *initialPaymentBrand;
+@property (nonatomic, assign) BOOL storePaymentDetails;
+@property (nonatomic, copy) NSArray<NSString *> *detectedBrands;
+
+- (void)resetBinCache;
+- (nullable OPPPaymentParams *)preparePaymentParamsWithCardNumber:(NSString *)cardNumber
+                                                       holderName:(nullable NSString *)holderName
+                                                      expiryMonth:(nullable NSString *)expiryMonth
+                                                       expiryYear:(nullable NSString *)expiryYear
+                                                              CVV:(nullable NSString *)CVV
+                                                      countryCode:(nullable NSString *)countryCode
+                                                      phoneNumber:(nullable NSString *)phoneNumber;
+
+- (nullable OPPPaymentParams *)prepareTokenPaymentParamsWithCVV:(nullable NSString *)CVV;
+
+@end
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.xcframework/ios-arm64/OPPWAMobile.framework/Headers/OPPCardDetailsProtocol.h

@@ -0,0 +1,161 @@
+//  © Copyright ACI Worldwide, Inc. 2018, 2026
+
+
+#import <Foundation/Foundation.h>
+#import <UIKit/UIKit.h>
+@protocol OPPCardControllerDelegate;
+@class OPPBillingAddress;
+@class OPPCheckoutSettings;
+@class OPPToken;
+
+/**
+ Class to encapsulate the CardDetails ViewController protocols,
+ */
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ A protocol collects card details and additional information required for card payment.
+ */
+@protocol OPPCardDetailsDataSource <NSObject>
+
+/**
+ CardDetails ViewController delegate.
+ */
+@property (nonatomic, nullable) id<OPPCardControllerDelegate> cardControllerDelegate;
+
+/**
+ A method to get custom View Controller card number TextField.
+ @return an `UITextField` object to the view model.
+*/
+- (UITextField *)cardControllerCardNumberTextField;
+
+/**
+ A method to get custom View Controller card holder TextField.
+ @return an `UITextField` object to the view model.
+*/
+- (UITextField *)cardControllerCardHolderTextField;
+
+/**
+ A method to get custom View Controller expiration date TextField.
+ @return an `UITextField` object to the view model.
+*/
+- (UITextField *)cardControllerExpirationDateTextField;
+
+/**
+ A method to get custom View Controller CVV TextField.
+ @return an `UITextField` object to the view model.
+*/
+- (UITextField *)cardControllerCVVTextField;
+@optional
+
+/**
+ A method to get custom View Controller country code TextField.
+ @return an `UITextField` object to the view model.
+*/
+- (UITextField *)cardControllerCountryCodeField;
+
+/**
+ A method to get custom View Controller phone number TextField.
+ @return an `UITextField` object to the view model.
+*/
+- (UITextField *)cardControllerMobilePhoneField;
+
+/**
+ A method to listen for TextViews validation errors.
+ @param textField Validated TextField.
+ @param error error object.
+*/
+- (void)cardControllerTextField:(UITextField *)textField errorDidHappen:(nullable NSError *)error;
+
+/**
+ A method to listen for TextViews visibility changes.
+ @param textField changed TextField.
+ @param hidden indecates if TextField is changed visibility.
+*/
+- (void)cardControllerTextField:(UITextField *)textField shouldChangeVisibility:(BOOL)hidden;
+
+/**
+ A method to listen for detected payment brands..
+ @param paymentBrands an array of detected payment brands..
+ @param error error object, `nil` payment brands detected successfully.
+*/
+- (void)cardControllerOnPaymentBrandsDetected:(nullable NSArray<NSString *> *)paymentBrands error:(nullable NSError *)error;
+@end
+
+/**
+ A protocol for CardDetails ViewModel delegate.
+*/
+@protocol OPPCardControllerDelegate <NSObject>
+
+/**
+ A method intended to run right after custom View Controller viewDidLoad method.
+*/
+- (void)viewControllerDidLoaded;
+
+/**
+ A method for canceling current checkout session.
+*/
+- (void)cancelCheckout;
+
+/**
+ A method for submitting payment transaction.
+ @param completionHandler for handling payment parameters preparation status.
+*/
+- (void)submitPaymentTransactionWithCompletionHandler:(nullable void (^)(BOOL result))completionHandler;
+
+/**
+ A method for checking if card scanning capability is enabled.
+ @return BOOL status.
+*/
+- (BOOL)isCardScanAvailable;
+
+/**
+ A method to start card scanning View Controller.
+*/
+- (void)startCardScan;
+
+/**
+ A method to get current payment brand.
+ @return an `NSString` object.
+*/
+- (NSString *)paymentBrand;
+
+/**
+ A method to get checkout settings.
+ @returns an `OPPCheckoutSettings` object.
+*/
+- (OPPCheckoutSettings *)checkoutSettings;
+
+/**
+ A method to get a token.
+ @returns an `OPPToken` object, or `nil` if token is empty.
+*/
+- (nullable OPPToken *)token;
+
+/**
+ A method to set number of installments.
+ @param numberOfInstallments set number of installments.
+*/
+- (void)updateNumberOfInstallments:(NSUInteger)numberOfInstallments;
+
+/**
+ A method to set billing address.
+ @param billingAddress set payment billing address.
+*/
+- (void)updateBillingAddress:(nullable OPPBillingAddress *)billingAddress;
+
+/**
+ A method to change current payment brand.
+ @param paymentBrand set payment brand.
+*/
+- (void)changePaymentBrand:(NSString *)paymentBrand;
+
+/**
+ A method to enable storing payment details.
+ @param store set YES to store payment details.
+*/
+- (void)storePaymentDetails:(BOOL)store;
+@end
+
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.xcframework/ios-arm64/OPPWAMobile.framework/Headers/OPPCardDetailsViewModel+TextDelegate.h

@@ -0,0 +1,19 @@
+//  © Copyright ACI Worldwide, Inc. 2018, 2026
+
+
+#import "OPPCardDetailsViewModel.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// :nodoc:
+
+@interface OPPCardDetailsViewModel (TextDelegate)
+- (void)cvt_assignTextDelegate;
+- (void)textFieldDidBeginEditing:(UITextField *)textField;
+- (void)textFieldDidEndEditing:(UITextField *)textField;
+- (BOOL)textFieldShouldReturn:(UITextField *)textField;
+- (BOOL)textField:(UITextField *)textField shouldChangeCharactersInRange:(NSRange)range replacementString:(NSString *)string;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.xcframework/ios-arm64/OPPWAMobile.framework/Headers/OPPCardDetailsViewModel+Visibility.h

@@ -0,0 +1,14 @@
+//  © Copyright ACI Worldwide, Inc. 2018, 2026
+
+
+#import "OPPCardDetailsViewModel.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// :nodoc:
+
+@interface OPPCardDetailsViewModel (Visibility)
+- (void)cvv_initialVisibilityCheck;
+@end
+
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.xcframework/ios-arm64/OPPWAMobile.framework/Headers/OPPCardDetailsViewModel.h

@@ -0,0 +1,48 @@
+//  © Copyright ACI Worldwide, Inc. 2018, 2026
+
+
+#import <Foundation/Foundation.h>
+#import "OPPCardDetailsProtocol.h"
+@class OPPCheckoutProvider;
+@class OPPToken;
+@import SafariServices;
+@class OPPCardDetailsModel;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// :nodoc:
+
+@interface OPPCardDetailsViewModel : NSObject
+
+@property (nonatomic, nonnull) OPPCardDetailsModel *model;
+@property (nonatomic, strong) UIViewController<OPPCardDetailsDataSource> *controller;
+
+//UI
+@property (nonatomic, nullable) UITextField *cardHolderField;
+@property (nonatomic, nullable) UITextField *cardNumberField;
+@property (nonatomic, nullable) UITextField *expiryDateField;
+@property (nonatomic, nullable) UITextField *cvvField;
+@property (nonatomic, nullable) UITextField *countryCodeField;
+@property (nonatomic, nullable) UITextField *mobilePhoneField;
+
+- (instancetype)init NS_UNAVAILABLE;
+- (nullable instancetype)initWithCheckoutProvider:(OPPCheckoutProvider *)checkoutProvider
+                                     paymentBrand:(NSString *)paymentBrand viewController:(UIViewController *)viewController;
+- (nullable instancetype)initWithCheckoutProvider:(OPPCheckoutProvider *)checkoutProvider
+                                            token:(OPPToken *)token viewController:(UIViewController *)viewController;
+
+- (NSString *)paymentBrand;
+- (nullable OPPToken *)token;
+- (BOOL)isCardScanAvailable;
+- (void)startCardScan;
+- (void)cancelCheckout;
+- (void)changePaymentBrand:(nonnull NSString *)paymentBrand;
+- (void)storePaymentDetails:(BOOL)store;
+- (void)updateBillingAddress:(nullable OPPBillingAddress *)billingAddress;
+- (void)updateNumberOfInstallments:(NSUInteger)numberOfInstallments;
+- (void)submitPaymentTransactionWithCompletionHandler:(nullable void (^)(BOOL result))completionHandler;
+- (void)focusOnTextField:(UITextField *)textField;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.xcframework/ios-arm64/OPPWAMobile.framework/Headers/OPPCashAppPayProcessor.h

@@ -0,0 +1,35 @@
+//  © Copyright ACI Worldwide, Inc. 2018, 2026
+
+#import <Foundation/Foundation.h>
+@class OPPTransaction;
+
+/**
+ Completion block for Cash App Pay payment processing.
+ */
+typedef void (^CompletionBlock)(OPPTransaction * _Nonnull, NSError * _Nullable);
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ Class to process Cash App Pay Payments transaction.
+ */
+@interface OPPCashAppPayProcessor : NSObject
+
+/**
+ Creates an object representing an Cash App Pay processor.
+ 
+ @param transaction transaction to process, and it should not be nil.
+ @param error The error that occurred while processing transaction. See code attribute (`OPPErrorCode`) and `NSLocalizedDescription` to identify the reason of failure.
+ @return Returns an object representing an Cash App Pay processor.
+ */
+- (nullable instancetype)initWithTransaction:(nonnull OPPTransaction *)transaction
+                                       error:(NSError * _Nullable *)error;
+
+/**
+ Method to process Cash App Pay transaction.
+ */
+- (void)process:(nonnull CompletionBlock)completionBlock;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.xcframework/ios-arm64/OPPWAMobile.framework/Headers/OPPCheckoutApplePayContactType.h

@@ -0,0 +1,12 @@
+//  © Copyright ACI Worldwide, Inc. 2018, 2026
+
+#import <Foundation/Foundation.h>
+#import <PassKit/PassKit.h>
+
+/// An enumeration for the ApplePay contact types
+typedef NS_OPTIONS(NSInteger, OPPCheckoutApplePayContactType) {
+    /// ApplePay billing contact type
+    OPPCheckoutApplePayContactTypeBillingAddress = 1,
+    /// ApplePay shipping contact type
+    OPPCheckoutApplePayContactTypeCustomer = 2
+};