react-native-hyperpay-sdk 0.2.0 → 0.5.0

package/OPPWAMobile-Resources.bundle/th.lproj/OPPCheckout.strings

@@ -0,0 +1,91 @@
+//
+// Checkout.strings
+// OPPWAMobile
+//
+
+/// View controller titles
+"VIEW_CONTROLLER_TITLE_PAYMENT_METHOD_SELECTION" = "เลือกวิธีชำระเงิน";
+"VIEW_CONTROLLER_TITLE_PAYMENT_DETAILS" = "ข้อมูลชำระเงิน";
+"VIEW_CONTROLLER_TITLE_PROCESSING" = "กำลังดำเนินรายการ";
+
+/// Form titles
+"FORM_TITLE_PAYMENT_INFO" = "รายละเอียดชำระเงิน";
+
+/// Labels
+"LABEL_TOTAL_AMOUNT" = "ราคารวม";
+"LABEL_MBWAY_PUSH_NOTIFICATION" = "ระบบจะส่งพุชแจ้งเตือนไปที่โทรศัพท์มือถือ";
+"LABEL_MBWAY_ACCEPT_PIN" = "กรุณาใส่ PIN ของ MB WAY เพื่อยืนยันการทำรายการ";
+"LABEL_TERMS_AND_CONDITIONS" = "ข้อตกลงและเงื่อนไข";
+"LABEL_TERMS_AND_CONDITIONS_AGREEMENT" = "ยอมรับข้อตกลงและเงื่อนไข";
+"LABEL_SWEDISH" = "สวีเดน";
+"LABEL_FINNISH" = "ฟินแลนด์";
+
+/// Messages
+"MESSAGE_PLEASE_WAIT" = "กรุณารอสักครู่";
+
+/// Device owner authentication
+"DEVICE_AUTH_REASON" = "ยืนยันชำระเงิน";
+
+/// Button titles
+"BUTTON_TITLE_PAY" = "ชำระเงิน";
+"BUTTON_TITLE_PAY_AMOUNT" = "จ่าย %@";
+"BUTTON_TITLE_REGISTER" = "ลงทะเบียน";
+"BUTTON_TITLE_CANCEL" = "ยกเลิก";
+"BUTTON_TITLE_BACK" = "เปลี่ยน";
+"BUTTON_TITLE_DONE" = "สำเร็จ";
+
+/// Text field label names
+"FIELD_LABEL_CARD_HOLDER_NAME" = "ชื่อผู้ถือบัตร";
+"FIELD_LABEL_CREDIT_CARD_NUMBER" = "หมายเลขบัตรเครดิต";
+"FIELD_LABEL_EXPIRY_DATE" = "วันหมดอายุ";
+"FIELD_LABEL_CVV" = "รหัสตรวจสอบบัตร CVC";
+"FIELD_LABEL_MOBILE_PHONE_NUMBER" = "หมายเลขโทรศัพท์เคลื่อนที่";
+"FIELD_LABEL_BANK_ACCOUNT_HOLDER_NAME" = "เจ้าของบัญชี";
+"FIELD_LABEL_IBAN" = "IBAN";
+"FIELD_LABEL_IBAN_OR_ACCOUNT_NUMBER" = "IBAN หรือ เลขที่บัญชี";
+"FIELD_LABEL_BIC_OR_BANK_CODE" = "BIC หรือ รหัสธนาคาร";
+"FIELD_LABEL_SELECT_COUNTRY" = "เลือกประเทศ";
+"FIELD_LABEL_SELECT_BANK" = "เลือกธนาคาร";
+"FIELD_LABEL_STORE_PAYMENT_DETAILS" = "บันทึกข้อมูลชำระเงินสำหรับใช้ครั้งต่อไป";
+"FIELD_LABEL_STORE_CARD_TYPE" = "เลือกประเภทบัตร";
+"FIELD_LABEL_NUMBER_OF_INSTALLMENTS" = "จำนวนรอบผ่อนชำระ";
+"FIELD_LABEL_EMAIL" = "อีเมล";
+"FIELD_LABEL_COUNTRY_CODE" = "รหัสประเทศ";
+"FIELD_LABEL_NATIONAL_IDENTIFIER" = "หมายเลขบัตรประชาชน";
+
+/// Text field placeholders
+"FIELD_PLACEHOLDER_CARD_HOLDER_NAME" = "ชื่อบนหน้าบัตร";
+"FIELD_PLACEHOLDER_CARD_NUMBER" = "เลขบนหน้าบัตร";
+"FIELD_PLACEHOLDER_EXPIRY_DATE" = "ดด/ปป หรือ ดด/ปปปป";
+"FIELD_PLACEHOLDER_CVV_3_DIGITS" = "รหัส 3 หลัก";
+"FIELD_PLACEHOLDER_CVV_4_DIGITS" = "รหัส 4 หลัก";
+"FIELD_PLACEHOLDER_BANK_ACCOUNT_HOLDER_NAME" = "ชื่อเจ้าของบัญชี";
+"FIELD_PLACEHOLDER_IBAN" = "เลขที่บัญชีสากล";
+"FIELD_PLACEHOLDER_IBAN_OR_ACCOUNT_NUMBER" = "IBAN หรือ เลขที่บัญชี";
+"FIELD_PLACEHOLDER_BIC_OR_BANK_CODE" = "BIC หรือ รหัสธนาคาร";
+"FIELD_PLACEHOLDER_COUNTRY_CODE" = "+xx";
+"FIELD_PLACEHOLDER_EMAIL" = "อีเมล";
+"FIELD_PLACEHOLDER_NATIONAL_IDENTIFIER" = "หมายเลขบัตรประชาชน";
+
+/// Text field errors
+"FIELD_ERROR_CARD_HOLDER_NAME_INVALID" = "ชื่อผู้ถือบัตรไม่ถูกต้อง";
+"FIELD_ERROR_CARD_NUMBER_INVALID" = "หมายเลขบัตรไม่ถูกต้อง";
+"FIELD_ERROR_CARD_EXPIRY_DATE_INVALID" = "วันหมดอายุไม่ถูกต้อง ใช้ ดด/ปป หรือ ดด/ปปปป";
+"FIELD_ERROR_CARD_EXPIRED" = "บัตรหมดอายุ";
+"FIELD_ERROR_CARD_CVV_3_DIGITS_INVALID" = "รหัสตรวจสอบบัตรไม่ใช่เลข 3 หลักสุดท้ายบนหลังบัตร";
+"FIELD_ERROR_CARD_CVV_4_DIGITS_INVALID" = "รหัสตรวจสอบบัตรไม่ใช่เลข 4 หลักบนหน้าบัตร";
+"FIELD_ERROR_MOBILE_PHONE_INVALID" = "รหัสประเทศไม่ถูกต้อง";
+"FIELD_ERROR_BANK_ACCOUNT_HOLDER_INVALID" = "ชื่อเจ้าของบัญชีไม่ถูกต้อง";
+"FIELD_ERROR_IBAN_INVALID" = "IBAN ไม่ถูกต้อง";
+"FIELD_ERROR_IBAN_OR_ACCOUNT_NUMBER_INVALID" = "IBAN หรือ เลขที่บัญชีไม่ถูกต้อง";
+"FIELD_ERROR_BIC_OR_BANK_CODE_INVALID" = "BIC หรือ รหัสธนาคารไม่ถูกต้อง";
+"FIELD_ERROR_EMAIL_INVALID" = "อีเมลไม่ถูกต้อง";
+"FIELD_ERROR_NATIONAL_IDENTIFIER_INVALID" = "หมายเลขบัตรประชาชนไม่ถูกต้อง";
+
+/// Payment method names
+"PAYMENT_METHOD_TYPE_SOFORT_BANKING" = "SOFORT";
+
+/// Payment method groups are displayed if tokens are received
+"PAYMENT_METHOD_GROUP_STORED" = "วิธีชำระเงินที่เก็บบันทึกไว้";
+"PAYMENT_METHOD_GROUP_OTHER" = "วิธีชำระเงินอื่น";
+"PAYMENT_METHOD_GROUP_CARDS" = "บัตรเครดิต / เดบิต";

