[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"doc-seo-307308-105":3,"detail-sidebar-cat-1-en-105":80,"doc-detail-307308-en":126},{"code":4,"msg":5,"data":6},0,"ok",{"site_id":7,"language":8,"slug":9,"title":10,"keywords":11,"description":12,"schema_data":13,"social_meta":73,"head_meta":75,"extra_data":77,"updated_unix":79},105,"en","troubleshooting-x-payments-user-manual","Troubleshooting - X-Payments user manual","","Troubleshooting guidance for X-Payments covers general operation and new releases, then focuses on installation, system requirements, authentication, and configuration essentials. It explains how to manage users, customize the interface, administer payments, view logs, upgrade, and move the platform between hosts. The troubleshooting section details common failure scenarios across Windows servers, PHP configuration errors (PDO require_once issues), duplicate charges, missing payment methods, and HTTP/SSL-related failures, plus numerous connector and integration errors by environment.",{"@graph":14,"@context":72},[15,34,55],{"@type":16,"itemListElement":17},"BreadcrumbList",[18,23,27,31],{"item":19,"name":20,"@type":21,"position":22},"https://docshare.wps.com","Home","ListItem",1,{"item":24,"name":25,"@type":21,"position":26},"https://docshare.wps.com/template/","Template",2,{"item":28,"name":29,"@type":21,"position":30},"https://docshare.wps.com/template/general/","General",3,{"item":32,"name":10,"@type":21,"position":33},"https://docshare.wps.com/template/troubleshooting-x-payments-user-manual/307308/",4,{"url":32,"name":10,"@type":35,"image":36,"author":41,"headline":10,"publisher":44,"fileFormat":47,"inLanguage":8,"description":12,"dateModified":48,"datePublished":49,"encodingFormat":47,"isAccessibleForFree":50,"interactionStatistic":51},"DigitalDocument",{"url":37,"@type":38,"width":39,"height":40},"https://docshare.wps.com/thumbnails/troubleshooting-x-payments-user-manual/307308.png","ImageObject",442,249,{"name":42,"@type":43},"Valentina","Person",{"url":19,"name":45,"@type":46},"DocShare","Organization","application/pdf","2026-09-20","2026-09-19",true,{"@type":52,"interactionType":53,"userInteractionCount":30},"InteractionCounter",{"@type":54},"ViewAction",{"@type":56,"mainEntity":57},"FAQPage",[58,64,68],{"name":59,"@type":60,"acceptedAnswer":61},"What should be done if the X-Payments 1.x installation fails on a Windows server?","Question",{"text":62,"@type":63},"Replace the XP_DIR line in install.php as described in the troubleshooting section, adjusting the rtrim/dirname expression.","Answer",{"name":65,"@type":60,"acceptedAnswer":66},"Why does the module show a require_once warning for /lib/PDO.php and how is it resolved?",{"text":67,"@type":63},"The error indicates the PHP PDO dependencies are not available at runtime. Update php.ini so PDO and the MySQL PDO driver are loaded as shared modules (e.g., install and enable the required PDO extensions).",{"name":69,"@type":60,"acceptedAnswer":70},"What are common checkout and integration symptoms addressed in this troubleshooting guide?",{"text":71,"@type":63},"The guide covers missing credit card forms or payment methods, empty/404 admin pages, HTTP 500 or white screen errors, and various connector/integration problems across Magento, X-Cart, and hosted plans.","https://schema.org",{"og:url":32,"og:type":74,"og:title":10,"og:site_name":45,"og:description":12},"article",{"robots":76,"canonical":32},"index,follow",{"doc_id":78,"site_id":7},307308,1789847622,{"code":4,"msg":81,"data":82},"success",[83,88,93,98,103,108,113,118,123],{"id":84,"doc_module":22,"doc_module_name":25,"category_name":85,"show_sort_weight":86,"slug":87},11,"Presentations",90,"presentations",{"id":89,"doc_module":22,"doc_module_name":25,"category_name":90,"show_sort_weight":91,"slug":92},12,"Resumes",80,"resumes",{"id":94,"doc_module":22,"doc_module_name":25,"category_name":95,"show_sort_weight":96,"slug":97},14,"Invoices",70,"invoices",{"id":99,"doc_module":22,"doc_module_name":25,"category_name":100,"show_sort_weight":101,"slug":102},15,"Posters",60,"posters",{"id":104,"doc_module":22,"doc_module_name":25,"category_name":105,"show_sort_weight":106,"slug":107},16,"Social Media",50,"social-media",{"id":109,"doc_module":22,"doc_module_name":25,"category_name":110,"show_sort_weight":111,"slug":112},17,"Forms",40,"forms",{"id":114,"doc_module":22,"doc_module_name":25,"category_name":115,"show_sort_weight":116,"slug":117},18,"Letters",30,"letters",{"id":119,"doc_module":22,"doc_module_name":25,"category_name":120,"show_sort_weight":121,"slug":122},21,"Paper Templates",5,"papers-templates",{"id":124,"doc_module":22,"doc_module_name":25,"category_name":29,"show_sort_weight":4,"slug":125},158,"general-158",{"code":4,"msg":81,"data":127},{"doc_id":78,"user_id":128,"nickname":42,"user_avatar":129,"doc_module":22,"category_id":124,"category_name":29,"doc_title":10,"doc_description":12,"doc_content":130,"file_id":131,"file_url":132,"file_type":133,"file_size":134,"view_count":30,"is_deleted":4,"is_public":22,"is_downloadable":22,"audit_status":22,"page_count":135,"language":136,"language_code":8,"site_id":7,"html_lang":8,"table_of_contents":137,"faqs":138,"seo_title":139,"seo_description":12,"update_tm":79,"read_time":30},13056703020460,"https://ap-avatar.wpscdn.com/avatar/be000253dac470eee5d?_k=1778207105932848923","X-Payments:Troubleshooting  \nX-Payments user manual  \n1. X-Payments:General information  \n♦ How It Works  \n♦ Key features  \n2. What's New  \n♦ What's New in X-Payments 3.1  \n♦ What's New in X-Payments 3.0  \n3. System requirements  \n♦ System requirements for X-Payments 3  \n♦ System requirements for X-Payments 2.2  \n4. Installation  \n♦ Installing X-Payments  \n♦ Setting up file permissions for X-Payments  \n♦ Getting started with X-Payments  \n5. Two-factor user authentication  \n♦ Two-factor authentication (X-Payments 3)  \n♦ Managing PIN codes (X-Payments 2.2 and earlier)  \n6. Configuring X-Payments  \n♦ General settings  \n♦ Online stores  \n♦ Payment configurations  \n♦ Encryption keys  \n♦ 3D-Secure settings  \n♦ KOUNT Antifraud screening  \n♦ NoFraud fraud prevention  \n♦ Signifyd fraud protection and chargeback prevention  \n♦ Developer mode  \n7. Managing users  \n8. Customizing the interface  \n♦ Customizing the interface (X-Payments 3)  \n♦ Customizing the interface (X-Payments 2.2 and earlier)  \n9. Managing payments  \n10. Unistalling X-Payments  \n11. Upgrading  \n12. Moving X-Payments from one host to another  \n13. Viewing X-Payments logs  \n14. FAQ  \n15. Troubleshooting  \n16. Glossary  \n17. Supported payment gateways  \n♦ Payment gateways supported by X-Payments 3.1  \n♦ Payment gateways supported by X-Payments 3.0  \n♦ Payment gateways supported by X-Payments 2.2  \nContents  \n• 1 Troubleshooting  \n♦ 1.1 X-Payments 1.x installation process fails on a Windows server  \n♦ 1.2 Warning: require_once(/home/user/public_html/xpayments/lib/PDO.php)  \n♦ 1.3 cron.php: X-Payments is using a non-secure protocol error  \n♦ 1.4 Duplicate charges  \n♦ 1.5 Empty or 404 page at Magento admin back-end  \n♦ 1.6 My store background image does not carry over to X-Payments checkout area template  \n♦ 1.7 X-Payments error (code: 843): Unallowed target  \n♦ 1.8 Sage Pay-Reason: 4020 : Information received from an Invalid IP address  \n♦ 1.9 No credit card form displayed when a customer pays  \n◊ 1.9.1 Error message at checkout instead of credit card form  \n◊ 1.9.2 No payment methods are displayed in the X-Payments connector settings  \n◊ 1.9.3 CyberSource Internal Error  \n◊ 1.9.4 You use Hosted X-Payments plans and run out of bandwidth  \n◊ 1.9.5 You use Hosted X-Payments plans and run out of disk space  \n◊ 1.9.6 Your integrated shopping cart does not pass all customer profile fields to X-Payments correctly  \n◊ 1.9.7 PayPal PRO integration does not work in X-Cart 4.x  \n◊ 1.9.8 X-Cart isn't Synchronizing PayPal Payments PRO payment methods from X-Payments  \n◊ 1.9.9 There are connection problems between your shopping cart and X-Payments at the time when a customer pays  \n♦ 1.10 \"Callback to online store is failed\" notification and now all credit card transactions are failing  \n♦ 1.11 Fatal error: Access to undeclared static property: XPay_Model_Base_Module::$this  \n♦ 1.12 My X-Payments doesn't store customers credit cards/X-Payments subscriptions module doesn't work  \n♦ 1.13 Customer CC expires in 2022-X-Payments stops at 2020  \n♦ 1.14 White screen or [HTTP 500](HTTP 500) Internal server error instead of admin dashboard  \n♦ 1.15 Magento: cannot test module connection or payment methods cannot be imported  \n♦ 1.16 Google Chrome v41.0.2272.76 detects X-Payments v2.1 credit card form as a mobile site on desktops  \n♦ 1.17 Trouble with credit card logos in iFrame template for X-Cart 5  \n♦ 1.18 My entire shop is run in an iFrame and X-Payments does not display \"Pay\" button  \n♦ 1.19 X-Payments credit card form does not fit properly on Android tablet screen when used in iFrame in X-Cart 4 OPC  \n♦ 1.20 How to test payments via PayPal in X-Payments  \n♦ 1.21 \"The TxnID field is missing or incorrect\" message after upgrading to a new connector version in Magento  \n♦ 1.22 Browser warning about wrong SSL certificate pops up  \n♦ 1.23 \"X-Payments tried to notify the store about updates in payment but failed\" notification  \n♦ 1.24 \"No Payment Methods Available\" message shown to a customer  \n♦ ","cbCaijfAODRBzrhc","https://ap.wps.com/l/cbCaijfAODRBzrhc","pdf",306595,9,"English","# Troubleshooting\n## X-Payments 1.x installation process fails on a Windows server\n## Warning: require_once(/home/user/public_html/xpayments/lib/PDO.php)\n## cron.php: X-Payments is using a non-secure protocol error\n## Duplicate charges\n## Empty or 404 page at Magento admin back-end\n## My store background image does not carry over to X-Payments checkout area template\n## X-Payments error (code: 843): Unallowed target\n## Sage Pay-Reason: 4020 : Information received from an Invalid IP address\n## No credit card form displayed when a customer pays\n## Troubleshooting (full list)","[{\"question\":\"What should be done if the X-Payments 1.x installation fails on a Windows server?\",\"answer\":\"Replace the XP_DIR line in install.php as described in the troubleshooting section, adjusting the rtrim/dirname expression.\"},{\"question\":\"Why does the module show a require_once warning for /lib/PDO.php and how is it resolved?\",\"answer\":\"The error indicates the PHP PDO dependencies are not available at runtime. Update php.ini so PDO and the MySQL PDO driver are loaded as shared modules (e.g., install and enable the required PDO extensions).\"},{\"question\":\"What are common checkout and integration symptoms addressed in this troubleshooting guide?\",\"answer\":\"The guide covers missing credit card forms or payment methods, empty/404 admin pages, HTTP 500 or white screen errors, and various connector/integration problems across Magento, X-Cart, and hosted plans.\"}]","Troubleshooting - X-Payments user manual | PDF"]