react-native-hyperpay-sdk 0.16.0 → 0.17.0

package/ios/OPPWAMobile.xcframework/ios-arm64_armv7/OPPWAMobile.framework/Headers/OPPPaymentProvider.h

@@ -0,0 +1,212 @@
+//
+// Copyright (c) $$year$$ 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 OPPTransaction;
+@class OPPPaymentParams;
+@class OPPCheckoutInfo;
+@class OPPThreeDSConfig;
+@class OPPBinInfo;
+
+/// An enumeration for the various provider modes.
+typedef NS_ENUM(NSInteger, OPPProviderMode) {
+    /// Sandbox environment for testing integration.
+    OPPProviderModeTest,
+    /// Live server for real transactions.
+    OPPProviderModeLive
+};
+
+/// An enumeration for server endpoint domain.
+typedef NS_ENUM(NSInteger, OPPProviderDomain) {
+    /// oppwa.com for Live server mode, test.oppwa.com for Sandbox mode.
+    OPPProviderDomainDefault,
+    /// eu-prod.oppwa.com for Live server mode, eu-test.oppwa.com for Sandbox mode.
+    OPPProviderDomainEU
+};
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ A protocol to handle 3-D Secure workflow.
+ */
+@protocol OPPThreeDSEventListener <NSObject>
+@optional
+
+/**
+ Called before initialization of `OPPThreeDSService`.
+ Use this callback to provide `OPPThreeDSConfig` configurations applied during `OPPThreeDSService` initialization phase.
+ @param completion The completion block you should call to continue 3-D Secure transaction.
+ */
+- (void)onThreeDSConfigRequiredWithCompletion:(void (^)(OPPThreeDSConfig *config))completion;
+
+/**
+ Called before starting the authentication process of 3-D Secure transaction.
+ Use this callback to provide UINavigationController, which will be used for 3-D Secure challenge process.
+ @param completion The completion block you should call to continue 3-D Secure transaction.
+ */
+- (void)onThreeDSChallengeRequiredWithCompletion:(void (^)(UINavigationController *navController))completion;
+
+@end
+
+/**
+ Defines the methods and properties of the payment provider. Use the factory method `+paymentProviderWithMode:` to instantiate a new provider.
+*/
+@interface OPPPaymentProvider : NSObject
+
+/// @name Properties
+
+/**
+ Determines the type of Server to use. Transactions to the LIVE server come with fees attached.
+*/
+@property (nonatomic) OPPProviderMode mode;
+
+/**
+ Determines Server endpoint domain.
+*/
+@property (nonatomic) OPPProviderDomain domain;
+
+/**
+ Delegate for processing the 3-D Secure transaction.
+ */
+@property (nonatomic, weak, nullable) id<OPPThreeDSEventListener> threeDSEventListener;
+
+/// @name Factory methods
+
+/**
+ Factory method to obtain a new provider.
+ @param mode Determines the type of Server to use. Transactions to the LIVE server come with fees attached.
+ @return An `OPPPaymentProvider` which can be used to process transactions.
+*/
++ (instancetype)paymentProviderWithMode:(OPPProviderMode)mode;
+
+/**
+ Factory method to obtain a new provider.
+ @param mode Determines the type of Server to use. Transactions to the LIVE server come with fees attached.
+ @param domain Determines Server endpoint domain.
+ @return An `OPPPaymentProvider` which can be used to process transactions.
+*/
++ (instancetype)paymentProviderWithMode:(OPPProviderMode)mode andDomain:(OPPProviderDomain)domain;
+
+
+/// @name Process transaction
+
+/**
+ On sending a transaction, it is performed asynchronously using an `NSURLSession` to communicate with the Server. Depending on the endpoint the transaction will be submitted or registered only without making the payment.
+ 
+ @param transaction The transaction to be sent.
+ @param endpoint The endpoint which will be used for processing transaction. The endpoint must start with a `"/"`.
+ @param completionHandler A block executed when the transaction is sent.
+ */
+- (void)sendTransaction:(OPPTransaction *)transaction toEndpoint:(NSString *)endpoint completionHandler:(void (^)(OPPTransaction *transaction, NSError * _Nullable error))completionHandler;
+
+/**
+ On submitting a transaction, it is performed asynchronously using an `NSURLSession` to communicate with the Server. Depending on the concrete type of the transaction, various calls to the server are necessary to ensure proper processing. Submitting means that the transaction is sent to the server, where it will cause a debit of the given amount on the account specified in the `OPPTransaction`'s `OPPPaymentParams`.
+ 
+ @param transaction The transaction to be submitted.
+ @param completionHandler A block executed when the transaction is submitted.
+*/
+- (void)submitTransaction:(OPPTransaction *)transaction completionHandler:(void (^)(OPPTransaction *transaction, NSError * _Nullable error))completionHandler;
+
+/**
+ On storing a payment data, it is performed asynchronously using an `NSURLSession` to communicate with the Server. The method creates a just registration separate from any later payment.
+ 
+ @param transaction The transaction to be registered.
+ @param completionHandler A block executed when the transaction is registered.
+ */
+- (void)registerTransaction:(OPPTransaction *)transaction completionHandler:(void (^)(OPPTransaction *transaction, NSError * _Nullable error))completionHandler;
+
+/// @name Request checkout info
+/**
+ Requests checkout details such as amount, currency and tokens from the Server by checkout ID.
+ Request is performed asynchronously using an `NSURLSession`.
+ 
+ @param checkoutID The checkout ID of a transaction.
+ @param completionHandler The completion block will be invoked once the response in received. On success, you will receive an instance of `OPPCheckoutInfo`; on failure, an error.
+ */
+- (void)requestCheckoutInfoWithCheckoutID:(NSString *)checkoutID completionHandler:(void (^)(OPPCheckoutInfo * _Nullable checkoutInfo, NSError * _Nullable error))completionHandler;
+
+/// @name Request URLs for payment brand logos
+/**
+ Requests logo URLs for specified payment brands.
+ Request is performed asynchronously using an `NSURLSession`.
+ 
+ @param paymentBrands The list of payment brands to get logos from the Server.
+ @param completionHandler The completion block will be invoked once the response in received. On success, you will receive a dictionary with URLs in format `<paymentBrand: URL>`; on failure, an error.
+ */
+- (void)requestLogoURLsForPaymentBrands:(NSArray<NSString *> *)paymentBrands completionHandler:(void (^)(NSDictionary<NSString *, NSURL *> * _Nullable URLs, NSError * _Nullable error))completionHandler;
+
+/// @name Request `OPPBinInfo` for provided card bin
+/**
+@note If you are using core SDK, please request checkout info by calling `-[OPPPaymentProvider requestCheckoutInfoWithCheckoutID:completionHandler:]` before requestBinInfo call. Checkout info call is essential part of the flow, error will be thrown otherwise.
+ 
+@param checkoutID The checkout ID of a transaction.
+@param bin First 6 or more digits of the card number.
+@param completionHandler The completion block will be invoked once the response in received. On success, you will receive an instance of `OPPBinInfo`; on failure, an error.
+ */
+- (void)requestBinInfoWithCheckoutID:(NSString *)checkoutID
+                                 bin:(NSString *)bin
+                   completionHandler:(void (^)(OPPBinInfo * _Nullable binInfo,
+                                               NSError * _Nullable error))completionHandler;
+
+/// @name Apple Pay methods
+/**
+ Determine whether this device can process Apple Pay payment requests using specific payment request. Your application should confirm that the user can make payments before attempting to authorize a payment. Your application may also want to alter its appearance or behavior when the user is not allowed to make payments.
+ 
+ @param request The return value of this method depends on the `supportedNetworks` property of this payment request.
+ 
+ @return `YES` if the user can authorize payments on this device using the payment request. `NO` if the user cannot authorize payments on these networks or if the user is restricted from authorizing payments.
+ */
++ (BOOL)canSubmitPaymentRequest:(PKPaymentRequest *)request;
+
+/**
+ Whether or not this device is capable of using Apple Pay. This checks both whether the user is running an iPhone 6/6+ or later, iPad Air 2 or later, or iPad mini 3 or later, as well as whether or not they have stored any cards in Apple Pay on their device.
+ 
+ @return Whether or not the user is currently able to pay with Apple Pay.
+ */
++ (BOOL)deviceSupportsApplePay;
+
+/**
+ A convenience method to return a `PKPaymentRequest` with sane default values. You will still need to configure the `paymentSummaryItems` property to indicate what the user is purchasing.
+ 
+ @param merchantIdentifier Your Apple Merchant ID, as obtained at https://developer.apple.com/account/ios/identifiers/merchant/merchantCreate.action
+ @param countryCode The merchant's ISO country code. We suggest using the country where your business is located.
+ @return A `PKPaymentRequest` with proper default values.
+ */
++ (PKPaymentRequest *)paymentRequestWithMerchantIdentifier:(NSString *)merchantIdentifier countryCode:(NSString *)countryCode;
+
+/// @name Device authentication
+
+/**
+ A convenience method to check if Touch ID, Face ID or passcode are set on user device.
+ @return `NO` if neither Touch ID/Face ID nor passcode are set, otherwise `YES`.
+ */
++ (BOOL)isDeviceAuthenticationAvailable;
+
+
+/// @name Deprecated
+
+/**
+ Requests list of payment brands for provided card bin.
+ Request is performed asynchronously using an NSURLConnection.
+ 
+ @note If you are using core SDK, please request checkout info by calling `-[OPPPaymentProvider requestCheckoutInfoWithCheckoutID:completionHandler:]` before requestPaymentBrandsForBin call. Checkout info call is essential part of the flow, error will be thrown otherwise.
+ @param bin First 6 or more digits of the card number.
+ @param completionHandler The completion block will be invoked once the response in received.
+ @warning **Deprecated:** Use `-requestBinInfoWithCheckoutID:bin:completionHandler:` instead.
+ */
+- (void)requestPaymentBrandsForBin:(NSString *)bin
+                        checkoutID:(NSString *)checkoutID
+                 completionHandler:(void (^)(NSArray <NSString *> * _Nullable paymentBrands,
+                                             NSError * _Nullable error))completionHandler DEPRECATED_MSG_ATTRIBUTE("- Use -requestBinInfoWithCheckoutID:bin:completionHandler: instead.");
+
+@end
+NS_ASSUME_NONNULL_END

