PayPal

Last updated

Ecwid supports PayPal Standard, PayPal Express Checkout, PayPal Advanced, PayPal Payflow Link, and PayPal Payments Pro solutions.

If you have sales related questions about setting up new PayPal service and would like to speak directly to a PayPal Product Specialist, call +1 (877) 455-1481.

If you have customer service related questions regarding an existing PayPal account and would like to speak directly to a PayPal Customer Service agent, call +1 (888) 221-1161.

  1. PayPal Standard
    1. How to set it up
  2. PayPal Express Checkout
    1. How to setup PayPal Express Checkout in Ecwid
    2. How to generate PayPal API signature
    3. How PayPal Express Checkout works
  3. PayPal Payflow Link and PayPal Payments Advanced
  4. PayPal Payments Pro Hosted (UK)
    1. How to set up
  5. FAQ and Troubleshooting
    1. Can my customers pay by credit card without creating or using a PayPal account ?
    2. Can I use Ecwid with PayPal if I have a personal account?
    3. I see a sale in the Paypal backend, but it isn't showing in Ecwid
    4. A customer has paid via PayPal, but orders are shown as "Awaiting Payment" in Ecwid control panel.
      1. PayPal has informed us that the payment is pending, i.e. you actually haven't got the money yet
      2. Error "This order is in the "Awaiting Payment" status, because the order total and the amount actually paid do not match. Please check this order in your PayPal Admin Area for possible issues"
      3. Error "The payment is pending because it was made to an email address that is not yet registered or confirmed"
      4. PayPal had some problems on their side
      5. Ecwid's internal anti-fraud mechanism has found something suspicious
    5. Error: "Cannot proceed with checkout because of an internal error. Please contact the website administrator"
    6. Error "We cannot process this transaction because there is a problem with the PayPal email address supplied by the seller"
    7. Error: "Unable to process payment"
    8. Error: "The seller accepts encrypted website payments only. You cannot pay the seller through un-encrypted buttons. Please contact your seller for more details"
    9. How can I use one Paypal account for multiple Ecwid stores?
    10. I get the "Merchant Design Identification Error" error when setting up PayFlow payment option.
    11. I am not redirected to PayPal mobile payment form, when I checkout on mobile device. Why is that?
    12. How to place a test order using PayPal?

PayPal Standard

It is the easiest in use and setup solution from PayPal. In addition to regular payments within PayPal accounts, this method allows to pay by credit cards without creating a PayPal account. 

You need to have a Business PayPal account. Check the video guide on how to create it: How to open a PayPal Business Account

How to set it up

In order to connect your PayPal merchant account to your Ecwid store you need to take the following steps:

1. Ecwid Control Panel

  • Go to Settings > Payment
  • Find the PayPal payment method.
  • Click the "Account details" link in the Payment Processor column. A popup will appear.
  • Insert the email address associated with your PayPal account. Save the changes.
  • Enable this payment method and save the changes.

2. PayPal backend

  • Log in to your PayPal account.
  • Proceed to My account > Profile (in the top right corner) > Profile and Settings > My selling tools

 

My_Profile_-_PayPal_2017-05-19_11-18-01.png

    • Find Instant Payment Notifications in the settings link and click "Update". Click "Choose IPN Settings" and select "Receive IPN messages (Enabled)" option. Type in the following URL in "Notification URL" field: http://app.ecwid.com/paypalstandard/STOREID where STOREID is your actual Store ID. For example: http://app.ecwid.com/paypalstandard/1003. Save the changes.

IPN is a message transmitted from PayPal to Ecwid via a special secure channel and indicating the status of the payment. So this setting will ensure that your Ecwid store is notified about whether the customer did complete the payment or if the transaction failed. Upon receiving such a notification, Ecwid updates the order status accordingly. Thus having IPN properly setup in your PayPal account is crucial for the automatic accepting of orders in Ecwid.

  • Also we highly recommend to enable the "Auto Return" option*. You can find it at Profile > My selling tools > Website Payment Preferences. Ecwid sends the necessary value of the Return URL in each request to PayPal.
  • Set up encoding preferences. Open Profile > My selling tools > PayPal button language encoding page. Press the "More Options" button. Then set "Encoding" to UTF-8, and "Do you want to use the same encoding for data sent from PayPal to you (e.g., IPN, downloadable logs, emails)?" to Yes. Save the changes.
  • If you have a Premier or Business PayPal account, go to Profile > My selling tools > Shipping Calculations and click "Update". Then select the checkbox next to the shipping method for a specific currency. Click the "Edit" button. Set "Use the shipping fee in the transaction instead of my calculator's settings" to Yes. Click "Save Changes". Perform these steps for each shipping method set in your PayPal account. If you don't have any shipping methods on this page, just skip this step.**