package/OPPWAMobile-Resources.bundle/zh-Hans.lproj/OPPCheckout.strings

@@ -0,0 +1,92 @@
+//
+// Checkout.strings
+// OPPWAMobile
+//
+
+/// View controller titles
+"VIEW_CONTROLLER_TITLE_PAYMENT_METHOD_SELECTION" = "请选择支付方式";
+"VIEW_CONTROLLER_TITLE_PAYMENT_DETAILS" = "支付信息";
+"VIEW_CONTROLLER_TITLE_PROCESSING" = "处理中";
+
+/// Form titles
+"FORM_TITLE_PAYMENT_INFO" = "支付信息";
+
+/// Labels
+"LABEL_TOTAL_AMOUNT" = "合计金额";
+"LABEL_MBWAY_PUSH_NOTIFICATION" = "您的设备将会收到一条推送通知";
+"LABEL_MBWAY_ACCEPT_PIN" = "请采用PIN MB WAY方式受理交易";
+"LABEL_TERMS_AND_CONDITIONS" = "条款和条件";
+"LABEL_TERMS_AND_CONDITIONS_AGREEMENT" = "我已阅读并同意此条款和条件";
+"LABEL_SWEDISH" = "瑞典文";
+"LABEL_FINNISH" = "芬兰文";
+
+/// Messages
+"MESSAGE_PLEASE_WAIT" = "请稍等";
+
+/// Device owner authentication
+"DEVICE_AUTH_REASON" = "确认支付";
+
+/// Button titles
+"BUTTON_TITLE_PAY" = "立即付款";
+"BUTTON_TITLE_PAY_AMOUNT" = "付款 %@";
+"BUTTON_TITLE_REGISTER" = "注册";
+"BUTTON_TITLE_CANCEL" = "取消";
+"BUTTON_TITLE_BACK" = "更改";
+"BUTTON_TITLE_DONE" = "确定";
+
+/// Text field label names
+"FIELD_LABEL_CARD_HOLDER_NAME" = "持卡人姓名";
+"FIELD_LABEL_CREDIT_CARD_NUMBER" = "卡号";
+"FIELD_LABEL_EXPIRY_DATE" = "有效期限";
+"FIELD_LABEL_CVV" = "安全码 或 卡验证码";
+"FIELD_LABEL_MOBILE_PHONE_NUMBER" = "手机号码";
+"FIELD_LABEL_BANK_ACCOUNT_HOLDER_NAME" = "开户人姓名";
+"FIELD_LABEL_IBAN" = "国际银行账户号码";
+"FIELD_LABEL_IBAN_OR_ACCOUNT_NUMBER" = "国际银行账户号码 或 账号";
+"FIELD_LABEL_BIC_OR_BANK_CODE" = "银行识别码 或 银行代码";
+"FIELD_LABEL_SELECT_COUNTRY" = "请选择国家";
+"FIELD_LABEL_SELECT_BANK" = "请选择发卡银行";
+"FIELD_LABEL_STORE_PAYMENT_DETAILS" = "保存支付信息方便下次购买";
+"FIELD_LABEL_STORE_CARD_TYPE" = "请选择卡种";
+"FIELD_LABEL_NUMBER_OF_INSTALLMENTS" = "分期笔数";
+"FIELD_LABEL_EMAIL" = "邮箱";
+"FIELD_LABEL_COUNTRY_CODE" = "国家代码";
+"FIELD_LABEL_NATIONAL_IDENTIFIER" = "身份证号码";
+
+/// Text field placeholders
+"FIELD_PLACEHOLDER_CARD_HOLDER_NAME" = "卡面上的姓名";
+"FIELD_PLACEHOLDER_CARD_NUMBER" = "卡正面一串较长的数字";
+"FIELD_PLACEHOLDER_EXPIRY_DATE" = "两位月份/两位年份 或 两位月份/四位年份";
+"FIELD_PLACEHOLDER_CVV_3_DIGITS" = "3位号码";
+"FIELD_PLACEHOLDER_CVV_4_DIGITS" = "4位号码";
+"FIELD_PLACEHOLDER_BANK_ACCOUNT_HOLDER_NAME" = "开户人姓名";
+"FIELD_PLACEHOLDER_IBAN" = "国际银行账户号码";
+"FIELD_PLACEHOLDER_IBAN_OR_ACCOUNT_NUMBER" = "国际银行账户号码 或 账号";
+"FIELD_PLACEHOLDER_BIC_OR_BANK_CODE" = "银行识别码 或 银行代码";
+"FIELD_PLACEHOLDER_COUNTRY_CODE" = "+xxx";
+"FIELD_PLACEHOLDER_MOBILE_PHONE_NUMBER" = "xxxxxxxxx";
+"FIELD_PLACEHOLDER_EMAIL" = "邮箱";
+"FIELD_PLACEHOLDER_NATIONAL_IDENTIFIER" = "身份证号码";
+
+/// Text field errors
+"FIELD_ERROR_CARD_HOLDER_NAME_INVALID" = "持卡人姓名不正确";
+"FIELD_ERROR_CARD_NUMBER_INVALID" = "输入的卡号不正确";
+"FIELD_ERROR_CARD_EXPIRY_DATE_INVALID" = "有效期不正确，请使用两位月份/两位年份 或 两位月份/四位年份 格式";
+"FIELD_ERROR_CARD_EXPIRED" = "卡片已过期";
+"FIELD_ERROR_CARD_CVV_3_DIGITS_INVALID" = "安全代码由卡背面签名栏数字最后三位构成";
+"FIELD_ERROR_CARD_CVV_4_DIGITS_INVALID" = "安全代码由卡正面的4位号码构成";
+"FIELD_ERROR_MOBILE_PHONE_INVALID" = "手机号码不正确";
+"FIELD_ERROR_BANK_ACCOUNT_HOLDER_INVALID" = "开户人姓名不正确";
+"FIELD_ERROR_IBAN_INVALID" = "国际银行账户号码不正确";
+"FIELD_ERROR_IBAN_OR_ACCOUNT_NUMBER_INVALID" = "国际银行账户号码 或 账号不正确";
+"FIELD_ERROR_BIC_OR_BANK_CODE_INVALID" = "银行识别码 或 银行代码不正确";
+"FIELD_ERROR_EMAIL_INVALID" = "邮箱无效";
+"FIELD_ERROR_NATIONAL_IDENTIFIER_INVALID" = "身份证号码无效";
+
+/// Payment method groups are displayed if tokens are received
+"PAYMENT_METHOD_GROUP_STORED" = "已保存的支付方式";
+"PAYMENT_METHOD_GROUP_OTHER" = "其它支付方式";
+"PAYMENT_METHOD_GROUP_CARDS" = "信用卡或借記卡";
+
+/// Payment method names
+"PAYMENT_METHOD_TYPE_DIRECTDEBIT_SEPA" = "单一欧元支付区直接借记";

