Adding the Amazon Pay flow

SDK version: Refer to the release notes for the most recent SDK version here.

The HyperAPay version is tied to the version of your iOS Hyper SDK. If you're using the latest SDK version (2.2.5), the corresponding HyperAPay version should also be 2.2.5.

SDK dependencies for Amazonpay can be added by the following pod:

Add the following properties in your app's Info.plist file:

Add the following code in the AppDelegate's application:openurl:options function if the project is not using SceneDelegate:

For the project that is using SceneDelegate, add the following code in SceneDelegate’s scene:openURLContexts: function:

Use the Eligibility SDK Process Call to check if the user qualifies for the Amazon Pay Later flow.

• If the user is not eligible, either grey it out and provide the reason for the ineligibility.

• If the user is eligible and linking is required, then show the Amazon Pay Later option with the option to link. (For linking, refer to step 3.6 )

Use the Refresh Wallet SDK Call call to check if the user is already linked the Amazonpay Wallet or fetch the wallet balance if already linked.

If Amazonpay not linked:

• If the Amazonpay response is not received or the linked parameter within Amazonpay block is false in the response, display Amazonpay wallet with the Link CTA.

• When user clicks on the Link CTA proceed to Create Wallet step.

If Amazonpay linked already:

• If the Amazonpay wallet is linked already, the parameter linked:true will be received for Amazonpay wallet. The balance parameter can be consumed to display the Amazonpay wallet with balance and Pay Now / Proceed to Pay CTA.

• When user clicks on Pay Now / Proceed to Pay CTA proceed to Wallet Transaction step.

Use the Create Wallet SDK call to initiate the wallet linking flow for the user.

Android:

• If the amazon app is present in the device with the account logged in, the app will be invoked to link the user.

• If the amazon app is not present, then the user will be redirected to Amazon page in chrome tab to link the wallet.

iOS:

• In iOS, the default flow is redirection to Amazon page to link the wallet.

Once the user is linked the balance and the direct_wallet_token will be received in the response. This direct_wallet_token should be used for initiating a direct debit wallet transaction.

Use the Wallet Transaction SDK call to initiate the direct debit transaction.

• If the funds are sufficient to complete the transaction, the amount will be automatically debited.

• If the funds are insufficient to complete the transaction, the user will be redirected to Amazonpay page, where he can pay the balance amount using a payment instrument of choice.

Backend changes are required on your end to handle AmazonPay transaction-related webhook requests and order status responses.

• Order Status response

• Webhooks

To provide users with the option to unlink their linked AmazonPay Wallet/ Pay Later, the Delink Wallet API or Delink Wallet SDK call can be used.