Description, Capabilities and Restrictions
  • Amazon only supports EUR, GBP and USD. Any other currencies must be converted to one of these
  • There are a couple of rules that need to be followed for the frontend integration. These are 
    • Wherever there is a link to the normal checkout there must also be one to the amazon checkout (checkout, not cart overview)
    • The “Amazon Pay” button has to appear as the top or right-most alternative checkout button.
    • Wherever an Amazon Pay button appears, it should come with an explanation what Amazon Pay is about, either as a descriptive text next to the button or as a mouse-over text on the button.
    • The Amazon Pay button design is the button design that has to be used. It is not allowed to use a different button graphic.
  • Language handling: Currently, all Amazon Pay widgets and other buyer-facing content are presented in the language of the seller’s account. Implementing a switching mechanism is not supported as of now.
  • There are two payment options: payment on order completion or payment on shipment. If payment on order completion is selected, then the complete order will be captured on order completion. In payment on shipment is active, then only downloads will be captured on order completion. All other products must be either captured via wawi status update or via the cms backend.
  • If you enable payment on shipping and a payment is soft declined (Invalid Payment Method) then the seller will be informed via email. The seller will then need to contact the buyer to ask them to change their payment method via Once that has been done the seller will need to manually run the payment collection again via the cms backend.



Run a system update after installing the Chameleon Amazon Pay Package:

Amazon Payments Installation

After updating there will be a new entry "Amazon Advanced Pay" in the back end table "Order process / payment provider": Amazon Payments Installation

Switch to tab "system" and enter your credentials and configuration parameters:

Amazon Payments Installation

You can find your account credentials and configuration data in your Amazon Seller Central back end: (Seller Central screenshot 1/2)


On this page you'll find your merchant id as well as the settings for your online shop Amazon API endpoint: (Seller Central screenshot 2/2)


Adding the module to your shops front end design
  • you need to include the mapper AmazonButtonWidgetMapper in 
    • customer/private/extensions/library/classes/pkgShop/views/db/TShopOrderStep/TShopStepBasket/standardSnippetBridge.view.php
    • customer/private/extensions/objectviews/TCMSMessageManagerMessage/layover.view.php
    • customer/private/framework/modules/MTShopBasket/views/mini.view.php
      $viewRenderer->AddMapper(new \ChameleonSystem\AmazonPaymentBundle\mappers\AmazonButtonWidgetMapper());
  • add the following to your extension in your custom theme 
    • customer/vendor/chameleon-system/themeshopstandard/snippets/pkgShop/shopBasket/shopBasketCheckoutBasketStep.html.twig
    • customer/vendor/chameleon-system/themeshopstandard/snippets/pkgShop/shopBasket/shopBasketAddedToBasket.html.twig There is a sample in the resource folder of this package
    • customer/vendor/chameleon-system/themeshopstandard/snippets/pkgShop/shopBasket/shopBasketArticleLayover.html.twig There is a sample in the resource folder of this package
      twig {% include 'pkgshoppaymentamazon/amazonbutton.html.twig' with {amazonPaymentButtonData} %}
  • link pkgshoppaymentamazon/Resources/views/pkgShop/views/pkgShop/views/db/TShopOrderStep/TShopStepLogin/ in following directory and include it at the bottom of /var/www/chameleon_shop_demo/customer/private/extensions/objectviews/pkgShop/views/db/TShopOrderStep/TShopStepLogin/userSnippetBridge.view.php
    php require_once(__DIR__."/");
  • link pkgshoppaymentamazon/Resources/snippets/pkgShop/OrderSteps/loginOptionsRow.html.twig in your custom theme
  • copy or symlink the assets from ./resources/pkgshoppaymentamazon-assets to httpdocs/assets/
  • any page from which the Amazon Pay can be called (usually the basket) needs to include the action plugin AmazonShopActionPlugin (this can be set via the portal or via the pagedef) - the name of the plugin is expected to be amazonActionPluginSpotName
  • you need to create a view for the Amazon Pay step in private/extensions/library/classes/pkgShop/views/db/TShopOrderStep/ChameleonSystemAmazonPaymentBundlepkgShopOrderStepsAmazonAddressStep. There is a sample in the resource folder of this package
  • you need to create a view for the Amazon Pay step in private/extensions/library/classes/pkgShop/views/db/TShopOrderStep/ChameleonSystemAmazonPaymentBundlepkgShopOrderStepsAmazonShippingStep. There is a sample in the resource folder of this package. note that this step is a copy of the original (nothing needs to change), so you can also link in your original step
  • you need to create a view for the Amazon Pay handler in private/extensions/library/classes/pkgShop/views/db/TShopPaymentHandler/ChameleonSystemAmazonPaymentBundlepkgShopAmazonPaymentHandler. There is a sample in the resource folder of this package.
  • the order confirm step needs some changes - you can find a sample confirm page in the resource folder of this package ** the payment handler must render the read only widget of the amazon wallet instead of just displaying the payment name ** amazon does not provide the billing address until after the order is confirmed. so we can not display a billing address on the confirm step.
  • you should add the Amazon Pay logo to your list of payment logos. The images you can find here
  • per default Amazon Pay will use the Sandbox environment. You need to add the following parameter to your parameters.yml to use the live environment: *if you include amazon button in your mini basket and the mini basket was displayed at the basket step set following variable in yout twig template before the amazon button include. {% set amazonIgnoreMessagesInSnippet = true %}
chameleon_system_amazon_payment.environment: "Live"