package/ios/OPPWAMobile.xcframework/ios-arm64_armv7/OPPWAMobile.framework/Headers/OPPSTCPayPaymentParams.h

@@ -0,0 +1,60 @@
+//
+// Copyright (c) $$year$$ 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 "OPPPaymentParams.h"
+
+/**
+ Class to encapsulate all necessary transaction parameters for performing an STC Pay transaction.
+ */
+NS_ASSUME_NONNULL_BEGIN
+@interface OPPSTCPayPaymentParams : OPPPaymentParams
+
+///An enumeration of possible options to proceed STC Pay payment.
+typedef NS_ENUM(NSInteger, OPPSTCPayVerificationOption) {
+    /// Mobile phone number option.
+    OPPSTCPayVerificationOptionPhone,
+    /// QR-Code option.
+    OPPSTCPayVerificationOptionQRCode
+};
+
+/// @name Initialization
+
+/// :nodoc:
+- (instancetype)initWithCheckoutID:(NSString *)checkoutID
+                      paymentBrand:(NSString *)paymentBrand
+                             error:(NSError * _Nullable __autoreleasing *)error NS_UNAVAILABLE;
+
+/**
+Creates an object representing an STC Pay transaction.
+
+@param checkoutID The checkout ID of the transaction. Must be not `nil` or empty.
+@param verificationOption The verification option to proceed STC Pay transaction
+@param error The error that occurred while validating payment parameters. See code attribute (`OPPErrorCode`) and `NSLocalizedDescription` to identify the reason of failure.
+@return Returns an object representing an STC Pay transaction.
+*/
++ (nullable instancetype)stcPayPaymentParamsWithCheckoutID:(NSString *)checkoutID
+                                        verificationOption:(OPPSTCPayVerificationOption)verificationOption
+                                                     error:(NSError **)error;
+
+
+/**
+Checks if the mobile phone is filled with sufficient data to perform a transaction.
+
+@param mobilePhone The mobile phone number.
+@return `YES` if the mobile phone number contains digits only.
+*/
++ (BOOL)isMobilePhoneValid:(NSString *)mobilePhone;
+
+/// @name Properties
+/** Shopper's mobile phone number */
+@property (nonatomic, copy, nullable) NSString *phoneNumber;
+@end
+NS_ASSUME_NONNULL_END

