How to integrate Amazon Pay in Bubble

You integrate Amazon Pay in Bubble by creating an OAuth flow (Login with Amazon), then using the tokens you receive to call Amazon Pay’s REST APIs through the API Connector. Amazon does not have an official Bubble plugin, so you must set up OAuth + API calls manually.

What You Actually Need to Do

Amazon Pay uses Login with Amazon (LWA) for authentication. Bubble supports this through the API Connector with OAuth2 Custom Token. After the user logs in, Amazon returns an access\_token that you use in all Amazon Pay payment API calls (create checkout, confirm, capture, refund).

• Create an LWA Security Profile inside your Amazon Seller Central → Apps & Services → Login With Amazon.
• Copy Client ID and Client Secret.
• Whitelist Bubble redirect URL in Amazon settings (from Bubble API Connector when OAuth is selected).

Set Up OAuth in Bubble

Inside Bubble’s API Connector, create a new API and choose OAuth2 User-Agent Flow. Use Amazon’s real endpoints:

• Authorization URL: https://www.amazon.com/ap/oa
• Token URL: https://api.amazon.com/auth/o2/token
• Scope: payments:widget payments:shipping\_address

Bubble will generate a redirect URL. Copy it back to Amazon LWA.

Create Amazon Pay API Calls

After OAuth is working, you can add REST calls. Example: create a Checkout Session.

{
  "webCheckoutDetails": {
    "checkoutReviewReturnUrl": "https://yourapp.com/review"
  },
  "storeId": "YOUR_STORE_ID"
}

Bubble API Connector setup:

• Method: POST
• URL: https://pay-api.amazon.com/live/v2/checkoutSessions
• Headers: Authorization: Bearer
• Body type: JSON

Redirect User to Amazon Pay

The API response returns a webCheckoutDetails.checkoutReviewUrl. Use Bubble’s “Go to external URL” to send the customer to Amazon Pay’s hosted checkout.

Handle Webhooks (Optional but Recommended)

Amazon Pay can send status updates (authorized, captured). Use a Bubble Backend Workflow endpoint URL and register it in Amazon Pay console.