UXi® Commerce supports PayPal StandardPayPal Express Checkout and PayPal Payflow Link 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.


PayPal Standard

It is the easiest in use and setup solution from PayPal. In addition to regular payments within PayPal accounts, this methods also allows users to pay by credit card without having them to create a PayPal account.


How to set it up


UXi® Commerce Control Panel

  • Go to System settings → Payment page.
  • Find PayPal payment method.
  • Click "Account details" link in the Payment Processor column. A popup window will appear.
  • Insert your PayPal account's email address(e.g. paypal@example.com) Save the changes.
  • Enable this payment method and save the changes once again.


PayPal backend

  • Log in to your PayPal account.
  • Proceed to "My account → Profile → My selling tools 
  • Find "Instant Payment Notifications" in the settings link and click "Update". Click "Choose IPN Settings" button and select " Receive IPN messages (Enabled)" option. Use 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/1003Save changes.

  • Also we highly recommend to enable the "Auto Return" option*. You can find it on "Profile  My selling tools → Website Payment Preferences" page. UXi® Commerce sends the necessary value of the "Return URL" in each request to PayPal, so you can put any URL there, for example: http://app.ecwid.com/paypalstandard/STOREID 
  • 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 Premier or Business PayPal account, go to "Profile → My selling tools → Shipping Calculations"  and click "update". If you don't have any shipping methods on this page, just skip this step.**
    • Then select the checkbox next to the shipping method for a specific currency. Click "Edit" button.
    • Set "Use the shipping fee in the transaction instead of my calculator's settings" to "Yes". Click "Save Changes" button.
    • Perform these steps for each shipping method set in your PayPal account.


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 ask questions on our forum.


Help tips


The auto-return will force your customers to return to your store (and to which URL they will be returned) 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 in UXi® Commerce control panel, System Settings -> General -> Cart. In this case, the code is triggered when customer's get to 'Thank you for your order' page therefore you need to force the auto return.


b) If you're going to use one PayPal account in several separate Ecwid stores. And 'Return URL' field can be left empty - UXi® Commerce 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 UXi® Commerce shop). 


The main thing is to enable IPN (Instant Order Notifications) setting. IPN is a message transmitted from PayPal to UXi® Commerce via a special secure channel and indicating the status of the payment. So this setting will ensure that your UXi® Commerce store will be notified about whether the customer did complete the payment or the transaction has been failed. Upon receiving such a notification, UXi® Commerce is able to update the order status accordingly. Thus having IPN properly setup in your PayPal account is crucial for the automatic accepting of orders in UXi® Commerce.


** This step is necessary to avoid issues with shipping calculation in UXi® Commerce store: If you have any shipping rates configured in the PayPal account, they may override the rates from your UXi® Commerce store. As a result the order may arrive at status Awaiting Payment (check here for more tips on this issue). 



PayPal Express Checkout

It's more advanced solution by PayPal. It provides an alternative checkout process for your UXi® Commerce store.


How to setup PayPal Express Checkout in UXi® Commerce

  • Log in to your UXi® Commerce control panel.
  • Go to System Settings → Payment → PayPal Express Checkout page.
  • Fill in all the necessary fields: API UsernameAPI 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?

- If no, you need to generate a signature. Use this instruction: cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_api_ECAPICredentials or this one: www.x.com/developers/community/blogs/ppmacole/retrieving-your-api-credentials 

- 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 UXi® Commerce 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 (PayPal recommends using a signature).


How PayPal Express Checkout works

  • you add products to the bag
  • click "Checkout with PayPal"
  • UXi® Commerce redirects you to the PayPal site
  • you sign in with the PayPal account or create a new one
  • PayPal redirects you back to UXi® Commerce
  • UXi® Commerce 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" button
  • UXi® Commerce sends the request to PayPal in background, PayPal charges your credit card.


PayPal Payflow Link and PayPal Payments Advanced


PayPal Payflow Link is available to merchants from Canada, Australia, New Zealand, and UK

PayPal Advanced method is for 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 the 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, to sum it up: 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


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

*NOTE: mouse over the small "?" icons to open hints and tips.

PayPal allows creating additional User profiles, with a username and a password, right within your account. You may want to create one and in this case enter these username and password in the fields above: "User" and "Password". If you don't have any, you should submit your merchant login into "User" field and the password you use to sign in at https://manager.paypal.com 


PayPal Payments Pro Hosted (UK)


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


PayPal Payments Pro Hosted works for UK and France only.


How to set up:


  1. Sign up for a PayPal Payments Pro account.  
  2. In UXi® Commerce Control Panel, Go to the "System Settings → Payment" page. In PayPal payment method section, choose PayPal Payments Pro Hosted, click Apply.
  3. 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"
  4. 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 ?

PayPal Standard  and PayPal Express Checkout options allow paying by credit card without a PayPal account. If you use PayPal, but it still asks your customers to log in, you should check the settings of your PayPal account. Please refer to this post for the detailed instructions:



Can I use UXi® Commerce with PayPal if I have a Personal account?

 Yes, if you have a Personal account, it will work with UXi® Commerce just well. Use the "PayPal Standard" payment option.



I see a sale in the Paypal backend, but it isn't showing in UXi® Commerce

If you see any order in PayPal and don't see it in UXi® Commerce, first of all make sure that your PayPal module is set up properly and all the steps from this instruction have been carried out: PayPal - How to set it up. Please pay particular attention to IPN messages - they must be enabled.