package/ios/OPPWAMobile.xcframework/ios-arm64_armv7/OPPWAMobile.framework/Headers/OPPSecurityPolicy.h

@@ -0,0 +1,68 @@
+//
+// Copyright (c) $$year$$ 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>
+
+/// An enumeration for the possible modes of security policy.
+typedef NS_ENUM(NSInteger, OPPSecurityPolicyMode) {
+    /// Device authentication is required to complete payment. Payment method won't be displayed in the list if neither Touch ID/FACE ID nor passcode are set.
+    OPPSecurityPolicyModeDeviceAuthRequired,
+    /// Require device authentication only if Touch ID, Face ID or passcode are set.
+    OPPSecurityPolicyModeDeviceAuthRequiredIfAvailable,
+    /// Shopper don't have to provide Touch ID, Face ID or passcode to complete payment.
+    OPPSecurityPolicyModeDeviceAuthNotRequired
+};
+
+/**
+ Class which is used to apply security policy mode for the set of payment methods.
+ */
+NS_ASSUME_NONNULL_BEGIN
+@interface OPPSecurityPolicy : NSObject
+
+/// @name Initialization
+
+/**
+ Creates security policy for the list of payment methods with specified mode.
+ @param paymentBrands List of payment brands. Note that Apple Pay will be ignored, because device authentication is mandatory for this payment method.
+ @param mode Mode of security policy which will be applied to the `paymentBrands`.
+ */
++ (instancetype)securityPolicyWithPaymentBrands:(NSArray<NSString *> *)paymentBrands mode:(OPPSecurityPolicyMode)mode;
+
+/**
+ Creates security policy for tokens with specified mode.
+ @param mode Mode of security policy which will be applied for all tokens.
+ */
++ (instancetype)securityPolicyForTokensWithMode:(OPPSecurityPolicyMode)mode;
+
+/// :nodoc:
+- (instancetype)init NS_UNAVAILABLE;
+
+
+/// @name Properties
+
+/**
+ The mode of security policy.
+ */
+@property (nonatomic, readonly) OPPSecurityPolicyMode mode;
+
+/**
+ The list of payment brands.
+ */
+@property (nonatomic, copy, readonly, nullable) NSArray<NSString *> *paymentBrands;
+
+/**
+ The flag that defines whether mode is applied to `paymentBrands` or to all tokens.
+ */
+@property (nonatomic, readonly, getter=isTokenPolicy) BOOL tokenPolicy;
+
+@end
+NS_ASSUME_NONNULL_END