package/OPPWAMobile.framework/Headers/OPPAlipayPaymentParams.h

@@ -0,0 +1,49 @@
+//
+// 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 "OPPPaymentParams.h"
+
+__deprecated_msg("The OPPAlipayPaymentParams class is formally deprecated. To make Alipay transaction, instead use OPPPaymentParams class with payment brand 'ALIPAY'.")
+/**
+ Class to encapsulate all necessary transaction parameters for performing an Alipay transaction.
+ 
+ @warning **Deprecated:** The `OPPAlipayPaymentParams` class is formally deprecated in 1.4.0. To make Alipay transaction, instead use `OPPPaymentParams` class with payment brand 'ALIPAY'.
+ */
+
+NS_ASSUME_NONNULL_BEGIN
+@interface OPPAlipayPaymentParams : OPPPaymentParams
+
+/// @name Initialization
+
+/// :nodoc:
+- (instancetype)initWithCheckoutID:(NSString *)checkoutID paymentBrand:(NSString *)paymentBrand error:(NSError * _Nullable __autoreleasing *)error NS_UNAVAILABLE;
+
+/**
+ Creates an object representing an Alipay transaction.
+ 
+ @param checkoutID The checkout ID of the transaction. Must be not nil or empty.
+ @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 Alipay transaction.
+ */
++ (nullable instancetype)alipayPaymentParamsWithCheckoutID:(NSString *)checkoutID error:(NSError **)error;
+
+/**
+ Creates an object representing an Alipay transaction.
+ 
+ @param checkoutID The checkout ID of the transaction. Must be not nil or empty.
+ @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 Alipay transaction.
+ */
+- (nullable instancetype)initWithCheckoutID:(NSString *)checkoutID error:(NSError **)error NS_DESIGNATED_INITIALIZER;
+@end
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.framework/Headers/OPPApplePayPaymentParams.h