Please make sure you followed all the steps described above. Otherwise you may have issues with your PayPal orders.
If you have any questions about PayPal or if any steps are unclear, feel free to contact us.

* The auto-return will force your customers to return to your store after they have completed the payment at PayPal. Basically this setting isn't necessary: PayPal will show a button like 'return to the store' that will lead the customers back to the shop.

However, you may want to  enable it in the following cases:

a) If you want to track sales using Google Adwords  or any other tool, and you have a tracking code inserted added to the "Thank you for your order" page. In this case, the code is triggered when customers get to this page therefore you need to force the auto return.

b) If you're going to use one PayPal account in several separate Ecwid stores. Ecwid will pass the correct URL along with each payment request, so customers will be returned to the site where they started the checkout (i.e. your Ecwid shop).

** This step is necessary to avoid issues with shipping calculation. If you have any shipping rates configured in the PayPal account, they may override the rates from your Ecwid store. As a result the order may arrive as "Awaiting Payment" (see the FAQ below for more tips on this issue).

PayPal Express Checkout

It's a more advanced solution by PayPal. It provides an alternative checkout process for your Ecwid store.

How to setup PayPal Express Checkout in Ecwid

  • Log in to your Ecwid control panel.
  • Go to Settings > Payment page. Click the "See complete list" button and select "PayPal Express Checkout" in the drop-down.
  • Fill in all the necessary fields: API Username, API Password and Signature. You can get them from PayPal.
  • Save the changes.

How to generate PayPal API signature

Have you generated an API certificate or signature before?
1. If no, you need to generate a signature. Use the instructions provided by PayPal: Obtaining API Credentials.

2. If yes, then there are two options:

  • You generated the API signature but cannot find it in the PayPal backend. In this case you just need to grab it using the instruction posted above and use it in the Ecwid backend.
  • You generated the API certificate. Unfortunately, PayPal doesn't allow having an API signature and a certificate at the same time. So you should remove the certificate and generate the signature instead. Attention: if you're already running any shopping cart with your PayPal account and this cart uses an API certificate, the cart will not be able to process PayPal transactions. In this case you need to switch the cart to using a signature.

How PayPal Express Checkout works

  • you add products to cart
  • click "Checkout with PayPal"
  • Ecwid redirects you to the PayPal site
  • you sign in with the PayPal account or create a new one
  • PayPal redirects you back to Ecwid
  • Ecwid creates a new profile based on the information from PayPal and shows the last checkout page
  • you review your order, change the shipping method if necessary and press "Submit order"
  • Ecwid sends the request to PayPal in background, PayPal charges your credit card.

PayPal Payflow Link and PayPal Payments Advanced

PayPal Payflow Link andPayPal Advanced payment methods are available to merchants from the United States, Canada, Australia, New Zealand, and UK.


PayPal Advanced method is for the US merchants only.

PayPal Payflow is a "true" payment gateway that links your website to your merchant account (a type of bank account that allows businesses to accept payments by credit card and get payments directly to your bank) and payment processor (a company that handles credit card transactions for a merchant acquiring bank). More information about PayPal Payflow can be found here: https://www.paypal.com/webapps/mpp/payflow-payment-gateway

If you don't have a merchant account, you can use PayPal Payments Advanced: 
This payment method enables online stores to collect payments directly via credit card without leaving site as well. From an integration standpoint, PayPal Payments Advanced is identical to PayPal Payflow gateway (so you can use it with our Payflow integration), with the following exceptions:

  • PayPal Payments Advanced includes a merchant account with PayPal.
  • PayPal Express Checkout  and Bill Me Later payment methods cannot be disabled on the hosted checkout template for a PayPal Payments Advanced user.