package/ios/OPPWAMobile.xcframework/ios-arm64_armv7/OPPWAMobile.framework/Headers/OPPThreeDS2Info.h

@@ -0,0 +1,108 @@
+//
+// Copyright (c) $$year$$ 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;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// Enumeration of possible statuses for 3-D Secure 2 authentication.
+typedef NS_ENUM(NSInteger, OPPThreeDS2Status) {
+    /// Authentication/verification successful.
+    OPPThreeDS2StatusAuthenticated,
+    
+    /// Not authentication/not verified, but a proof of attempted authentication/verification is provided.
+    OPPThreeDS2StatusAttemptProcessingPerformed,
+    
+    /// In-app challenge required; additional authentication is required using in-app challenge screens.
+    OPPThreeDS2StatusChallengeRequired,
+    
+    /// External challenge required; decoupled authentication confirmed.
+    OPPThreeDS2StatusDecoupledConfirmed,
+    
+    /// Not authenticated or account not verified, transaction denied.
+    OPPThreeDS2StatusDenied,
+    
+    /// Issuer is rejecting authentication/verification and request that authorisation not attempted.
+    OPPThreeDS2StatusRejected,
+    
+    /// Authentication/verification cannot be performed due to some technical or other problems.
+    OPPThreeDS2StatusFailed,
+    
+    /// Informational only; 3DS Requestor challenge preference acknowledged.
+    OPPThreeDS2StatusInformationalOnly,
+    
+    /// Authentication parameters are required.
+    OPPThreeDS2StatusAuthParamsRequired,
+    
+    /// Status is not defined.
+    OPPThreeDS2StatusUndefined
+};
+
+/**
+ Class to represent 3-D Secure 2 parameters.
+ */
+@interface OPPThreeDS2Info : NSObject
+
+/**
+ Status of 3-D Secure 2 authentication.
+ */
+@property (nonatomic, readonly) OPPThreeDS2Status authStatus;
+
+/**
+ Authentication response as json string required for launching in-app challenge screens.
+ */
+@property (nonatomic, copy, readonly, nullable) NSString *authResponse;
+
+/**
+ Protocol version of 3-D Secure 2.
+ */
+@property (nonatomic, copy, readonly, nullable) NSString *protocolVersion;
+
+/**
+ The callback URL string to send the params needed for 3-D Secure 2 authentication request.
+ */
+@property (nonatomic, copy, readonly, nullable) NSString *callbackURL;
+
+/**
+ Text provided by the ACS/Issuer to Cardholder during a Frictionless or Decoupled transaction.
+ */
+@property (nonatomic, copy, readonly, nullable) NSString *cardHolderInfo;
+
+/**
+ Creates 3DS info object with the provided status and authentication response.
+ @param authStatus Status of 3-D Secure authentication.
+ @param authResponse Authentication response as JSON string.
+ @return an `OPPThreeDS2Info` object.
+ */
+- (nullable instancetype)initWithAuthStatus:(OPPThreeDS2Status)authStatus
+                               authResponse:(nullable NSString *)authResponse NS_DESIGNATED_INITIALIZER;
+
+/**
+ Creates 3DS info object with the provided status and authentication response.
+ @param authStatus Status of 3-D Secure authentication.
+ @param authResponse Authentication response as JSON string.
+ @return an `OPPThreeDS2Info` object.
+*/
++ (nullable instancetype)threeDS2InfoWithAuthStatus:(OPPThreeDS2Status)authStatus
+                                       authResponse:(nullable NSString *)authResponse;
+
+/// :nodoc:
+- (instancetype)init NS_UNAVAILABLE;
+
+/**
+ Returns `YES` if in-app challenge is required, otherwise `NO`.
+ @return `YES` if in-app challenge is required, otherwise `NO`.
+ */
+- (BOOL)isChallengeRequired;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/OPPWAMobile.xcframework/ios-arm64_armv7/OPPWAMobile.framework/Headers/OPPThreeDSChallengeUiType.h