@@ -0,0 +1,64 @@
+//
+// 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 "OPPPaymentParams.h"
+
+/**
+ Class to encapsulate all necessary transaction parameters for performing an Apple Pay transaction.
+ */
+
+NS_ASSUME_NONNULL_BEGIN
+@interface OPPApplePayPaymentParams : OPPPaymentParams
+
+/// @name Initialization
+
+/// :nodoc:
+- (instancetype)initWithCheckoutID:(NSString *)checkoutID paymentBrand:(NSString *)paymentBrand error:(NSError * _Nullable __autoreleasing *)error NS_UNAVAILABLE;
+
+/**
+ Creates an object representing an Apple Pay transaction.
+
+ @param checkoutID The checkout ID of the transaction. Must be not nil or empty.
+ @param tokenData UTF-8 encoded JSON dictionary of encrypted payment data.
+ @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 Apple Pay transaction, and nil if parameters are invalid.
+*/
++ (nullable instancetype)applePayPaymentParamsWithCheckoutID:(NSString *)checkoutID tokenData:(NSData *)tokenData error:(NSError **)error;
+
+/**
+ Creates an object representing an Apple Pay transaction.
+ 
+ @param checkoutID The checkout ID of the transaction. Must be not nil or empty.
+ @param tokenData UTF-8 encoded JSON dictionary of encrypted payment data.
+ @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 Apple Pay transaction, and nil if parameters are invalid.
+ */
+- (nullable instancetype)initWithCheckoutID:(NSString *)checkoutID tokenData:(NSData *)tokenData error:(NSError **)error NS_DESIGNATED_INITIALIZER;
+
+/// @name Properties
+
+/**
+ UTF-8 encoded JSON dictionary of encrypted payment data.  Ready for transmission to merchant's e-commerce backend for decryption and submission to a payment processor's gateway.
+ */
+@property (nonatomic, copy, readonly) NSData *tokenData;
+
+/// @name Validation methods
+/**
+ Checks if the token data is valid to perform a transaction.
+ 
+ @param tokenData UTF-8 encoded JSON dictionary of encrypted payment data.
+ @return `YES` if the token data is not empty.
+ */
++ (BOOL)isTokenDataValid:(NSData *)tokenData;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.framework/Headers/OPPApplePayRequestStatus.h

