Integration overview
- Amazon Pay mobile app experience
- One-Time Payment End-of-Checkout integration
- Set up and Pay Saved Wallet
- Set up Saved Wallet
- Update Saved Wallet
- Sign In and Set up
- Key Integration Steps for Amazon Pay Mobile SDK
Amazon Pay mobile app experience
Amazon Pay Mobile SDK offers flows for purchases, signing in, setting up as a saved payment method, or updating a wallet. To sign in to their Amazon account, the buyer is redirected to the Amazon app if installed, otherwise an in-browser experience is used. With the app, the buyer might automatically sign in to their Amazon account. Without Amazon Pay-provided universal links, the in-browser flow is always used for sign-in. In Sandbox environment, the in-browser experience is always used. Supported flows include:
One-Time Payment End-of-Checkout integration
Amazon Pay integration as a payment option at the final stage of the merchant's checkout flow, after the buyer has provided all necessary order details like shipping address through the merchant's app. Amazon Pay supports both the Pay-and-Ship and Pay-Only product types for payment flows. If it's a Pay-and-Ship checkout type, the merchant is required to gather the buyer's shipping address before triggering the Amazon Pay checkout process. The merchant must then pass the buyer's shipping address to Amazon Pay during the checkout flow. The buyer can save Amazon Pay for future purchases during checkout.
- To initiate checkout, the buyer taps the Amazon Pay button in your app.
- The buyer signs in to their Amazon account.
- An Amazon Pay-hosted page displays.
- The buyer places an order.
- Your app’s order confirmation page shows after the buyer is redirected back.
Set up and Pay Saved Wallet
Flow where the buyer sets up Amazon Pay as a saved payment method for future purchases and pays the exisiting order.
- The buyer signs in to your app.
- To start the setup flow, the buyer clicks the Amazon Pay button.
- The buyer signs in to their Amazon account.
- An Amazon Pay-hosted page displays, allowing the buyer to confirm a payment method and save Amazon Pay for future purchases.
- Finally, the buyer returns to your app, where your order confirmation page appears.
Set up Saved Wallet
Flow where the buyer sets up Amazon Pay as a saved payment method for future purchases. Amazon Pay only supports the Pay-Only product type. No need to collect a shipping address as no physical goods are being purchased.
- The buyer signs in to your app.
- To start setting up a payment method on file, the buyer clicks the Amazon Pay button.
- The buyer signs in to their Amazon account.
- An Amazon Pay-hosted page displays, allowing the buyer to confirm a payment method and save Amazon Pay for future purchases.
- After confirmation, the buyer returns to your app, with Amazon Pay as a saved payment method.
Update Saved Wallet
Flow where the buyer updates their saved payment method on file. Amazon Pay only supports the Pay-Only product type. No need to collect a shipping address as no physical goods are being purchased.
- The buyer is signs in to your app.
- The buyer has previously set up a payment method on file with Amazon Pay for your app.
- To update their saved payment method, the buyer clicks the Amazon Pay button in your app.
- The buyer signs in to their Amazon account.
- An Amazon Pay-hosted page displays, where the buyer can update and save the payment method.
Sign In and Set up
Flow where the buyer signs in to their Amazon account and sets up Amazon Pay as a saved payment method.
- The buyer taps the Sign in with Amazon button.
- They sign in to their Amazon account. An Amazon-hosted page displays, requesting consent to share information and save Amazon Pay as payment method.
- After consent, the buyer returns to your app and is signed in.
- When adding an item to the cart and starting the checkout flow, Amazon Pay shows as a saved payment method.
Key Integration Steps for Amazon Pay Mobile SDK
Integrating Amazon Pay into your mobile app involves several steps:
- Register for an Amazon Payments merchant account.
- Place the Amazon Pay button where the checkout start for your buyers.
- If rendering the button via renderButton, no click handling is needed.
- If rendering your own button, call initCheckout on click.
- Call the FinalizeCheckoutSession API.
Integration Sequence Diagram (with Setup Only example)
