JavaScript is disabled. Some features may not work. You can also read the static version: View text version

Amazon PayLater (Consumer Finance) Onboarding and API Specifications

Pre-requisites

Step 1

Configuring a new gateway account for Amazon PayLater on the Juspay Dashboard

Step 2

Updating existing gateway account to add Amazon PayLater from the Juspay Dashboard

Merchants can follow the steps below to add the Amazon PayLater payment method for already configured gateway accounts from the Juspay Merchant Dashboard.

For new merchants configuring Amazonpay, add the keys at the time of gateway configurations. There are 3 extra fields that needs to be added
Amazon Pay Later Access Key, Amazon Pay Later Secret Key and Amazon Pay Later Secret Key
Post adding these credentials, make sure that the flag “should use V2 integration” is turned ON
For already existing merchants with configured gateway Amazonpay, Go to edit gateway configuration and enable the flag Should Use V2 Integration? As TRUE. Add these three fields mentioned above and save

Step 3

Adding Amazon SDK dependency

Below steps can be skipped if the merchant is already live with Amazon Pay wallet tokenized flow -

Merchant needs to add the Amazon Pay SDK dependency (Version will be provided by Juspay support/ Amazon) - Not required if merchant is on new Android SDK plug-in version (2.0.4 and above)
Note: SDK Dependencies to be manually added for iOS while merchant is doing a clean build.
Juspay support to add ‘hyperapay’ as one of the micro-sdks in the merchant's build config file.
Merchant to double check whether ‘hyperapay’ is added as part of their SDK dependencies.
Juspay package version to be updated to 2.82 or above on studio.

Sample Requests and Response

Checking if Amazon Paylater is enabled by Merchant

Sample getPaymentMethods Response:

Process SDK Call for Rendering Amazon Paylater

Case 1: When the user is eligible but account linking is required:

Sample Eligibility Request:

Sample Eligibility Response:

Please note that "is_eligible” is received as true but gateway error message “linking_required” means that user is eligible for AmazonPaylater but needs to link their wallet.

Merchant has to call link wallet post that to initiate account linking.

Case 2: When the user is eligible and account is linked:

Case 3: For ineligible user:

If the particular customer is ineligible for Amazonpaylater, eligibility call will return the response as false.

Amazon Paylater linking

Sample Linking Request:

Sample Linking Response:

Making a transaction

Sample Transaction Request:

Sample Transaction Response:

Refund Call

Request CURL:

Sample Response:

Order Status Call

Request CURL:

Sample Resposne:

For more details on order create/order status and refund APIs, kindly visit this link
https://developer.juspay.in/reference/create-order-1

Annexure

Webhooks:
To know more about webhooks and their sample responses, please visit this link
https://docs.juspay.in/resources/docs/common-resources/webhooks