@@ -0,0 +1,117 @@
+//
+// 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;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ Class that reports the status code and errors that you return when a payment is authorized.
+ */
+@interface OPPApplePayRequestAuthorizationResult : NSObject
+
+/// @name Initialization
+
+/**
+ Initializes the result with the status code and list of errors.
+ @param status Payment authorization general status.
+ @param errors List of errors in the Apple Pay form (available for iOS 11 and higher).
+ */
+- (instancetype)initWithStatus:(PKPaymentAuthorizationStatus)status
+                        errors:(nullable NSArray<NSError *> *)errors NS_DESIGNATED_INITIALIZER;
+
+/// @name Properties
+
+/**
+ Payment authorization general status.
+ */
+@property (nonatomic) PKPaymentAuthorizationStatus status;
+
+/**
+ Any errors that applied. These errors will be displayed to the user to correct (available for iOS 11 and higher).
+ Errors should be ordered from most to least serious.
+ See `PKError` for specific `NSError` keys to use to enable rich error handling.
+ */
+@property (null_resettable, nonatomic, copy) NSArray<NSError *> *errors;
+
+@end
+
+
+/**
+ Base class for updating the payment request after the shopper makes changes on the payment form.
+ */
+@interface OPPApplePayRequestUpdate : NSObject
+
+/// @name Initialization
+
+/**
+ Initializes a payment request update with the given list of summary items.
+ @param paymentSummaryItems The new payment summary items to update the payment request with.
+*/
+- (instancetype)initWithPaymentSummaryItems:(NSArray<PKPaymentSummaryItem *> *)paymentSummaryItems NS_DESIGNATED_INITIALIZER;
+
+/// @name Properties
+
+/**
+ The status of the payment request update.
+ Set `PKPaymentAuthorizationStatusSuccess` for a successful update, and `PKPaymentAuthorizationStatusFailure` if you were unable to process the required changes.
+ `PKPaymentAuthorizationStatusSuccess` by default.
+*/
+@property (nonatomic) PKPaymentAuthorizationStatus status;
+
+/**
+ The new payment summary items to update the payment request with.
+ */
+@property (nonatomic, copy) NSArray<PKPaymentSummaryItem *> *paymentSummaryItems;
+
+@end
+
+/**
+ Class for updating the payment request after the shipping contact information changed.
+ */
+@interface OPPApplePayRequestShippingContactUpdate : OPPApplePayRequestUpdate
+
+/// @name Initialization
+
+/**
+ Initializes a payment request update with provided errors, payment summary items and shipping methods.
+ @param errors List of errors in the shipping contact information (available for iOS 11 and higher). See `PKError` for specific `NSError` keys to use.
+ @param paymentSummaryItems The new payment summary items to update the payment request with.
+ @param shippingMethods The new shipping methods to update the payment request with.
+ */
+- (instancetype)initWithErrors:(nullable NSArray<NSError *> *)errors
+           paymentSummaryItems:(NSArray<PKPaymentSummaryItem *> *)paymentSummaryItems
+               shippingMethods:(NSArray<PKShippingMethod *> *)shippingMethods NS_DESIGNATED_INITIALIZER;
+
+/// @name Properties
+
+/**
+ The new shipping methods to update the payment request with.
+ */
+@property (nonatomic, copy) NSArray<PKShippingMethod *> *shippingMethods;
+
+/**
+ List of errors in the shipping contact information (available for iOS 11 and higher).
+ See `PKError` for specific `NSError` keys to use.
+ */
+@property (null_resettable, nonatomic, copy) NSArray<NSError *> *errors;
+
+@end
+
+/**
+ Class for updating the payment request after the shipping method changed.
+ */
+@interface OPPApplePayRequestShippingMethodUpdate : OPPApplePayRequestUpdate
+
+@end
+
+NS_ASSUME_NONNULL_END