@@ -0,0 +1,27 @@
+//
+// Copyright (c) $$year$$ 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>
+
+/// An enumeration for the various types of UI for displaying challenge screens.
+/// @note An enumeration is represented by bitmask values that may be combined together. For example, it's valid to specify several options in an option set: `[.text, .html]`.
+typedef NS_OPTIONS(NSUInteger, OPPThreeDSChallengeUiType) {
+    /// Format for a one-time passcode (OTP) or text during a non-payment authentication transaction.
+    OPPThreeDSChallengeUiTypeText = 1,
+    /// Format that allows multiple options to be presented to the cardholder to obtain single response.
+    OPPThreeDSChallengeUiTypeSingleSelect = 2,
+    /// Format that allows multiple options to be presented to the Cardholder to obtain multiple response on single screen.
+    OPPThreeDSChallengeUiTypeMultiSelect = 4,
+    /// Format that allows to complete authentication outside of the merchant app, e.g. in issuer’s mobile app.
+    OPPThreeDSChallengeUiTypeOob = 8,
+    /// Format that allows to present issuer-specific designed html in a web view.
+    OPPThreeDSChallengeUiTypeHtml = 16
+};

package/ios/OPPWAMobile.xcframework/ios-arm64_armv7/OPPWAMobile.framework/Headers/OPPToken.h

