v1.7.0 Released on March 31, 2025
Features Add new CodeChallengeMethod enumeration to the authentication module. Add new LoginStrategy enumeration to the authentication module. Add new Prompt enumeration to the authentication module. Add new AuthenticationDetailsParameters model to the authentication module. Add new AuthenticationDetails model to the authentication module. Add new getAuthenticationDetails method to the AuthenticationService.
Improvements
v1.6.0 Released on February 24, 2025
Features Add new SERVICE_LEVEL value to the ProfileInclude enumeration. Add new serviceLevel field to the CustomerInfo model. Add new AvailableCurrencies model to the profile module. Add new getAvailableCurrencies method to the ProfileService. Add new VERIFICATION_REQUIRED value to the PaymentInstrumentStatus enumeration. Add new CardVerificationStatusReason enumeration to the payment-instruments module. Add new CardVerificationStatus enumeration to the payment-instruments module. Add new CardVerificationType enumeration to the payment-instruments module. Add new CardVerificationInfo enumeration to the payment-instruments module. Add new CardVerificationList model to the payment-instruments module. Add new CardVerificationRequest model to the payment-instruments module. Add new CardVerification model to the payment-instruments module. Add new CardVerificationsParameters model to the payment-instruments module. Add new getCardVerificationInformation method to the PaymentInstrumentService. Add new getSingleCardVerification method to the PaymentInstrumentService. Add new verifyCard method to the PaymentInstrumentService. Add new getCardVerifications method to the PaymentInstrumentService. Add new mobile field to the CustomerTransferRecipient model. Add new authentication module. Add new AuthenticationService service to the authentication module. Add new sendScaChallenge method to the AuthenticationService. Add new submitScaAttempt method to the AuthenticationService. Add new ScaAuthenticationEventAttemptVerificationMethod enumeration to the common module. Add new ScaAuthenticationEventAttemptStatus enumeration to the common module. Add new ScaAuthenticationEventAttemptVerificationChannel enumeration to the common module. Add new HYBRID value to the ScaAuthenticationMode enumeration. Add new ScaAuthenticationEventAttemptEmbeddedHybridRequest model to the common module. Add new ScaAuthenticationEventAttemptEmbeddedHybridResponse model to the common module. Add new ScaAuthenticationEventAttemptVerificationEnhanced model to the common module. Add new ScaAuthenticationEventChallengeEmbeddedHybridRequest model to the common module. Add new ScaAuthenticationEventChallengeEmbeddedHybridResponse model to the common module. Add new getAuthenticationService method to the Wallet.
Improvements Deprecations The string type of the method field from the ScaAuthenticationEventAttemptVerification model is deprecated. Use ScaAuthenticationEventAttemptVerificationMethod instead. The string type of the channel field from the ScaAuthenticationEventAttemptVerification model is deprecated. Use ScaAuthenticationEventAttemptVerificationChannel instead.
v1.5.0 Released on December 11, 2024
Features Add new Occupation enumeration to the common module. Add new Vulnerability enumeration to the common module. Add new UpdateAddressRequest model to the profile module. Add new UpdateCustomerRequest model to the profile module. Add new updateProfile method to the ProfileService. Add new wallet-setup module. Add new getWalletSetupService method to the Wallet class. Add new WalletSetupService to the wallet-setup module. Add new CustomerDataVerificationAttemptStatus enumeration to the wallet-setup module. Add new CustomerDataVerificationAttributeType enumeration to the wallet-setup module. Add new CustomerDataVerificationFlow enumeration to the wallet-setup module. Add new CustomerDataVerificationNotificationChannel enumeration to the wallet-setup module. Add new CustomerDataVerificationNotificationMethod enumeration to the wallet-setup module. Add new CustomerCredentials model to the wallet-setup module. Add new CustomerDataVerificationAttemptRequest model to the wallet-setup module. Add new CustomerDataVerificationAttemptResponse model to the wallet-setup module. Add new CustomerDataVerificationAttribute model to the wallet-setup module. Add new CustomerDataVerificationNotificationType model to the wallet-setup module. Add new CustomerDataVerificationRequest model to the wallet-setup module. Add new CustomerDataVerificationResponse model to the wallet-setup module. Add new CustomerIdentifier model to the wallet-setup module. Add new CustomerIdentifiersOnboarding model to the wallet-setup module. Add new CustomerPersonRequest model to the wallet-setup module. Add new DataPreferences model to the common module. Add new MarketingPreferences model to the common module. Add new Preferences model to the common module. Add new CustomerTransferReason enumeration to the common module. Add new RequestTransferDetails model to the common module. Add new CARD_REPLACEMENT_FEE value to the TransferReason enumeration. Add new CARD_FEE value to the TransferReason enumeration. Add new ATM_FEE value to the TransferReason enumeration. Add new INACTIVITY_FEE value to the TransferReason enumeration. Add new FX_FEE value to the TransferReason enumeration. Add new DISPUTE_FEE value to the TransferReason enumeration. Update the transferDetails field type of the CustomerTransferRequest model from TransferDetails to RequestTransferDetails | TransferDetails. Add new STANDALONE_FEE value to the TransactionType enumeration. Add new IncompleteAttribute model to the common module. Add new INCOMPLETE_ONBOARDING_ATTRIBUTES value to the ProfileInclude enumeration. Add new PREFERENCES value to the ProfileInclude enumeration. Add new COMPLETE_ONBOARDING value to the RestrictionAction enumeration. Add new INCOMING_TRANSACTIONS_AND_SEND_MONEY value to the RestrictionName enumeration. Add new vulnerabilities field to the CustomerInfo model. Add new incompleteAttributes field to the CustomerInfo model. Add new preferences field to the CustomerInfo model. Add new additionalAttributes field to the CustomerInfo model. Add new userCategory field to the CustomerInfo model.
Improvements Deprecations The TransferDetails type of the transferDetails field from the CustomerTransferRequest model is deprecated. Use RequestTransferDetails instead. The LOGIN value of the RestrictionName enumeration is deprecated.
v1.4.0 Released on November 27, 2024
Features Add new RESET_PIN_CVV_RETRIES value to the CardAction enumeration.
Improvements Fixes Fix the include parameter propagation of the get method in the CardService.
v1.3.0 Released on October 18, 2024
Features Add new authorizationId field to the PrepaidCardInstrumentTransactionDetails model. Add new PAYSAFECASH value to the PaymentOptionType enumeration. Add new DECLINED value to the TransactionStatus enumeration. Add new PaymentPropertyKey enumeration to the common module. Add new SCA value to the DepositAction enumeration. Update the key field type of the PaymentProperty model from string to string | PaymentPropertyKey. Update the cardSchemes field type of the CardPaymentOptionSettings model from string[] to string[] | CardScheme[]. Update the action field type of the CustomerDeposit model from DepositAction to DepositAction | PaymentAction. Add new paymentOptionSettings field to the WithdrawalOption model. Add new fees field to the Withdrawal model. Add new creationTime field to the PaymentInstrument model. Add new cardScheme field to the CardPaymentInstrument model. Update the accountType field type of the UsBankAccount model from string to string | AccountType. Add new CardAction enumeration to the cards module. Add new AVAILABLE_ACTIONS value to the CardIncludesParam enumeration. Add new CardAvailableAction model to the cards module. Add new availableActions field to the Card model. Add new description field to the CardInstrumentTransactionDetails model. Add new AttemptResetAction enumeration to the cards module. Add new CardAttemptResetInfo model to the cards module. Add new ResetCardVerificationAttemptsRequest model to the cards module. Add new resetVerificationAttempts method to the CardService. Add new REVERSED value to the TransactionStatus enumeration. Add new scaDetails parameter to the getDetails method in the CardService.
Improvements Deprecations The string type of the key field from the PaymentProperty model is deprecated. Use PaymentPropertyKey instead. The string[] type of the cardSchemes field from the CardPaymentOptionSettings model is deprecated. Use CardScheme[] instead. The DepositAction type of the action field from the CustomerDeposit model is deprecated. Use PaymentAction instead. The DepositAction enumeration is deprecated. Use PaymentAction instead. The fee field of the Withdrawal model is deprecated. Use fees instead. The cvv field of the CardPaymentInstrument model is deprecated.
v1.2.0 Released on October 8, 2024
Features Add getViewPinUrl method to CardService
Improvements
v1.1.0 Released on October 4, 2024
Features Add new ScaAuthenticationEventRequest model to the common module. Add new ScaAuthenticationEventResponse model to the common module. Add new scaDetails field to the TransferConfirm model. Add new scaDetails field to the TransferProcessRequest model. Add new scaDetails field to the WithdrawalConfirm model. Add new scaDetails field to the Withdrawal model. Add new action field to the Withdrawal model. Add new scaDetails parameter to the getDetailsUrl method in CardService. Add new scaDetails parameter to the update method in CardService. Add new CCI_BANK_ACCOUNT value to the InstrumentTypeTransactionDetails enumeration. Add new CCI_BANK_ACCOUNT value to the InstrumentType enumeration. Add new CciBankAccount model to the payment-instruments module. Add new PAGO_EFECTIVO value to the PaymentOptionType enumeration. Add new PaysafecashLocationRequest model to the deposits module. Add new PaysafecashLocation model to the deposits module. Add new getPaysafecashLocations method to the DepositService.
Improvements Internal improvements. Add full JSDoc description documentation.
v1.0.0 Released on August 8, 2024
Features Add new ApiEnvironment model to the wallet module. Add new apiEnvironment field to the SdkConfiguration model. Add new module authorization-history. Add new AuthorizationHistoryService for managing authorization history related operations. Add new models and enumerations to the authorization-history module. Add new method getAuthorizationHistoryService to the Wallet class. Add new instrumentId field to the PaymentInstrumentTransactionDetails model. Add new ScaAuthenticationMode enumeration to common module. Add new ScaAvailableVerification model to common module. Add new ScaDetails model to common module. Add new TransferAction enumeration to transfers module. Add new fees field to the CustomerTransfer model. Add new scaDetails field to the CustomerTransfer model. Add new nextStatus field to the CustomerTransfer model. Add new action field to the CustomerTransfer model.
Improvements Breaking Changes Removed the brand field from the SdkConfiguration model. Removed the baseURL field from the SdkConfiguration model. Removed the fee field from the CustomerTransfer model. Removed the fee field from the CustomerDeposit model. Removed the instrumentId field from the Transaction model. Removed the fee field from the Transaction model. Removed the cardPaymentDetails field from the Transaction model. Removed the instrumentType field from the Transaction model. The nationality field of the CustomerInfo model is now optional. The occupation field of the CustomerInfo model is now optional.
v0.10.0 Released on July 17, 2024
Features Add InstrumentTypeTransactionDetails enumeration to common module. Add CardInstrumentTransactionDetails model to common module. Add PaymentInstrumentTransactionDetails model to common module. Add PrepaidCardInstrumentTransactionDetails model to common module. Add SepaBankAccountTransactionDetails model to common module. Add UkBankAccountTransactionDetails model to common module. Add UsBankAccountTransactionDetails model to common module. Add new field instrumentDetails to the Transaction model. Add PaymentOptionSettings model to deposits module. Add CardPaymentOptionSettings model to deposits module. Add new field paymentOptionSettings to the PaymentOptionDetails model. Add new field fees to the CustomerDeposit model. Add new field description to the CardPaymentInstrument model.
Improvements Deprecations Deprecated the cardPaymentDetails field of the Transaction model. Use instrumentDetails instead. Deprecated the fee field of the CustomerDeposit model. Use fees instead.
v0.9.0 Released on June 13, 2024
Features Add activate method to the CardService for activating a prepaid physical card. Add CardActivationRequest model. Add new type APPLICATION_FEE to the TransactionType enumeration. Add new type SET_UP_FEE to the TransactionType enumeration. Add new type MONTHLY_MAINTENANCE_FEE to the TransactionType enumeration. Add new field status to the TransactionHistoryParameters model. Add new field type to the TransactionHistoryParameters model. Add new field cardId to the TransactionHistoryParameters model.
Improvements
v0.8.0 Released on May 23, 2024
Features Add DepositService for managing deposit related operations. Add deposit related models. Add CurrencyExchangeService for managing currency exchange related operations. Add currency exchange related models.
Improvements Internal error handling is improved.
Breaking Changes The timestamp number property of FxRate is replaced by creationTime string property. The expiration number property of FxRate is replaced by expirationTime string property.
v0.7.0 Released on April 8, 2024
Features Add Occupation field to CustomerInfo model.
Fixes Updated deposit, withdrawal and transfer models to match the API.
v1.8.0 Released on March 11, 2025
Features Add accountType field to CciBankAccountTransactionDetails. Add bankName field to CciBankAccountTransactionDetails. Add bankCode field to CciBankAccountTransactionDetails. Add bankName field to CciBankAccount. Add bankCode field to CciBankAccount.
v1.7.0 Released on February 24, 2025
Features Add serviceLevel field to CustomerInfo. Add serviceLevel to ProfileInclude enum.
v1.6.1 Released on February 17, 2025
Features Make CustomerDataVerificationNotificationType properties public. Add vulnerabilitiesApplicable field to CustomerInfo.
v1.6.0 Released on February 12, 2025
Features Add new loginWithPin method to AuthenticationService. Add transfers to mobile number. Add LogoutService.
v1.5.0 Released on February 3, 2025
Features Add Card Verification. Add CustomerDataVerificationService. Add ContactInformationService.
v1.4.0 Released on January 23, 2025
Features Add accountType to CciBankAccount class. Add PreferencesService.
v1.3.0 Released on December 6, 2024
Features Add reversed to Transaction.Status enum. Add payout to TransactionType enum. Add standaloneFee to TransactionType enum. Add method resetVerificationAttempts for resetting card's PIN/CVV attempts to CardService. Add resetPinCVVRetries value to Card.CardAction enum.
Fixes Don't generate new device fingerprint when retrying login with Strong Customer Authentication.
v1.2.1 Released on November 4, 2024
Fixes Fix deposit confirm not handling properly card deposit with no 3DS challenge.
v1.2.0 Released on November 1, 2024
Features Add method getSecureDetailsViews to retrieve views showing prepaid card's PAN (card number), expiry date and CVV securely. Add list of availableActions to prepaid Card model. Add functionality to initiate Card deposit with outsourced payment confirmation. Add confirm method to CardDepositService for outsourced payment confirmation. Add description to CardInstrumentTransactionDetails model. Add .declined to Transaction.Status enum. AuthenticationService implementation for partners with standaloneWallet access and walletSetup scope to the config token. Add preferences to CustomerPersonRequest model. Add preferences to CustomerInfo model and .preferences to ProfileInclude enum.
Breaking Changes Remove getDetails method from CardService. Use getSecureDetailsViews instead.
v1.1.0 Released on October 8, 2024
Features Initiate Strong Customer Authentication (SCA) process when required for the operations: Transfer, Withdrawal, Change prepaid card PIN and Get prepaid card details. Provide dark variant for embedded icons and allow to be overridden. Add method getSecurePINView to retrieve view showing prepaid card's PIN securely. Create two initializers for CardUpdateRequest to distinguish between update card and change PIN. Add new updateProfile method to the ProfileService. Add .pagoEfectivo to PaymentOptionType. Add .paysafecash to PaymentOptionType. Add new getPaysafecashLocations method to the DepositService. Add CciBankAccount as new PaymentInstrument. Add slipID to Authorization model. Add authorizationID to CardInstrumentTransactionDetails model.
Improvements
v1.0.0 Released on August 8, 2024
Features Introduce APIEnvironment enum with .production and .test values passed to configure method. Introduce new color attributes to the Appearance configuration.
Improvements Improve documentation for card tokenization.
Breaking Changes The property baseURL from Configuration is replaced with apiEnvironment. The property nationality from CustomerInfo is changed to optional. The property occupation from CustomerInfo is changed to optional. The property birthDate from CustomerInfo is changed to non-optional. The property instrumentId from Transaction was deleted. The property instrumentType from Transaction was deleted. The property cardPaymentDetails from Transaction was deleted.
v0.10.0 Released on July 17, 2024
Features Add Card deposits implementation. Add vulnerabilities property to CustomerInfo. Add Authorization history implementation. Add creationTime, cardScheme and description properties to all payment instruments. Add instrumentDetails property to Transaction.
Deprecations Mark cardPaymentDetails from Transaction model as deprecated. Use instrumentDetails instead.
v0.9.0 Released on June 13, 2024
Features Add card id filter parameter to transaction history. Add new case applicationFee to the TransactionType enum. Add new case setUpFee to the TransactionType enum. Add new case monthlyMaintenanceFee to the TransactionType enum. Add activate method to CardService for activating prepaid physical card. Add PaymentOptionSettings property to PaymentOptionDetails.
Breaking Changes Remove lost and damaged prepaid card statuses.
v0.8.0 Released on May 23, 2024
Features Add DepositService for managing deposit related operations. Add deposit related models. Add CurrencyExchangeService for managing currency exchange related operations. Add currency exchange related models. Add .otherFee to FeePaymentReason enum. Add offset to PagingResultMeta data class. Improve documentation.
Improvements Annotate Wallet.configure as @MainActor. Annotate methods returning UIViewController as @MainActor.
Fixes Fix privacy manifest failing AppStore connect validation.
Breaking Changes Make transferDetails non-optional in CustomerTransfer. Change property key of PaymentProperty from String to PaymentPropertyKey. Predefine instrumentType in PaymentInstrument subclasses. Change PaymentInstrument id, customerId and status to optional.
v0.7.0 Released on April 8, 2024
Features Added CardDepositService. Exposed API for retrieving secure card details view controller. Occupation field changed to non-optional.Added view controller showing secure details for a prepaid card. Added prepaid secure details API. Added Occupation field to CustomerInfo Added fees property to Transfer. Added paymentProperties to Transfer requests. Added additional properties to transaction history. Added ACH Deposits. Added filter by type and status on the transaction history endpoint. Added PeerDetails property to Transaction. Added new redirection value to PaymentStatus enum. Added paymentProperties parameter to WithdrawalConfirm and WithdrawalCreate. Added async methods for Deposit, AchDeposit, PaymentInstrumentsService, TransferService, CardService, WithdrawalService, ProfileService, TransactionHistoryService, and CustomerVerificationService.
Improvements Enhanced the demo app with all changed related to the release.
Fixes Changed PaymentInstrumentModel.status to optional as in API definitions.
Breaking Changes Moved transactionAmount property to CardPaymentDetails.
v1.8.0 Released on March 11, 2025
Features Add accountType field to CciBankAccountTransactionDetails. Add bankName field to CciBankAccountTransactionDetails. Add bankCode field to CciBankAccountTransactionDetails. Add bankName field to CciBankAccount. Add bankCode field to CciBankAccount.
v1.7.0 Released on February 24, 2025
Features Add serviceLevel field to CustomerInfo. Add SERVICE_LEVEL to ProfileInclude enum. Add vulnerabilitiesApplicable field to CustomerInfo.
v1.6.0 Released on February 12, 2025
Features Add new loginWithPin method to AuthenticationService. Add transfers to mobile number. Add LogoutService.
v1.5.0 Released on February 3, 2025
Features Add Card Verification. Add CustomerDataVerificationService. Add ContactInformationService.
v1.4.1 Released on January 24, 2025
Fixes Fix an error in the Customer Verification screen, when you do not grant camera permissions.
v1.4.0 Released on January 23, 2025
Features Add accountType to CciBankAccount data class. Add PreferencesService.
v1.3.0 Released on December 6, 2024
Features Add REVERSED to TransactionStatus enum. Add PAYOUT to TransactionType enum. Add STANDALONE_FEE to TransactionType enum. Add method resetVerificationAttempts for resetting card's PIN/CVV attempts to CardService. Add RESET_PIN_CVV_RETRIES value to CardAction enum.
Fixes Don't generate new device fingerprint when retrying login with Strong Customer Authentication.
v1.2.1 Released on November 12, 2024
Fixes Fix a possible resource leak in the Customer Verification screen
v1.2.0 Released on November 1, 2024
Features Add method getSecureDetailsViews to retrieve views showing prepaid card's PAN (card number), expiry date and CVV securely. Add list of availableActions to prepaid Card model. Add functionality to initiate Card deposit with outsourced payment confirmation. Add confirm method to CardDepositService for outsourced payment confirmation. Add description to CardInstrumentTransactionDetails model. Add DECLINED to TransactionStatus enum. AuthenticationService implementation for partners with standaloneWallet access and walletSetup scope to the config token. Add preferences to CustomerPersonRequest model. Add preferences to CustomerInfo model and PREFERENCES to ProfileIncludes enum.
Breaking Changes Remove getDetails method from CardService. Use getSecureDetailsViews instead.
v1.1.0 Released on October 8, 2024
Features Initiate Strong Customer Authentication (SCA) process when required for the operations: Transfer, Withdrawal, Change prepaid card PIN and Get prepaid card details. Provide dark variant for embedded icons and allow to be overridden. Add method getSecurePinView to retrieve view showing prepaid card's PIN securely. Create two constructors for CardUpdateRequest to distinguish between update card and change PIN. Add new updateProfile method to the ProfileService. Add PAGO_EFECTIVO to PaymentOptionType. Add PAYSAFECASH to PaymentOptionType. Add new getPaysafecashLocations method to the DepositService. Add CciBankAccount as new PaymentInstrument. Add slipId to Authorization model. Add authorizationId to CardInstrumentTransactionDetails model.
Improvements
v1.0.0 Released on August 8, 2024
Features Introduce ApiEnvironment enum with Production and Test values passed to configure method Introduce new color attributes to the PaysafeWallet theme Introduce customThemeResId parameter to configure method to allow setting a custom theme to the provided UI screens
Breaking Changes The property baseUrl from SdkConfiguration was replaced with apiEnvironment The property nationality from CustomerInfo is changed to nullable The property occupation from CustomerInfo is changed to nullable The property birthDate from CustomerInfo is changed to non-nullable The property instrumentId from Transaction was deleted The property instrumentType from Transaction was deleted The property cardPaymentDetails from Transaction was deleted The parameter customThemeResId was removed from CardDepositService.start() method and instead passed to the configure method
v0.10.0 Released on July 17, 2024
Features Add Card deposits implementation. Add vulnerabilities field to CustomerInfo model. Add Authorization history implementation. Add creationTime, cardScheme and description fields to all payment instruments. Add instrumentDetails field to Transaction data class.
Deprecations Mark cardPaymentDetails from Transaction model as deprecated. Use instrumentDetails instead.
Breaking Changes Changed name of foundingTransactionId parameter in CustomerDeposit to fundingTransactionId. Changed the type of redirectUrl parameter from ReturnLink to RedirectLink.
v0.9.1 Released on June 27, 2024
Fixes Update ThreatMetrix screening dependency to version 7.3-52
v0.9.0 Released on June 13, 2024
Features Add card id filter parameter to transaction history. Add new case APPLICATION_FEE to the TransactionType enum class. Add new case SET_UP_FEE to the TransactionType enum class. Add new case MONTHLY_MAINTENANCE_FEE to the TransactionType enum class. Add activate method to CardService for activating prepaid physical card. Add paymentOptionsSetting parameter to PaymentOptionDetails.
Breaking Changes Remove LOST and DAMAGED prepaid card statuses.
v0.8.0 Released on May 23, 2024
Features Add DepositService for managing deposit related operations. Add deposit related models. Add CurrencyExchangeService for managing currency exchange related operations. Add currency exchange related models. Add OTHER_FEE to FeePaymentReason enum class. Add offset to PagingResultMeta. Improve documentation.
Breaking Changes Make transferDetails non-optional in CustomerTransfer. Change property key of PaymentProperty from String to PaymentPropertyKey. Change PaymentInstrument id, customerId and status to optional.
v0.7.0 Released on April 8, 2024
Features Added Occupation field to CustomerInfo model. Added paymentProperties parameter to TransferConfirm and TransferCreate data classes. Added cardPaymentDetails to transaction data class. Added PeerDetails field to Transaction. Added type and status fields to TransactionHistoryParameters. Added new REDIRECTION value to PaymentStatus enum. Added create, confirm, preview operations to the ACH deposit service. Added get deposits operations. Added new TRANSFER_RETURN value to TransactionType enum.
Improvements Enhanced the demo app with all changed related to the release.
Breaking Changes Replaced the fee field in CustomerTransfer and Transaction with fees field which contains a list of SimpleFeePayment objects. Replaced fee with fees to match contract changes in CustomerDeposit and Withdrawal objects. Moved and renamed transactionAmount and it's currency field to CardPaymentDetails object in the Transaction model. Parameter id in WithdrawalConfirm and WithdrawalCreate changed to withdrawalId. The expirationTime attribute to be optional for all payments (deposit/withdrawal/transfer) - type changed from Calendar to Calendar?. Removed the CANCELATION transaction type from TransactionType enum.