package/OPPWAMobile.framework/Headers/OPPBankAccount.h

@@ -0,0 +1,58 @@
+//
+// 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>
+
+/**
+ Class to encapsulate shopper’s bank account details that have been tokenized.
+ */
+
+NS_ASSUME_NONNULL_BEGIN
+@interface OPPBankAccount : NSObject
+
+/// @name Properties
+
+/** The name of the bank account holder. */
+@property (nonatomic, copy) NSString *holder;
+
+/** The IBAN (International Bank Account Number) associated with the bank account. */
+@property (nonatomic, copy) NSString *IBAN;
+
+/// @name Initialization
+
+/// :nodoc:
+- (instancetype)init NS_UNAVAILABLE;
+
+/**
+ Creates an `OPPBankAccount` object from the JSON.
+ @param JSON A dictionary with parameters received from the Server.
+ @return Returns an `OPPBankAccount` object, or `nil` if JSON contains invalid values.
+ */
++ (nullable instancetype)bankAccountFromJSON:(NSDictionary *)JSON;
+
+/**
+ Creates an `OPPBankAccount` object with the provided values.
+ @param holder The name of the bank account holder.
+ @param IBAN The IBAN (International Bank Account Number) associated with the bank account.
+ @return Returns an `OPPBankAccount` object, or `nil` if parameters are empty.
+ */
++ (nullable instancetype)bankAccountWithHolder:(NSString *)holder IBAN:(NSString *)IBAN;
+
+/**
+ Creates an `OPPBankAccount` object with the provided values.
+ @param holder The name of the bank account holder.
+ @param IBAN The IBAN (International Bank Account Number) associated with the bank account.
+ @return Returns an `OPPBankAccount` object, or `nil` if parameters are empty.
+ */
+- (nullable instancetype)initWithHolder:(NSString *)holder IBAN:(NSString *)IBAN NS_DESIGNATED_INITIALIZER;
+
+@end
+NS_ASSUME_NONNULL_END