@@ -0,0 +1,121 @@
+//
+// Copyright (c) $$year$$ 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 "OPPCard.h"
+#import "OPPBankAccount.h"
+#import "OPPVirtualAccount.h"
+#import "OPPPaymentParams.h"
+
+/**
+ Class to encapsulate shopper’s payment details that have been tokenized.
+ */
+
+NS_ASSUME_NONNULL_BEGIN
+@interface OPPToken : NSObject
+
+/// @name Properties
+
+/** The identifier of the token that can be used to reference the token later. */
+@property (nonatomic, copy, readonly) NSString *tokenID;
+
+/** The payment brand of the transaction. */
+@property (nonatomic, copy, readonly) NSString *paymentBrand;
+
+/** Shopper’s card details. */
+@property (nonatomic, readonly, nullable) OPPCard *card;
+
+/** Shopper’s bank account details. */
+@property (nonatomic, readonly, nullable) OPPBankAccount *bankAccount;
+
+/** Shopper’s virtual account details. */
+@property (nonatomic, readonly, nullable) OPPVirtualAccount *virtualAccount;
+
+/// @name Initialization
+
+/// :nodoc:
+- (instancetype)init NS_UNAVAILABLE;
+
+/**
+ Creates an `OPPToken` object from JSON.
+ @param JSON A dictionary with parameters received from the Server.
+ @return Returns an `OPPToken` object, or `nil` if JSON contains invalid values.
+ */
++ (nullable instancetype)tokenFromJSON:(NSDictionary *)JSON;
+
+/**
+ Creates an `OPPToken` object with provided card parameters.
+ @param tokenID The identifier of the token that can be used to reference the token later.
+ @param paymentBrand The payment brand.
+ @param card Shopper’s card details.
+ @return Returns an `OPPToken` object, or `nil` if parameters are empty.
+ */
++ (nullable instancetype)tokenWithTokenID:(NSString *)tokenID
+                             paymentBrand:(NSString *)paymentBrand
+                                     card:(OPPCard *)card;
+
+/**
+ Creates an `OPPToken` object with provided bank account parameters.
+ @param tokenID The identifier of the token that can be used to reference the token later.
+ @param paymentBrand The payment brand.
+ @param bankAccount Shopper’s bank account details.
+ @return Returns an `OPPToken` object, or `nil` if parameters are empty.
+ */
++ (nullable instancetype)tokenWithTokenID:(NSString *)tokenID
+                             paymentBrand:(NSString *)paymentBrand
+                              bankAccount:(OPPBankAccount *)bankAccount;
+
+/**
+ Creates an `OPPToken` object with provided virtual account parameters.
+ @param tokenID The identifier of the token that can be used to reference the token later.
+ @param paymentBrand The payment brand.
+ @param virtualAccount Shopper’s virtual account details.
+ @return Returns an `OPPToken` object, or `nil` if parameters are empty.
+ */
++ (nullable instancetype)tokenWithTokenID:(NSString *)tokenID
+                             paymentBrand:(NSString *)paymentBrand
+                           virtualAccount:(OPPVirtualAccount *)virtualAccount;
+
+/**
+ Creates an `OPPToken` object with provided card parameters.
+ @param tokenID The identifier of the token that can be used to reference the token later.
+ @param paymentBrand The payment brand.
+ @param card Shopper’s card details.
+ @return Returns an `OPPToken` object, or `nil` if parameters are empty.
+ */
+- (nullable instancetype)initWithTokenID:(NSString *)tokenID
+                            paymentBrand:(NSString *)paymentBrand
+                                    card:(OPPCard *)card;
+
+/**
+ Creates an `OPPToken` object with provided bank account parameters.
+ @param tokenID The identifier of the token that can be used to reference the token later.
+ @param paymentBrand The payment brand.
+ @param bankAccount Shopper’s bank account details.
+ @return Returns an `OPPToken` object, or `nil` if parameters are empty.
+ */
+- (nullable instancetype)initWithTokenID:(NSString *)tokenID
+                            paymentBrand:(NSString *)paymentBrand
+                             bankAccount:(OPPBankAccount *)bankAccount;
+
+/**
+ Creates an `OPPToken` object with provided virtual account parameters.
+ @param tokenID The identifier of the token that can be used to reference the token later.
+ @param paymentBrand The payment brand.
+ @param virtualAccount Shopper’s virtual account details.
+ @return Returns an `OPPToken` object, or `nil` if parameters are empty.
+ */
+- (nullable instancetype)initWithTokenID:(NSString *)tokenID
+                            paymentBrand:(NSString *)paymentBrand
+                          virtualAccount:(OPPVirtualAccount *)virtualAccount;
+
+@end
+NS_ASSUME_NONNULL_END