| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| gateways:amazon_payments [2015/05/15 11:02] – [We're Sorry Error] adam | gateways:amazon_pay [2023/07/25 20:31] (current) – [Accepting donations, or selling alcohol, smoking/tobacco or higher risk products?] adam |
|---|
| ---- dataentry gateway ---- | ---- dataentry gateway ---- |
| type : gateway # do not change this line | type : gateway # do not change this line |
| name : Amazon Payments # | name : Amazon Pay # |
| countries : US # | countries : US # |
| support-added : 2.0 # | support-added : 2.0 # |
| support-removed : # | support-removed : # |
| auth-net-emulation : no # enter "yes" or "no" (without quotes) | auth-net-emulation : no # enter "yes" or "no" (without quotes) |
| supports-3dsecure : no # enter "yes" or "no" (without quotes) | supports-3dsecure : yes # enter "yes" or "no" (without quotes) |
| gateway_url : https://payments.amazon.com/solutionproviders # | supports-multicurrency : # enter "yes" or "no" (without quotes) |
| | gateway_url : https://payments.amazon.com/solutionproviders # |
| ---- | ---- |
| |
| |
| |
| ====== Amazon Payments ====== | |
| | |
| | ====== Amazon Pay ====== |
| |
| ===== Before You Begin… ===== | ===== Before You Begin… ===== |
| <WRAP tip>__**Do you already have an Amazon merchant account?**__ | |
| Amazon has a few different options, including Checkout by Amazon (CBA), Amazon Simple Pay (ASP), and Flexible Payment System (FPS). **None of those** are what you're going to use here.</WRAP> | |
| |
| Instead, this is Amazon's latest integration, "Login and Pay with Amazon". Even if you already have another Amazon merchant account, you'll need to complete the steps below. If you attempt to use credentials from a different Amazon system, you'll get errors. We know this is confusing, but ASP and FPS are going away soon, at which point things likely will become more clear. | <WRAP center round important 60%> |
| | Please note that the Amazon Pay integration currently only supports US based merchants. |
| | </WRAP> |
| |
| |
| ==== What about my existing subscribers on ASP? ==== | ==== Accepting donations, or selling alcohol, smoking/tobacco or higher risk products? ==== |
| Glad you asked! Get in touch with us for more info, but Amazon will announce details by mid-May. Your ASP subscriptions will be able to transfer to FoxyCart to run on Pay with Amazon, without any action required from your customers. | Before getting started - we recommend ensuring that the types of products/services you will be selling through Amazon Pay will meet their [[https://pay.amazon.com/us/help/6023|Acceptable Use policy]]. Amazon currently do not allow donations to be accepted, or to sell alcohol or smoking/tobacco products, along with a number of other restrictions. If you're not sure if your business type is supported, we recommend reaching out to Amazon Pay support to clarify with them. |
| |
| |
| ===== Setting Up Amazon Payments for FoxyCart ===== | ==== Check with Amazon about your Sales Velocity ==== |
| | Some of our users have run into errors accepting payments for larger dollar amounts. This is due to Amazon's "[[http://www.amazon.com/gp/help/customer/display.html?ie=UTF8&nodeId=3485871|sales velocity]]". This is beyond our control at FoxyCart, but is worth checking with Amazon about if you sometimes get large orders or if you're expecting more sales than usual. |
| |
| - [[https://sellercentral.amazon.com/hz/me/sp/signup?solutionProviderReturnURL=https%3A%2F%2Fadmin.foxycart.com%2Fadmin%3Faction%3Dregister&solutionProviderOptions=mws-dacc%3Blwa%3B&marketplaceId=AGWSWK15IEJJ7&solutionProviderToken=AAAAAQAAAAEAAAAQuzbVz3NEVwCE7%2BhVF09q1AAAAJAXBXKCR9%2FS267%2BAelgtEWDiJrSNHdpbvYGwucm20mgAZH6vj8yrn6dv%2B6LSejkCmRvKzFuRYl818voMxtFIPuZEudN4nw0bRC8pyPAqyw9NMIrErd8GkOwraoMt8k%2Bwul%2FzAEj1ZDwcCdeniJJ1daaEpHnIMsbtL8tMhY24kOktZq8qP0dsTu2i%2BlPuhunX9Q%3D&solutionProviderId=A2OCOC47B2T82Z|Click this registration link]] | ==== Per Customer Billing Limits (per month) ==== |
| - Login using the desired Amazon Payments account. | Amazon limits the monthly charges a new Seller can make to a customers account when they chose to store their payment information with your store. Please see [[https://payments.amazon.com/help/201498120|their policy for more information]] and how to contact them to request an increase. |
| - Create a **Login with Amazon** profile. | |
| - The **Application Name** and **Description** will be shown when buyers Login on your site. | ===== Setting Up Amazon Pay for FoxyCart ===== |
| - The **Privacy Notice URL** is required and should link to an appropriate page on your site. | |
| - The **Allowed Login Domain** should be the secure URL that the checkout will be served from, for example: https://mystore.foxycart.com | - Login to your store's Foxy administration, and proceed to the "payments" page. |
| - **Consent** to allow FoxyCart to make API calls on your account. | - If your store has multiple payment sets, ensure that the correct payment set is active. |
| - If you don't already have the [[https://admin.foxycart.com/|FoxyCart admin]] open, go there in a new tab, and click the settings -> payment page link. Scroll down a little to find the "Accept payments using your Amazon account" checkbox. Check it and notice the **Seller ID** and **Client ID** fields. We'll get those in the next steps. (Keep the FoxyCart admin open in a browser tab so you can copy/paste the values.) | - Check the option for "Accept payments using your Amazon Pay account", and click the "Connect to Amazon Pay" button shown there. |
| - The **Seller ID** can be found in your Amazon Payments account on [[https://sellercentral.amazon.com|Seller Central]] | - You will be redirected over to Amazon Pay - where you can either log in to your existing Amazon Pay account, or create a new one if you don't already have an account. Complete the required steps and provide all of the necessary information for your account. |
| - Login to your [[https://sellercentral.amazon.com|Seller Central]] account | - Once completed, you will see a page letting you know the process is complete with a button labelled "Transfer credentials to FoxyCart". Click this button and you will be redirected back to your store's Foxy administration - with your Amazon Pay credentials automatically added to your store. |
| - If not already selected, choose //Amazon Payments Advanced (Production View)// from the drop-down in the menu bar. (This should be to the left of the magnifying glass icon in the top right. Depending on your browser screen size, this might be a little double-arrow icon you need to click.) | |
| - On the right side choose **Settings**->**Integration Settings** | ==== Adding Amazon Pay credentials manually ==== |
| - The **Merchant ID** shown is the value for **Seller ID** in your FoxyCart configuration screen | |
| - The **Client ID** refers to your **Login with Amazon** Client ID. To get this value: | If you haven't previously connected your Amazon Pay to Foxy, we strongly recommend using the approach detailed above to link your Amazon Pay account to your Foxy store. If you have existing Amazon Pay credentials that you need to add to your Foxy store though, you can follow these instructions: |
| | |
| | - Login to your store's Foxy administration, and proceed to the "payments" page. |
| | - If your store has multiple payment sets, ensure that the correct payment set is active. |
| | - Check the option for "Accept payments using your Amazon Pay account", and if the fields aren't already visible, click the "Enter Manually" link. |
| | - All three fields can be found in your Amazon Pay account on [[https://sellercentral.amazon.com|Seller Central]] |
| - Login to your [[https://sellercentral.amazon.com|Seller Central]] account | - Login to your [[https://sellercentral.amazon.com|Seller Central]] account |
| - Select //Login with Amazon// from the drop-down menu in the menu bar. (This should be to the left of the magnifying glass icon in the top right. Depending on your browser screen size, this might be a little double-arrow icon you need to click.) | - If not already selected, choose //Amazon Pay Advanced (Production View)// from the drop-down in the menu bar. (This should be to the left of the magnifying glass icon in the top right. Depending on your browser screen size, this might be a little double-arrow icon you need to click.) |
| - Select the application configured for your account, on the left. | - In the top menu choose **Integration**->**MWS Access Key** |
| | - The **Seller ID** shown is the value for **Seller ID** in your FoxyCart configuration screen. |
| - The **Client ID** shown is the value you will enter for **Client ID** in the FoxyCart configuration page. | - The **Client ID** shown is the value you will enter for **Client ID** in the FoxyCart configuration page. |
| | - <wrap hi>Make sure your solution provider is FoxyCart. If it isn't - you should complete the process detailed above instead.</wrap> |
| | - To obtain the **MWS AuthToken** click the "Show Secret" button. It should be in the format of ''amzn.mws.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'' where the ''x'''s are hex characters (letters and numbers). Copy and paste its value to the appropriate field in the FoxyCart configuration page. |
| | - Click "Update Payment Gateway" at the bottom of the page to save the new credentials |
| |
| ==== Setting up the Instant Payment Notifications ==== | ==== Setting up the Instant Payment Notifications ==== |
| <WRAP center round important 90%> | <WRAP center round important 90%> |
| **Important:** Ensure this step is completed for your Amazon Payments account, as without it transactions could fail to complete correctly. | **Important:** Ensure this step is completed for your Amazon Pay account, as without it transactions could fail to complete correctly. |
| </WRAP> | </WRAP> |
| |
| - Login to your [[https://sellercentral.amazon.com|Seller Central]] account | - Login to your [[https://sellercentral.amazon.com|Seller Central]] account |
| - Head to "Integration Settings" under the "Settings" menu. | - Head to "Integration Settings" under the "Settings" menu. |
| | - Make sure you're on your Production (not Sandbox) account. (If you're on Sandbox, you'll see "Sandbox" in the upper left, under the Amazon logo.) |
| - For the "Integrator URL" setting, enter the URL ''https://FOXYCART-STORE-DOMAIN/ipn.php''. | - For the "Integrator URL" setting, enter the URL ''https://FOXYCART-STORE-DOMAIN/ipn.php''. |
| - If your FoxyCart store domain is ''mystore.foxycart.com'', your IPN URL would be ''https://mystore.foxycart.com/ipn.php''. | - If your FoxyCart store domain is ''mystore.foxycart.com'', your IPN URL would be ''https://mystore.foxycart.com/ipn.php''. |
| |
| |
| ==== Using multiple domains? ==== | ==== Whitelist your FoxyCart Domain ==== |
| | |
| In some cases, you might be using multiple domains, so may need to add additional Allowed Login Domains. To do so, you: | |
| |
| - Login to [[https://sellercentral.amazon.com]]. | - Login to [[https://sellercentral.amazon.com]]. |
| - Select the store from “Applications” on the left-side of the page. | - Select the store from “Applications” on the left-side of the page. |
| - Under “Web Setting” in the main body of the page, click the “Edit” button. | - Under “Web Setting” in the main body of the page, click the “Edit” button. |
| | - Add your FoxyCart checkout domain. For example, if your checkout is at ''https://yourstore.foxycart.com/checkout'', then the value for 'Allowed JavaScript Origins' should be ''https://yourstore.foxycart.com/'' |
| - Add each domain used by the site under “Allowed Javascript Origins” by clicking “Add Another". | - Add each domain used by the site under “Allowed Javascript Origins” by clicking “Add Another". |
| | - In the next setting for "Allowed Return URLs", you'll also need to enter in a specific URL for your checkout. Again, if your checkout is ''https://yourstore.foxycart.com/checkout'', you will need to enter an "Allowed Return URL" of ''https://yourstore.foxycart.com/checkout?fc_payment_method=amazon_aws'' |
| ===== Testing ===== | ===== Testing ===== |
| |
| |
| ===== Troubleshooting & Interpreting Response Codes ===== | ===== Troubleshooting & Interpreting Response Codes ===== |
| | |
| | ==== Resolving Suspended Merchant Agreements ==== |
| | |
| | If a customer's subscription has ended up in a suspended state due to a payment method being declined - they will need to update their payment details in their Amazon Pay account. You can [[https://pay.amazon.com/us/help/202163190|send them to this page]] for steps they can take to bring the agreement back into an open state. |
| |
| ==== "We're Sorry" Error ==== | ==== "We're Sorry" Error ==== |
| |
| If when trying Amazon Payments after entering your credentials in the administration you receive an error notice in the popup, look for the "Show Details" link and click that to see technical details for what went wrong. | If when trying Amazon Pay after entering your credentials in the administration you receive an error notice in the popup, look for the "Show Details" link and click that to see technical details for what went wrong. |
| Usually you will see the following: | Usually you will see the following: |
| |
| |
| The status node can contain one of three different values: ''pending'', ''approved'' or ''rejected''. Depending on the types of actions you're needing to perform at your datafeed endpoint, you need to make sure the appropriate status value is present. | The status node can contain one of three different values: ''pending'', ''approved'' or ''rejected''. Depending on the types of actions you're needing to perform at your datafeed endpoint, you need to make sure the appropriate status value is present. |
| | |
| ===== User Notes and Experiences ===== | ===== User Notes and Experiences ===== |
| <wrap tip>If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date.</wrap> We reserve the right to edit or remove comments that don't add value to this page. | <wrap tip>If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date.</wrap> We reserve the right to edit or remove comments that don't add value to this page. |
