--- title: "Amazon Pay" description: "The Amazon Pay plugin lets your customers pay using their existing Amazon account — no card number entry required." url: "https://docs.j2commerce.com/v6/payment-methods/payment_amazonpay" markdown_url: "https://docs.j2commerce.com/v6/payment-methods/payment_amazonpay.md" last_updated: "2026-10-23T03:39:01+00:00" version: "J2Commerce 6" breadcrumbs: - title: "Home" url: "https://docs.j2commerce.com/" - title: "J2Commerce 6" url: "https://docs.j2commerce.com/v6" - title: "Payment Methods" url: "https://docs.j2commerce.com/v6/payment-methods" - title: "Amazon Pay" url: "https://docs.j2commerce.com/v6/payment-methods/payment_amazonpay" --- # Amazon Pay The Amazon Pay plugin lets your customers pay using their existing Amazon account — no card number entry required. Customers click the Amazon Pay button, log in to Amazon, confirm their payment method, and return to your store to complete the order. Because Amazon holds the customer's stored address and payment details, checkout is fast and familiar. The plugin supports two checkout modes (Express Checkout and Payment Only), manual and automatic capture, subscription renewals, saved payment agreements, and full admin-level refund and cancel actions. ## Requirements - PHP 8.3.0 or later - Joomla 6.x - J2Commerce 6.x - An Amazon Pay merchant account (available in the US, Europe/UK, and Japan) ## Set Up an Amazon Pay Account If you already have an Amazon Pay merchant account and API credentials, skip ahead to [Installing the Plugin](https://docs.j2commerce.com/v6/payment-methods/payment_amazonpay#installing-the-plugin). ### Register as an Amazon Pay Merchant 1. Go to [pay.amazon.com](https://pay.amazon.com) and click **Sign up**. 2. Log in with your Amazon Seller account or create a new one. 3. Follow the registration steps for your country and business type. 4. Once approved, you will have access to **Seller Central** and **Integration Central**. ### Get Your API Credentials Amazon Pay uses four credentials: a Merchant ID, a Store ID (Client ID), a Public Key ID, and a Private Key. 1. Log in to [Seller Central](https://sellercentral.amazon.com) and navigate to **Amazon Pay** **->** **Integration** **->** **Integration Central**. 2. Under **API Keys**, click **Create new key**. 3. Choose **Sandbox** or **Production** depending on your environment. 4. Download the private key `.pem` file immediately — Amazon only lets you download it once. 5. Copy the **Public Key ID** displayed on screen (sandbox keys start with `SANDBOX-`). 6. Your **Merchant ID** appears under **Account Settings** in Seller Central. 7. Your **Store ID** (Client ID) appears in Integration Central under the application you registered — format: `amzn1.application-oa2-client.xxxxx`. > **Tip:** Create sandbox credentials first and complete end-to-end testing before generating production keys. Sandbox keys are clearly prefixed with `SANDBOX-` so they cannot be accidentally used in live mode. ## Purchase and Download This plugin is a separate add-on available from the **J2Commerce Extensions Store**. It is not included with the core J2Commerce 6 component. **Step 1:** Go to the [J2Commerce](https://www.j2commerce.com/extensions) website **->** **Payment Plugins** **Step 2:** Locate **Amazon Pay** **->** click **View Details** **->** **Add to Cart** **->** **Checkout** **Step 3:** Go to your **My Downloads** under your profile button at the top right corner and search for the plugin. Click **Available Versions -> View Files -> Download Now** ## Installing the Plugin You can install this **Amazon Pay** plugin using the Joomla installer. The following steps help you with a successful installation. In the Joomla admin, go to **System -> Install -> Extensions** Upload the `payment_amazonpay.zip` file or use the Install from URL option. ![Joomla System Dashboard with System in the sidebar and the Install section's Extensions link highlighted, used to upload a plugin package](https://docs.j2commerce.com/images/docs/shared/autho-install5.webp) ## Enable the Plugin Once you have installed the extension, you will need to enable it. There are **two** ways you can access the extension. **Option A:** Go to the **J2Commerce** icon at the top right corner **-> Setup -> Payment Methods** **Option B:** Go to **Components** on the left sidebar **-> J2Commerce -> Dashboard -> Setup -> Payment Methods** ![Payment Methods list with a 1 item(s) published message, opened through Components and the J2Commerce menu: Setup and Payment Methods highlighted](https://docs.j2commerce.com/images/docs/shared/autho-methods.webp) Look for **Amazon Pay**, click the **X,** and it will turn into a green checkmark. It is now enabled and ready for setup. ![Payment Methods list searched for amazon, with the search box and the enabled Status check on the Amazon Pay row outlined (version 6.1.1)](https://docs.j2commerce.com/images/docs/shared/amazon-enable.webp) ## Configuring the Plugin Click the **Amazon Pay** title to open the settings. The settings are organized across six tabs. > **Tip:** **Helpful tip:** Click the **Toggle Inline Help** button in the toolbar to show a short description below each field while you configure the plugin. ![Amazon Pay plugin with the Toggle Inline Help button highlighted and the help text Name to display to customers during checkout outlined under Display Name](https://docs.j2commerce.com/images/docs/shared/amazon-toggle.webp) ### Basic Settings tab ![Amazon Pay plugin, Plugin tab highlighted: Status Enabled, Display Name, logo image, Express Checkout, Region United States (NA), Authorize and Capture, Gold button](https://docs.j2commerce.com/images/docs/shared/amazon-basic.webp) **Display Name:** The label shown to customers at checkout **Display Image:** Optional logo shown next to the payment option at checkout **Checkout Mode:** How the checkout flow works — see options below - **Express Checkout (address + payment on Amazon):** The customer is redirected to an Amazon-hosted page where they select both their shipping address and payment method from their Amazon account. After confirming, they return to your store. This mode allows Amazon to collect the shipping address directly. - **Payment Only (payment on Amazon, address from checkout):** The customer enters their address on your checkout page as normal. When they reach the payment step, clicking the Amazon Pay button redirects them to Amazon to select their payment method only. This is similar to a hosted redirect gateway like WorldPay. **Region:** Your Amazon Pay registration region **Payment Action:** Whether to charge immediately or authorize first - **Authorize and Capture:** Funds are captured from the buyer's account immediately when the order is placed. Choose this for most stores. - **Authorize Only:** A hold is placed on the buyer's account but no money is taken. You must manually capture from the order admin page. Use this if you want to verify stock or weight before charging. **Product Type:** Express mode only — whether Amazon collects a shipping address - **Pay and Ship:** Amazon collects the buyer's delivery address. Use this for physical goods. - **Pay Only:** Amazon only collects the payment method. Use this for digital goods or downloads where no shipping address is needed. **Button Color:** Color of the Amazon Pay button displayed at checkout **Checkout Language:** Language shown on the Amazon-hosted checkout page **Restrict PO Boxes:** Express mode only — prevents PO Box shipping addresses **Currency Handling:** Whether to charge in the buyer's selected currency or always use your ledger currency **Enable Subscriptions:** Allow subscription products to be purchased with Amazon Pay **Allow Saved Payment Methods:** Let logged-in customers keep their Amazon Pay agreement for renewals and admin charges **Template Style:** Frontend layout for checkout forms **Show Dashboard Icon:** Add an Amazon Pay icon tile to the J2Commerce dashboard **Debug Logging:** Write API activity to `administrator/logs/payment_amazonpay.php` --- ### API Credentials ![Amazon Pay plugin, API Credentials tab highlighted: Sandbox Mode Yes, with Merchant ID, Store ID, Public Key ID and Private Key (PEM) fields (values hidden)](https://docs.j2commerce.com/images/docs/shared/amazon-api.webp) **Sandbox Mode:** Toggle on to use Amazon Pay's test environment. No real charges occur. Toggle off when you are ready to accept real payments. When **Sandbox** is on, the fields below accept sandbox credentials. When off, they accept live credentials. **Merchant ID:** Your Amazon Pay Merchant ID from Seller Central **Store ID (Client ID):** Format: `amzn1.application-oa2-client.xxxxx` — from Integration Central **Public Key ID:** Your API public key ID. Sandbox keys start with `SANDBOX-` **Private Key (PEM):** Paste the full contents of your `.pem` private key file > **Info:** The private key is a multi-line text block that begins with `-----BEGIN RSA PRIVATE KEY-----`. Paste the entire block including the header and footer lines into the **Private Key** field. --- ### Order Status ![Amazon Pay plugin, Order Status tab highlighted: Payment Received Confirmed, Authorized Processed, Failed, Cancel status Cancelled, Refund status Refunded](https://docs.j2commerce.com/images/docs/shared/amazon-status.webp) Configure which order status J2Commerce sets at each stage of a payment. **Payment Received Status:** Status set after a successful payment capture **Authorized Status:** Status set when payment is authorized but not yet captured **Failed Status:** Status set when payment fails **Change Status on Cancel:** Automatically update status when a charge is canceled **Cancel Order Status:** Status to apply after a charge cancellation (shown when above is Yes) **Change Status on Refund:** Automatically update status when a refund is processed **Refund Order Status:** Status to apply after a refund (shown when above is Yes) > **Info:** If the status you need does not appear in any dropdown, create it first by going to **J2Commerce -> Setup -> Order Statuses**. ![J2Commerce Order Statuses list with the J2Commerce menu open at the right, highlighting Setup and its Order Statuses item](https://docs.j2commerce.com/images/docs/shared/shipstation-order-status2-1.webp) --- ### Surcharge ![Amazon Pay plugin, Surcharge tab highlighted: empty Surcharge Name, Surcharge Percent 0, Surcharge Fixed 0, Surcharge Tax Class Not Taxable](https://docs.j2commerce.com/images/docs/shared/amazon-surcharge.webp) Add an optional surcharge to orders paid with Amazon Pay. You can combine a percentage and a fixed amount — both are added together. **Surcharge Name:** Label shown to customers (e.g., "Processing Fee") **Surcharge Percent:** Percentage of the order subtotal to add **Surcharge Fixed:** Fixed amount to add in your store currency **Surcharge Tax Class:** Tax profile to apply to the surcharge --- ### Restrictions ![Amazon Pay plugin, Restrictions tab highlighted: Geo Zone Restriction All, Minimum Subtotal 0 and Maximum Subtotal -1](https://docs.j2commerce.com/images/docs/shared/amazon-restrictions.webp) Control which customers see Amazon Pay at checkout. **Geo-Zone Restriction:** Only show Amazon Pay to customers in a specific geo-zone. Leave empty for all customers **Minimum Subtotal:** Hide Amazon Pay if the cart subtotal is below this amount. Leave at `0` for no minimum **Maximum Subtotal:** Hide Amazon Pay if the cart subtotal exceeds this amount. Set to `-1` for no maximum --- ### Custom Messages ![Amazon Pay plugin, Custom Messages tab highlighted: empty On Selection, Before Payment, After Payment, On Error and Order Cancelled texts, and a Thank You Article picker](https://docs.j2commerce.com/images/docs/shared/amazon-messages.webp) These optional text fields let you customize messages shown to customers at different points in the payment process. **On Selection:** When the customer selects Amazon Pay as their payment method **On Before Payment:** On the payment page before the customer clicks the Amazon Pay button **On After Payment:** On the confirmation page after a successful payment **On Error Payment:** When a payment error occurs **On Cancel Payment:** When the customer cancels payment and returns to the cart **Thank You Article:** A Joomla article to display on the confirmation page after payment --- ## Checkout Experience ### Express Checkout Flow When a customer selects Amazon Pay in Express Checkout mode: 1. They click the **Amazon Pay** button on your checkout page. 2. They are redirected to Amazon to log in and confirm their address and payment method. 3. After confirming, Amazon redirects them back to your store review page. 4. The customer clicks **Place Order** to complete the purchase. 5. Payment is processed and the confirmation page is shown. ### Payment Only Flow When a customer selects Amazon Pay in Payment Only mode: 1. The customer fills in their delivery address on your standard checkout page. 2. At the payment step, they click the **Amazon Pay** button. 3. They are redirected to Amazon to choose their payment method from their account. 4. Amazon redirects them back to your store and the order is completed. --- ## Order Management After a customer pays, J2Commerce records the Amazon Pay transaction details on the order. ### Capture an Authorized Payment If you set **Payment Action** to **Authorize Only**, payments are held but not captured. To collect the funds: 1. Go to **J2Commerce -> Sales -> Orders** and open the order. 2. Look for the **Payment** section on the order page. 3. Click **Capture** to collect the authorized amount. 4. The order status updates to the status you configured. ### Cancel an Authorized Charge If payment has been authorized but not yet captured: 1. Go to **J2Commerce -> Sales -> Orders** and open the order. 2. In the **Payment** section, click **Cancel Charge**. 3. Confirm the action. The authorization is released and no funds are collected. ### Issue a Refund You can refund a captured payment directly from the order admin page: 1. Go to **J2Commerce -> Sales -> Orders** and open the order. 2. In the **Payment** section, click **Refund**. 3. Leave the amount blank for a full refund, or enter a specific amount for a partial refund. 4. Confirm the refund. The funds are returned to the customer's Amazon account. ### Charge a Saved Payment Method If the customer has a saved Amazon Pay agreement and **Allow Saved Payment Methods** is enabled, you can charge their agreement from the order admin page: 1. Go to **J2Commerce -> Sales -> Orders** and open the order. 2. In the order summary, find the **Charge Saved Amazon Pay** section. 3. Select the saved agreement from the dropdown. 4. Enter the amount to charge (defaults to the outstanding balance). 5. Click **Charge Now**. This is useful for phone orders, manual renewals, or collecting additional charges. --- ## Subscriptions When **Enable Subscriptions** is set to **Yes**, customers can use Amazon Pay for subscription products (requires the app_subscriptionproduct add-on). At checkout, Amazon Pay creates a recurring Charge Permission that authorizes your store to collect future renewal charges. Each renewal is automatically charged by the J2Commerce scheduler without requiring the customer to log in again. When a subscription is canceled, J2Commerce closes the recurring Charge Permission in Amazon Pay. --- ## Saved Payment Methods When **Allow Saved Payment Methods** is enabled, customers who complete a subscription checkout or agree to save their payment method have their Amazon Pay Charge Permission stored securely in your store database (in the `#__j2commerce_paymentprofiles` table). The actual payment credentials remain with Amazon — only an agreement token is stored. Customers can view and manage saved methods in **My Account -> Payment Methods** on the frontend. --- ## Notifications (IPN) Amazon Pay sends Instant Payment Notifications (IPN) to your store via Amazon's SNS (Simple Notification Service). These notify J2Commerce of events such as charge captures, declines, cancellations, and refunds. The IPN endpoint URL is: `https://[your-site.com]/index.php?option=com_ajax&plugin=payment_amazonpay&group=j2commerce&task=ipn&format=raw` Register this URL in Amazon Pay Integration Central under your application's **IPN settings**. When an IPN arrives, J2Commerce verifies the X.509 certificate and updates the order status automatically. --- ## Going Live Checklist Before accepting real payments: - [ ] **Sandbox** is set to **No** - [ ] Your live **Merchant ID**, **Store ID**, **Public Key ID**, and **Private Key** are entered - [ ] Your live private key `.pem` file is pasted in full - [ ] You have placed a test order end-to-end in sandbox mode and received a Confirmed status - [ ] Your IPN endpoint URL is registered in Amazon Pay Integration Central - [ ] **Debug Logging** is set to **No** - [ ] Your Amazon Pay account has completed identity verification and is approved for production --- ## Troubleshooting ### Amazon Pay button does not appear at checkout **Cause:** The plugin is not enabled, credentials are missing, or the Region is set incorrectly. **Solution:** 1. Go to **J2Commerce -> Setup -> Payment Methods** and confirm Amazon Pay shows a green checkmark. 2. Open the plugin settings and check that all four credential fields are filled in (Merchant ID, Store ID, Public Key ID, Private Key). 3. Verify the **Region** matches your Amazon Pay registration (US, EU, or JP). Mismatched regions cause the button to fail silently. 4. Enable **Debug Logging** and check `administrator/logs/payment_amazonpay.php` for error messages. ### Dashboard shows a warning about Amazon Pay credentials **Cause:** One or more credential fields are empty for the current mode (sandbox or live). **Solution:** Open the plugin settings and ensure all four fields in the **API Credentials** tab are filled in for the active mode. ### Order stays Pending after the customer returns from Amazon **Cause:** The checkout session was not completed correctly, or a network error interrupted the return redirect. **Solution:** 1. Enable **Debug Logging** and reproduce the issue. 2. Check `administrator/logs/payment_amazonpay.php` for the checkout session response. 3. Verify that your site URL in J2Commerce configuration matches the URL Amazon redirects back to. Mismatches cause session verification to fail. ### Refund fails with an error **Cause:** The charge has already been fully refunded, the charge ID is missing, or the Amazon Pay account does not have sufficient funds for the refund. **Solution:** 1. Open the order and confirm a **Transaction ID** is recorded. 2. Check `administrator/logs/payment_amazonpay.php` for the API error code. 3. Verify the refund amount does not exceed the captured amount minus any previous refunds. ### Saved payment method not appearing for admin charge **Cause:** **Allow Saved Payment Methods** is disabled, or the customer did not complete a checkout that created a saved agreement. **Solution:** 1. Verify **Allow Saved Payment Methods** is set to **Yes** in the plugin settings. 2. Saved agreements are created during subscription checkouts or when a customer pays with Amazon Pay and an agreement is stored. Regular one-time orders do not automatically save the agreement unless a subscription is in the cart. ### "Amazon Pay is running in SANDBOX mode" warning appears on the dashboard **Cause:** **Sandbox Mode** is set to **Yes**. **Solution:** If you are ready to go live, open the plugin settings, switch **Sandbox** to **No**, and enter your production credentials. --- ## Support - **J2Commerce documentation:** [docs.j2commerce.com](https://docs.j2commerce.com/index.php?option=com_content&view=category&id=8) - **J2Commerce support:** [www.j2commerce.com](https://www.j2commerce.com/support) - **Amazon Pay documentation:** [developer.amazon.com/docs/amazon-pay](https://developer.amazon.com/docs/amazon-pay/intro.html) - **Amazon Pay Integration Central:** [sellercentral.amazon.com](https://sellercentral.amazon.com)