Please, also refer to this page for more info:  https://www.paypal.com/webapps/mpp/paypal-payments-advanced

So, if you don't want to create a merchant account, go with PayPal Advanced to accept credit cards without leaving a website.

How to set up

  • Sign up for PayPal's Payflow Services
  • Log into PayPal Manager account, go to Service Settings > Hosted Checkout Pages > Set Up. Set "Enable Secure Token" to Yes. DO NOT change any other values on this page or on the Customize page, as Ecwid will pass these values on your behalf for ease of configuration.
  • In your Ecwid Control Panel, Go to Settings > Payment. In the PayPal payment method section, choose PayPal Payflow Link or PayPal Payments Advanced. 
  • Click the [Account Details] link near the payment method and enter your credentials in the settings popup.
  • Save the changes and enable this payment method.
  • Once you've verified that your account works correctly during the pilot, log in to PayPal Manager and click on Activate Account. 
  • Turn off the "Send transactions to the test server" option in the payment settings in your Ecwid control panel.

PayPal Payments Pro Hosted

PayPal Payments Pro Hosted offers a way to securely accept credit and debit cards or PayPal payments without your customers having to leave your Ecwid store: all payment options are displayed on the last checkout step in an inline frame.

PayPal Payments Pro Hosted works for the UK and France only.

How to set up

  • Sign up for a PayPal Payments Pro account
  • In your Ecwid Control Panel, Go to the Settings > Payment page. In the PayPal payment method section, choose PayPal Payments Pro Hosted, click "Apply".
  • Click the [Account Details] link and submit your PayPal Payments Pro account email in the settings popup. If you are using a sandbox PayPal account for testing, tick "This is a sandbox account"
  • Save the changes, enable this payment method, and click "Save".

FAQ and Troubleshooting

Can my customers pay by credit card without creating or using a PayPal account?

All PayPal services allow paying by credit card without registering a PayPal account. If your customers are prompted to sign up at PayPal to pay, there may be various reasons for that, starting from cookies setup and ending up with your PayPal account settings. This may also depend on the country where you or your customer is located as PayPal has different rules for different languages. Please refer to this post for the detailed instructions:
www.paypal-community.com/t5/How-to-use-PayPal/buy-now-button-requires-paypal-login-or-account/m-p/15587

Can I use PayPal if I have a PayPal Personal account?

No, you must have a PayPal Business or PayPal Premier account. 

I see a sale in the PayPal backend, but it isn't showing in Ecwid

If you see any order in PayPal and don't see it in Ecwid, first of all make sure that your PayPal module is set up properly and all the steps from the instruction above have been carried out. Pay particular attention to IPN messages — they must be enabled.

If all the PayPal settings are correct, open the "IPN History" page in your PayPal backend and check it for any errors or failed IPN messages. If you have any failed messages related to the missing orders there, try to re-send them:

  • Log in to your PayPal account and hover your mouse over History.
  • Click on IPN history from the menu.
  • On the Instant Payment Notification history page select All (Last N days).
  • Click Search.
  • Then mark the messages that need to be resent and click "Resend selected". 

If the above doesn't help, please report the issue to our support team, and we will investigate it closely.

A customer has paid via PayPal, but orders are shown as "Awaiting Payment" in Ecwid control panel.

If an order is successfully placed and you have fully charged the customer for it, it should get the "Paid" status. The "Awaiting Payment" status means that the order is pending or it has been placed but the money has not been transferred to your account yet. You can check what error is returned from PayPal in the order details in your Ecwid control panel > My Sales, order page, "Additional information" section.

There may be several reasons why some PayPal order get the "Awaiting Payment" status instead of "Paid". Please see them below

a. PayPal has informed us that the payment is pending, i.e. you actually haven't got the money yet.

Here is a list of possible pending reasons:

  • address: The payment is pending because your customer has not included a confirmed shipping address and your Payment Receiving Preferences is set to allow you to manually accept or deny each of these payments. To change your preferences, go to the Preferences section of your Profile in PayPal.
  • authorization: You set the payment action to "Authorization" and have not captured funds yet. The Payment Action parameter is set in your Ecwid control panel > Settings > Payment > PayPal Express Checkout tab. For the description of what each parameter means, please refer to: https://www.x.com/developers/community/blogs/ppintegrationsnate/paypal-express-checkout-payment-actions  If you want orders going through Express Checkout to be charged right away, you need to change this parameter to "Sale". 
  • echeck: The payment is pending because it was made by an eCheck that has not been cleared yet.
  • intl: The payment is pending because you hold a non-U.S. account and do not have a withdrawal mechanism. You should manually accept or deny this payment from your Account Overview.
  • multi-currency: You do not have a balance in the currency sent, and you do not have your Payment Receiving Preferences set to automatically convert and accept this payment. You should manually accept or deny this payment.
  • order: You set the payment action to "Order" and have not captured funds yet.  See comments about authorization above.
  • paymentreview: The payment is pending while it is being reviewed by PayPal for risk.
  • unilateral: The payment is pending because it was made to an email address that has not been registered or confirmed yet. 
  • upgrade: The payment is pending because it has been made via credit card and you should upgrade your account to Business or Premier status in order to receive the funds. Upgrade can also mean that you have reached the monthly limit for transactions on your account.
  • verify: The payment is pending because you have not been verified yet. You should verify your account first, and after that you will be able to accept this payment.
  • other: The payment is pending for some reason different from those listed above. For more information contact PayPal Customer Service.

The most frequent reason of all above is that a payment has been made by an eCheck that has not been cleared yet. After an eCheck is cleared (usually it takes 3-5 days), the order status will be changed to "Paid" automatically.

b. Error "This order is in the "Awaiting Payment" status, because the order total and the amount actually paid do not match. Please check this order in your PayPal Admin Area for possible issues."

Check the video guide on how to change them: How to change the settings on your PayPal Business account

In this case, usually the orders are processed successfully and the money is paid. You will see this error message in the order details, on the "My Sales" page in your Ecwid control panel. There are three possible reasons:

  1. The order total, formed in Ecwid, doesn't match the order total returned by PayPal. Probably, you are using PayPal's taxes or shipping rates (enabled in your PayPal merchant account). These rates are appended to the order total when customer is redirected to PayPal. You need to check your PayPal manager account for tax and shipping settings, and disable them if any.
  2. The currency in which Ecwid store sells differs from the one set in your PayPal account. You need to make sure you setup the same currency on both sides.
  3. The payments are transferred to the PayPal email that differs from that you specified in the Ecwid control panel > Settings > Payment > [Account details] of the PayPal Standard payment method.

As a security measure, to avoid any possible hack attempts, Ecwid requires that the payment is processed to the PayPal email that is recorded in the Ecwid control panel. If the transaction has a different email, Ecwid sets the order status to Awaiting Payment or PayPal will mark the order as pending.

Most likely you have two emails associated with your business PayPal account, both are valid therefore PayPal accepted the payment. Yet only one of the emails is supposed to receive the payments.

You need to make sure you submitted the right PayPal email in your Ecwid control panel, Settings>Payment> [Account details]. If you're not sure to what email you're receiving payments to, you can contact PayPal customer support or our support team . They will examine your orders records.

c. PayPal had some problems on their side

When a payment is made, PayPal sends an IPN (instant payment notification) message to Ecwid with the payment details. Ecwid verifies this IPN message and if everything is OK, it updates the order status. If for some reason (due to an error or a downtime) the PayPal server hasn't answered to Ecwid's request to verify the transaction (i.e. we don't know if the IPN message has been legit or not), the order status is set to "Awaiting Payment".

d. Order is "Awaiting Payment", error "The payment is pending because it was made to an email address that is not yet registered or confirmed"

You receive an email notification from Ecwid about a new order, check your PayPal account and don't find anything there. Then you go back to Ecwid, see the "My Sales" page, go to the order details and discover that the order has the "Awaiting Payment" status, and the "Additional Information" section shows this:

This order is in the "Awaiting Payment" status, because the money has not been transferred to your PayPal account yet

Pending reason returned by PayPal:
The payment is pending because it was made to an email address that is not yet registered or confirmed.

Ecwid "communicates" with online payment gateways via a merchant's payment account, using the account details recorded in the Ecwid control panel. If you submit PayPal account email as example@example.org, Ecwid will transmit this email to PayPal thus telling PayPal, "This payment must be transferred to this account registered in your system". PayPal checks whether this email exists, and if not (or there's a problem with the account) the payment isn't completed, the money hangs as "Pending" on the PayPal side, and the order gets the "Awaiting Payment" status in Ecwid.

 The first thing you need to do is to make sure you have the right email address in [Account details] of the PayPal Standard method in your Ecwid control panel > Settings > Payment page.

 If it's the right one, most likely your PayPal account wasn't yet confirmed/verified when this order was placed. As a result the money was taken from the payer account but hang in the pending status. A solution here is to wait while the account is verified — the money will be delivered there.

If the email is submitted with an error (typo) or you put a wrong email there, the possible steps to rectify the issue are as follows:

  1. If the order is test one, that's OK. Just update your PayPal settings in your Ecwid control panel, and make one more test order to ensure it's all working (orders should arrive as "Paid").
  2. If the order is real and you're going to ship the items, the money will remain pending on the PayPal side for the next ±45 days. If nobody claims for the funds, they will be returned to the payer. What you can do in this case:
  • Leave it as it is. Contact the buyer, explain the situation, and ask to place a new order. You could create an invoice in your PayPal account to the same amount and ask the customer to pay it. That may be easier for them. 
  • Register a PayPal account for the wrong email, and verify it.  After that PayPal will transfer the money  to this account, and you will be able to re-transfer the funds to your main business account.

When the money is transferred to you, you can change the orders statuses to "Paid" in your Ecwid control panel > My Sales page.

e. Ecwid internal anti-fraud mechanism has found something suspicious

Ecwid has an internal mechanism that checks PayPal orders for possible issues/scam. It means that for example if somebody tries to pay less than required (i.e. less than the actual order total) via PayPal, Ecwid will prevent this and set the order status to "Awaiting Payment" instead of "Paid".

Thus the main point is as follows: if a PayPal order gets the "Awaiting Payment" status instead of "Paid", you should carefully check this order in the PayPal backend for possible issues.

If you have an "Awaiting Payment" PayPal order, but still don't know why it has this status, please report to our support team and provide the following information: 1) your Store ID 2) the ID of the Awaiting Payment order.

What is the difference between PayPal Standard and PayPal Express Checkout?

The main difference between PayPal Standard and Express Checkout is that Standard is a payment method, whereas Express Checkout is an alternative checkout process. 

PayPal Express Checkout works as follows:

  • you add some products to the bag
  • click "Checkout with PayPal"
  • Ecwid redirects you to the PayPal site
  • you sign in with the PayPal account or create a new one
  • PayPal redirects you back to Ecwid
  • Ecwid creates a new profile based on the information from PayPal and shows the last checkout page
  • you review your order, change the shipping method if necessary and press the "Submit order" button
  • Ecwid sends the request to PayPal in background, PayPal charges your credit card.

 
PayPal Standard works as follows:

  • you add some products to the bag
  • click "Checkout"
  • you enter your shipping and billing address, select the "PayPal Standard" payment option.
  • Ecwid redirects you to PayPal, where you pay
  • PayPal redirects you back to Ecwid

Error: "Cannot proceed with checkout because of an internal error. Please contact the website administrator"

Usually, such a message appears when some PayPal Express Checkout credentials are missing or incorrect.

  1. Check if all PayPal Express Checkout fields are filled in.
  2. Check again if the credentials you use are valid and for the live account.

If after these steps you still get this error, let us know.

Error: "We cannot process this transaction because there is a problem with the PayPal email address supplied by the seller"

Your customers might see an error at the moment they proceed to PayPal when placing orders in your store:

"We cannot process this transaction because there is a problem with the PayPal email address supplied by the seller. Please contact the seller to resolve the problem. If this payment is for an eBay listing, you can contact the seller via the "Ask Seller a Question" link on the listing page. When you have the correct email address, payment can be made at www.paypal.com".

It means that most probably you have PayPal payment method misconfigured in your Ecwid control panel > Settings > Payment.

Please, check the settings of your PayPal payment method and make sure that the email address you use there is exactly the same you use to log in to your merchant account in PayPal. The best way to correctly set it up is to copy the email address from the PayPal page after logging in and paste it into the settings of your PayPal payment method in Ecwid control panel.

Error: "Unable to process payment"

If you're getting this error:

"Unable to process payment. Please contact the merchant as the shipping address provided by the merchant is invalid, and the merchant has requested that your order must be shipped to that address".

It means that your customer specifies an invalid or non-existing shipping address. In order to solve the problem, your customer should enter the correct shipping address during checkout. As a workaround you can enable "Allow customers to change their shipping address on PayPal site" option on the Payment > PayPal settings page. If you enable this option, customer will not see the error, but will be prompted to enter a new valid shipping address instead of the incorrect one. The drawback of this workaround is that customer can enter one shipping address in your Ecwid store and another one on PayPal side.

Error: "The seller accepts encrypted website payments only. You cannot pay the seller through un-encrypted buttons. Please contact your seller for more details"

In order to fix this problem you should disable the "Block Non-encrypted Website Payment" option in your PayPal backend.

Encrypted Website Payments option is used when you insert the HTML code of your PayPal button to your site page. Since anybody can modify this button code and change for example an item price, it is possible to encrypt the button code using a special certificate.

Since in Ecwid a visitor cannot modify the "button code", this option isn't necessary and should be disabled.

How can I use one Paypal account for multiple Ecwid stores?

It's possible to link multiple Ecwid stores to one Paypal account. Ecwid takes care about proper values of return URLs and IPN URLs for each storefront. All you need to do is to properly set up your merchant account in the PayPal backend as described above.

Particularly, pay attention to the "Auto return" option — it should be enabled. As for the "Return URL" field, Ecwid will pass the correct URL along with each payment request, so that each customer will return to the site where he started the checkout. If some Return URL is specified in Paypal account settings, the Return URL that is provided by Ecwid will override what was specified in the profile settings. Thus you can put any URL there, for example: http://app.ecwid.com/paypalstandard/STOREID where STOREID is your store ID

I get the "Merchant Design Identification Error" error when setting up PayFlow payment option

The error is caused by an invalid layout template parameter in your Paypal Manager account settings. By default, Ecwid passes the layout parameter among the other on your behalf to PayPal so it is not necessary to set it manually on PayPal side, our PayFlow payment setup instruction describes everything that needs to be configured in most cases. However, if a merchant changes something on the PayPal Manager Customize page, those changes overwrite the Ecwid ones (in particular, layout template) and need to be reset. In order to fix the 'Merchant Design Identification Error', a merchant should manually set the layout parameter to 'Layout C':

  • Log into your PayPal Manager account. 
  • Choose "Setup" and submit https://app.ecwid.com/paypalpayflow/STORE_ID (where replace STORE_ID with your store ID) in these fields:"Enter Cancel URL", "Enter Error URL", and "Enter Return URL". 
  • Choose the 'Service Settings' option from the main navigation. 
  • Choose "Customize" from the sub-navigation. 
  • Make sure "Layout C" is selected and click "Save and Publish".

I am not redirected to PayPal mobile payment form, when I checkout on mobile device. Why is that?

PayPal Mobile checkout doesn't support several parameters, passed from Ecwid to PayPal, like taxes and discounts. If your order in Ecwid included a tax or discount line on the invoice, PayPal won't open a mobile payment form for you, because PayPal Mobile Checkout doesn't support tax and discount parameters. You will see a regular PayPal payment form that regularly opens on desktops.

How to place a test order using PayPal?

Please note that you cannot test PayPal payment method using the same account as a seller’s and a buyer’s accounts simultaneously, because it’s the same as "buying from yourself". This is something that PayPal forbids you to do.

In case if you want to check your real PayPal account, you can do the following:

  • Create another real PayPal account for testing purposes for an email that is not connected to your seller's PayPal account.
  • Create a cheap test product ($1 or less) in your store.
  • Make a purchase in your store with the test account
  • If needed, make a chargeback when the payment is received.
Was this article helpful?
9 out of 12 found this helpful
Questions?
Get help
  • Forums

    Join the Ecwid community. Discuss support topics and store ideas with other Ecwid users.

  • Contact us

    Still have questions about Ecwid? Let us know! We will be glad to help you with your Ecwid store.

  • Status Monitor

    Get real time status updates on Ecwid services here, 24/7