24 posts tagged with "Push Provisioning SDK"

Maintenance release with dependency updates and improved Google Pay integration.

Overview​

Introduction of a configuration file that is necessary to initialise dependencies. Change to initialisation method of the SDK. Removal of the card brand throughout the SDK since provider-routing is now handled automatically. Migration from event-based to Promise-based APIs.

Supported versions:​

• iOS: 15.1 and onwards
• Xcode: 16.4 and 26
• Swift: 5.9 and onwards

Added​

• Added WPPComponents.initialize(environment: , uiKey:).
• Added WPPComponents.makePassEntriesForCardsWith(authenticationToken:, entries:, imageFallback:).
• Added an async version of WPPComponents.addPaymentPass(authenticationToken: ,clientPaymentCardId: ,certificates: ,nonce: ,nonceSignature:) in case you prefer to avoid callbacks.
• Added extra properties reason, domain, underlyingErrorCode, and errorCode to WPPError to provide better context into what went wrong.
• Added WeavrProvisioningErrorCode and WeavrProvisioningErrorDomain to better represent errors. The end of this document contains appendixes with their values.
• Added more cases to the AddCardToWalletStatus enum to better reflect the potential states a card can be in within Apple Pay.
• Added a DeviceType enum to let you query the card status in a specific device between phone, or wallet. Also included an either value for convenience. The potential values and how to use them are listed in the Appendix.
• Added WeavrProvisioningExtensionHandler to simplify the non-ui wallet extension integration.

Breaking change​

• Changed the completion block of WPPComponents.addPaymentPass(authenticationToken: ,clientPaymentCardId: ,certificates: ,nonce: ,nonceSignature: , completionHandler:) so that the PKAddPaymentPassRequest becomes nullable (PKAddPaymentPassRequest?). This allows to report failures to create the request, and is consistent with Apple's requirements in the PKIssuerProvisioningExtensionHandler.generateAddPaymentPassRequestForPassEntryWithIdentifier method.

Removed​

• Removed WPPComponents.makePassEntryForCardWith.
• Removed WPPError.message in favour of newly added properties.

Deprecated​

• Deprecated WPPComponents.canAddCardToWallet(panLastFour:) in favour of WPPComponents.getCardStatusInWallet(forCardWithLastFourDigits:, deviceType:).

Changes​

Compatibility​

Minimum Android SDK: 24 (Android 7.0 Nougat)

Compile SDK: 35

Target SDK: 35

Kotlin: 1.8.0 or newer

Weavr secure components SDK: v.3.3.0

Google Pay device requirements: Google Play services must be installed and up to date; NFC only needed for default-payment flows.

Added​

• Added onCancelled() to AddToWalletListener.
• Added WPPComponents.initializeWeavrSDK(context: Context, uiKey: String) to initialise the SDK instead of WPPComponents.initWeavrGPayClient.
• Added WPPComponents.getCardStatus to replace WPPComponents.canAddCardToWallet avoiding listeners and using coroutines instead.
• Added WPPComponents.setDefaultCardInGooglePay to replace WPPComponents.setCardAsDefaultPaymentMethod.
• Added WPPException to subclass Exception for throwing, as well as to standardise the error reporting within the SDK. Note that the SDK won't be throwing and instead use Outcome to report success or error.
• Added WeavrSDKErrorCodes to contain a list of error codes the SDK can use.
• Added states PENDING and SUSPENDED to CardStatus.
• Added multiple push provisioningPush Provisioning A method that allows cardholders to add their card to a digital wallet (such as Apple Pay or Google Pay) directly from your app. The card details are securely tokenized and sent to the wallet provider, streamlining the process and enhancing the user experience compared to manual provisioning. This feature is currently in beta. providers to maximise up-time and reliability.

Breaking changes​

• Updated SDK access process—contact support@weavr.io to receive the latest package and onboarding instructions.
• Changed WPPComponents.isGooglePayAvailable to be a synchronous method rather than using coroutines needlessly.
• Changed onError(WPPException) in AddToWalletListener. This replaces the old onError(WPPError) as the WPPError type had less information on what went wrong.

Removed​

• Removed WPPComponents.launchGpay as the result of WPPComponents.getPushProvisioningLauncher includes a provisionCard method instead.

Deprecated​

• Deprecated WPPComponents.initWeavrGPayClient in favour of WPPComponents.initializeWeavrSDK.
• Deprecated CardStatusListener in favour of an async method to get the card status.
• Deprecated WPPComponents.canAddCardToWallet in favour of WPPComponents.getCardStatus.
• Deprecated WPPComponents.setGPayAsDefaultNFCPaymentMethod in favour of WPPComponents.setGooglePayAsDefaultNFCPaymentMethod. This avoids using coroutines needlessly as the outcome depends only on whether the activity to select was able to be launched or not, not the actual result.
• Deprecated WPPComponents.getGpayLauncher in favour of WPPComponents.getPushProvisioningLauncher to improve naming consistency.
• Deprecated WPPComponents.setCardAsDefaultPaymentMethod with WPPComponents.setDefaultCardInGooglePay as the callback was unnecessary due to callback being called from within the method itself.
• Deprecated WPPResult to be replaced with Outcome. This is because WPPResult would use an optional Success generic type, forcing users to account for nulls everywhere. Additionally made Outcome compatible with Kotlin Result by calling Outcome.asResult.
• Deprecated the case Unknown of CardStatus, and added UNKNOWN for consistency across state capitalisation.
• Deprecated the case GPayError of CardStatus. This state will no longer be used.

Other changes to note​

• We have moved the SDK to work with AppCompactActivity preferably. Ensure that your activity is sub-classing it to avoid problems during provisioning.
• SDK binaries are now distributed directly by Weavr Support—request access via support@weavr.io.

iOS Patch version to update one of our dependencies to include stability fixes.

iOS Patch version to update one of our dependencies to include stability fixes.

Fixes and stability improvements.

Fixes and stability improvements.

Stability and compatibility improvements to the Google Pay provisioning flow on Android, plus clearer results and error handling for embeddersEmbedder A company or developer that integrates Weavr's embedded finance services into their own application to provide financial services to their end customers..

Query from your app, whether a card is provisioned to a specific device (phone or watch).

Query from your app, whether a card is provisioned to a specific device (phone or watch).

Query from your app, whether a card is provisioned to a specific device (phone or watch).

Query from your app, whether a card is provisioned to a specific device (phone or watch).

Fixed​

This release performs two main changes:

1. Provide support for React Native's new architecture
2. Leverage Expo modules API to simplify maintenance

Fixed​

The SDK exposes a new method WPPComponents.getCardStatusInWallet(forCardWithLastFourDigits:, deviceType:) that can be used to check the status of a given card within the Apple Pay wallet of the device.

Added​

Increases the scenarios under which AddToWalletButton will work.

Added​