If all PayPal settings are correct, open "IPN History" page in your PayPal backend and check it for 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 UXi® Commerce control panel. 

If an order is successfully placed and you have fully charged the customer for it, it should get  "Paid" status. Status "Awaiting Payment" 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 UXi® Commerce control panel, section 'Additional information'.

 There are 3 main reasons why some PayPal order gets Awaiting Payment status instead of Paid.


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.
  • authorization: You set the payment action to Authorization and have not captured funds yet. The Payment Action parameter is set in UXi® Commerce control panel, System Settings -> Payment -> PayPal Express Checkout tab. For 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 processed 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 fromn 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.


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." 


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 'Sales' page at UXi® Commerce control panel.  There are three possible causes:


1) The order total, formed in UXi® Commerce, 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 UXi® Commerce 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 UXi® Commerce control panel, System Settings>Payment> 'Account details' of the PayPal Standard payment method.

As a security measure, to avoid any possible hack attempts, UXi® Commerce requires that the payment is processed to the PayPal email that is recorded in the UXi® Commerce control panel. If the transaction has a different email, UXi® Commerce 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 UXi® Commerce control panel, System Settings>Payment> 'Account details'. If you're not sure to what email you're receiving payments, you can contact PayPal customer support or our support team on the forums - they will examine your orders records. 


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 received an email notification from UXi® Commerce about a new order, check your PayPal account and don't find anything there. Then you go back to UXi® Commerce, see "Sales" page, go to the order details and discover that the order is in status Awaiting Payment, and "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.


UXi® Commerce "communicates" with online payment gateways via merchants's payment account, using the account details recorded in the UXi® Commerce control panel. If you submit PayPal account email as example@example.org, UXi® Commerce 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 in Pending status on PayPal side, and the order gets Awaiting Payment status in UXi® Commerce


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 UXi® Commerce control panel, System Settings -> Payment page. 


If it's the right one, most likely when this order was placed, your PayPal account wasn't yet confirmed/verified. As a result the money was taken from the payer account but hang in 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 (mistype) or you put a wrong email there, 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 UXi® Commerce control panel, and make one more test order to ensure it's all working (orders should arrive at Paid status)


2) If the order is real and you're going to ship the items, the money will remain pending at PayPal side for the next ±45 days. If you nobody claim 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 UXi® Commerce control panel, Sales page.


PayPal had some problems on their side

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


UXi® Commerce's internal anti-fraud mechanism has found something suspicious

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


So, the main rule is as follows: if your 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 a "Awaiting Payment" PayPal order, but still don't know why it has got this status, please report to our support team on the forums 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"
  • UXi® Commerce redirects you to the PayPal site
  • you sign in with the PayPal account or create a new one
  • PayPal redirects you back to UXi® Commerce
  • UXi® Commerce 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" button
  • UXi® Commerce 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.
  • UXi® Commerce redirects you to PayPal, where you pay
  • PayPal redirects you back to UXi® Commerce



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

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

  1. Check if all PayPal 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.


I get "We cannot process this transaction because there is a problem with the PayPal email address supplied by the seller." error

If your customers see the error saying:

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.

the moment they proceed to PayPal when placing orders in your store, most probably you have PayPal payment method misconfigured in your UXi® Commerce control panel → System 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 UXi® Commerce control panel.


I get the "Unable to process payment" error

 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, 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 UXi® Commerce store and another one on PayPal side.



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

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


  • Log in to your PayPal account.
  • Click the Profile subtab.
  • In the Selling Preferences column, click the Website Payment Preferences link.
  • Scroll down to the Encrypted Website Payments section.
  • Next to the "Block Non-encrypted Website Payment label", select the "Off" radio button.
  • Scroll down to the bottom of the page, and click Save


'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 UXi® Commerce a visitor cannot modify the "button code", this option isn't necessary and should be disabled.



How can I use single Paypal account for multiple UXi® Commerce stores?

It's possible to link multiple UXi® Commerce stores to one Paypal account. UXi® Commerce 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, UXi® Commerce will pass the correct URL along with each payment request, so that each customer will be eventually returned 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 the store will override what was specified in the profile settings. Thus you can put any URL there, for example: http://app.ecwid.com/paypalstandard/STOREID



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

The error is caused by invalid layout template parameter in Paypal Manager account settings. By default, UXi® Commerce 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 merchant changes something on the PayPal Manager Customize page then those changes overwrite the UXi® Commerce ones (in particular, layout template) and needs to be reset. In order to fix the 'Merchant Design Identification Error', a merchant should manually set the layout parameter to 'Layout C': 

Enter Cancel URL, Enter Error URL, and Enter Return URL. 

  • Next 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 received this message from PayPal " Action Required before February 1, 2013 Merchants need to update their IPN and/or PDT scripts to use HTTP 1.1, and include the “Host” header in the IPN postback script. " Do I have to do anything on my part?


We are aware of this upcoming PayPal update and are already considering whether any changes will be needed in UXi® Commerce with this regard.


If you use UXi® Commerce IPN scripts no actions will be required from you.  UXi® Commerce is a SaaS solution which means all updates, upgrades, patches, and new features are implemented by our team, and UXi® Commerce users don't have to bother about such changes. 


NOTE: UXi® Commerce users who are using custom IPN scripts will have to contact the developers of the scripts for an update.