Follow

Configuration

CONFIGURATION V1.X.X

API SETTINGS

  • Sandbox mode: Activates/Deactivates sandbox mode, if activated all requests will be send to the sandbox system
  • Save all logs: Activates full logging of all activities, see also Hints for developers 

 

LOCALE SETTINGS

  • Amazon API Locale: Choose the country of your Amazon Payments
    merchant account, Endpoint, Widget and Button URL´s are set
    automatically.
  • Choose „Custom“ only if your country is not listed and enter all
    needed Urls

 

 

CONFIGURATION V2.X.X

API SETTINGS

  1. Sandbox mode: mode dedicated for testing purposes. No real
    transactions will be made when this option is selected. Every
    customer should use this mode while testing. To go LIVE with real
    transactions this mode has to be turned off.
  2. Seller (Merchant) ID: Merchant ID issued by Amazon Payments and
    found in your seller merchant account details
  3. Amazon MWS key: Issued by Amazon and found in your Seller Central
    account details
  4. MWS Secret Key: Issued by Amazon and found in your Seller Central
    account details
  5. Logging enabled: Option which allows you to enable/disable logging
    of every Amazon Pay request, including Amazon Pay IPNs. Recommended
    to be turned on every time. All logs are found in: log/bestitamazon/
    directory
  6. Amazon Pay and Login with Amazon:
    https://sellercentral-europe.amazon.com/hz/me/integration/details

 

api-settings.png

 

 

AMAZON LOGIN SETTINGS

  1. Amazon Login active: To use Login with Amazon functionality this
    option has to be enabled. Login with Amazon button appears ONLY
    in specific pages (eg. my account, registration etc.) or parts of the
    page (ex. Login box in header) and ONLY in pages loaded under SSL
    (HTTPS). Important: If this option is enabled you will be able to use
    full features of „Amazon Pay and Login with Amazon“ functionality.
    If this option will be disabled you will be switched to regular Amazon
    Pay functionality, and all settings below in „Login with Amazon“
    won‘t apply.
  2. Client ID: This field MUST be filled if you are using Amazon Login
    functionality. The Client Id can be found in the Seller Central (Integration
    -> MWS Access Key).
  3. Login with Amazon Button style: Defines the button style of the
    „Login with Amazon“ buttons.
  4. Pay Button style: Defines the button style of the „Amazon Pay“
    buttons.

 

amazon-login-settings.png

 

 

LANGUAGE SETTINGS

Here the language mapping from OXID to Amazon Pay is defined.
Valid values can be found at: pay.amazon.com/de/developer/

 

language-settings.png

 

MERCHANT ACCOUNT REGISTRATION

  1. Country of Merchant Account Registration: That‘s the main market
    to select in which you are going to do your sales - it should meet
    your seller account opening country. (Ex. If your account was opened
    in pay.amazon.com/de it has to be DE). If you want to set your
    custom Localization settings please select „Custom (Please enter
    details below)“ and set all the details into input fields below.
  2. Custom Endpoint URL: please fill this field ONLY if you want to use
    other than default value for that, otherwise leave it empty.
  3. Custom Endpoint URL (Sandbox): please fill this field ONLY if you
    want to use other than default value for that, otherwise leave it
    empty. This setting applies just in Sandbox mode.
  4. Custom Widget URL: please fill this field ONLY if you want to use
    other than default value for that, otherwise leave itempty
  5. Custom Widget URL (Sandbox): please fill this field ONLY if you
    want to use other than default value for that, otherwise leave it
    empty. This setting applies just in Sandbox mode.
  6. Custom Button URL: please fill this field ONLY if you want to use
    other than default value for that, otherwise leave it empty
  7. Custom Button URL (Sandbox): please fill this field ONLY if you want
    to use other than default value for that, otherwise leave it empty. This
    setting applies just in Sandbox mode.

 

merchant-account-localization.png

 

 GENERAL CONFIGURATION

  1. Authorize Mode: The Authorize operation functions in one of two
    modes: Synchronous/Asynchronous.
    a) Asynchronous mode: In this mode, the Authorize operation always
    returns a Pending status in API response and you must listen to
    our Instant Notification to obtain the final processing status (Open
    or Declined).
    b) Synchronous mode: In this mode, the Authorize operation will always
    return an Open or Declined status in the API response. (More
    recommended option for OXID).
  2. Status updates
    a) Receive status updates via IPN: Amazon IPN sends transaction
    status updates to [https://www.yourdomain.com]/index.php?cl=bestitamazonipn]
    You have to add this address in seller account details
    to receive IPN notifications from Amazon Payments. (Recommended
    option)
    b) Poll status updates via Cron job: If you are not going to use IPN
    notifications you have to set up cron job and run the link: [http://
    www.yourdomain.com]/index.php?cl=bestitamazoncron. Recommended
    time to run the script is every 5-15 minutes. After every run of
    the script orders status will be updated.
  3. Capture handling
    a) Capture after order has been marked as shipped: Funds will be
    captured from customer by Amazon when customer will click „Ship
    Now“ button within the order details or „oxsenddate“ will be updated
    with the shipping date (Only in case: Status updates: Poll status
    updates via Cron job is selected). For IPN notifications you have
    to do that manually if this setting was selected.
    b) Direct capture after Authorize (Permission from Amazon required!):
    Funds will be captured instantly after successful Authorize
    request (Status: Open) Please be aware: Setting „Capture handling“
    to „Direct Capture after Authorize“ requires prior approval
    from Amazon Payments!
  4. ERP Mode: When ERP Mode is selected all handling of Amazon
    Transactions, status updates will be managed ONLY by ERP.
  5. ERP Mode Order Status: Status value that will be saved to oxorder
    table oxtransstatus field when ERP mode is selected. If ERP mode
    is not active this value will be ignored. Please use ERP Mode only
    when some 3rd party will take care of Amazon Order Authorization/
    Capture processes, no Authorize/Capture requests will be sent automatically
    if ERP Mode is turned ON.
  6. Sandbox Simulation mode: Several simulation modes for testing
    purposes. Will work only while in Sandbox mode.

 

configuration.png

 

 Tick "Activate multi-currency functionality" if your shop supports multi currency.
In the other three options you can adjust where the Amazon Pay button should be displayed.

GENERAL CONFIGURATION - PAYMENT METHOD
CONFIGURATION

The new Amazon Pay payment method will be listed like the other
payment methods at the backend. To setup it up please follow the
this guide: https://www.oxid-esales.com/de/support-services/dokumentation-und-hilfe/oxid-eshop/einrichtung/zahlung-und-versand.html

 

GENERAL CONFIGURATION - SETUP CRONJOBS

To setup the cronjobs please use Crontab or the cronjob management
provided by your hoster. For more information how to setup a cronjobs
please ask your hoster. The command which you need to run is the
following:


wget [http://www.yourdomain.com]/index.php?cl=bestitamazoncron]


If you are using the multi shop feature of OXID you need the append
the right shop id. For example:


wget [http://www.yourdomain.com]/index.php?cl=bestitamazoncron&shp=1]
wget [http://www.yourdomain.com]/index.php?cl=bestitamazoncron&shp=2] 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments