{"id":78584,"date":"2017-12-18T14:19:16","date_gmt":"2017-12-18T14:19:16","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/citypay-payments\/"},"modified":"2026-02-23T09:10:18","modified_gmt":"2026-02-23T09:10:18","slug":"citypay-payments","status":"publish","type":"plugin","link":"https:\/\/es-gt.wordpress.org\/plugins\/citypay-payments\/","author":15821304,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.1.10","stable_tag":"2.1.10","tested":"6.9.4","requires":"4.0","requires_php":"","requires_plugins":null,"header_name":"CityPay WooCommerce Plugin","header_author":"CityPay Limited","header_description":"CityPay PayLink Payment Pages for WooCommerce","assets_banners_color":"","last_updated":"2026-02-23 09:10:18","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/citypay\/citypay-paylink-woo-commerce","header_author_uri":"https:\/\/citypay.com","rating":0,"author_block_rating":0,"active_installs":20,"downloads":3132,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":{"2.0.0":{"tag":"2.0.0","author":"citypay","date":"2017-12-18 15:07:24"},"2.0.1":{"tag":"2.0.1","author":"citypay","date":"2022-01-25 11:40:18"},"2.0.2":{"tag":"2.0.2","author":"citypay","date":"2022-08-03 14:53:42"},"2.0.3":{"tag":"2.0.3","author":"citypay","date":"2022-08-08 10:20:57"},"2.0.4":{"tag":"2.0.4","author":"citypay","date":"2022-08-15 08:59:46"},"2.0.5":{"tag":"2.0.5","author":"citypay","date":"2022-08-16 11:30:03"},"2.0.6":{"tag":"2.0.6","author":"citypay","date":"2022-10-31 09:19:23"},"2.0.7":{"tag":"2.0.7","author":"citypay","date":"2022-10-31 09:32:18"},"2.0.8":{"tag":"2.0.8","author":"citypay","date":"2023-01-11 09:12:55"},"2.0.9":{"tag":"2.0.9","author":"citypay","date":"2023-01-20 14:43:32"},"2.1.0":{"tag":"2.1.0","author":"citypay","date":"2023-03-27 15:08:13"},"2.1.1":{"tag":"2.1.1","author":"citypay","date":"2023-06-29 14:20:53"},"2.1.10":{"tag":"2.1.10","author":"citypay","date":"2026-02-23 09:10:18"},"2.1.2":{"tag":"2.1.2","author":"citypay","date":"2023-07-31 09:12:28"},"2.1.3":{"tag":"2.1.3","author":"citypay","date":"2023-12-18 13:08:27"},"2.1.4":{"tag":"2.1.4","author":"citypay","date":"2024-11-06 12:47:33"},"2.1.5":{"tag":"2.1.5","author":"citypay","date":"2025-07-16 12:33:08"},"2.1.6":{"tag":"2.1.6","author":"citypay","date":"2025-09-08 09:01:15"},"2.1.9":{"tag":"2.1.9","author":"citypay","date":"2026-02-16 13:43:29"}},"upgrade_notice":{"1.0.2":"<ul>\n<li>Update improves error reporting for SSL connectivity issues.<\/li>\n<\/ul>","1.0.1":"<ul>\n<li>Upgrade supports WooCommerce versions 2.3 and above.<\/li>\n<\/ul>","1.0.0":"<ul>\n<li>Initial version.<\/li>\n<\/ul>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":2258898,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":2258898,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["2.0.0","2.0.1","2.0.2","2.0.3","2.0.4","2.0.5","2.0.6","2.0.7","2.0.8","2.0.9","2.1.0","2.1.1","2.1.10","2.1.2","2.1.3","2.1.4","2.1.5","2.1.6","2.1.9"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[888,282,6593,286],"plugin_category":[45],"plugin_contributors":[150825],"plugin_business_model":[],"class_list":["post-78584","plugin","type-plugin","status-publish","hentry","plugin_tags-e-commerce","plugin_tags-ecommerce","plugin_tags-payment-gateway","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-citypay","plugin_committers-citypay"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/citypay-payments\/assets\/icon-128x128.png?rev=2258898","icon_2x":"https:\/\/ps.w.org\/citypay-payments\/assets\/icon-256x256.png?rev=2258898","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>The WooCommerce plugin works by creating a token and redirecting to the\nPaylink form for cardholders to enter their card details directly into\nthe CityPay secure web application. Once a payment has been completed it\nwill attempt to connect via a webhook or postback to your website.<\/p>\n\n<!--section=installation-->\n<h4>Minimum requirements<\/h4>\n\n<ul>\n<li>PHP version 5.2.4 or greater (Tested up to: 8.2.4)<\/li>\n<li>MySQL version 5.0 or greater<\/li>\n<li>WordPress 4.0 or greater (Tested up to: 6.9.1)<\/li>\n<li>WooCommerce 3 or greater (Tested up to: 10.0.2)<\/li>\n<\/ul>\n\n<h4>Automatic installation<\/h4>\n\n<p>To perform an automatic installation of the CityPay Paylink WooCommerce plugin,\nlogin to your WordPress dashboard, select the Plugins menu and click Add New.<\/p>\n\n<p>In the search field, type \"CityPay\" and click Search Plugins. Once you have\nfound our payment gateway plugin, it may be installed by clicking Install Now.<\/p>\n\n<h4>Manual installation<\/h4>\n\n<p>The perform a manual installation of the CityPay Paylink WooCommerce plugin,\nlogin to your WordPress dashboard, select the Plugins menu and click Add New.<\/p>\n\n<p>Then select Upload Plugin, browse to the location of the ZIP file containing\nthe plugin (typically named <em>citypay-paylink-woocommerce.zip<\/em>) and then click\nInstall Now.<\/p>\n\n<h4>Post installation: the plugin settings form<\/h4>\n\n<p>Once the plugin has been installed, you may need to activate it by selecting\nthe Plugins menu, clicking Installed Plugins and then activating the plugin\nwith the name \"CityPay WooCommerce Plugin\" by clicking on the link labeled\nActivate.<\/p>\n\n<p>You will need to edit WooCommerce checkout settings by navigating to the\nWooCommerce administration panel, selecting WooCommerce, Settings and then\nthe checkout tab. If installed correctly, you should see CityPay as a link\nunder the Checkout Options.<\/p>\n\n<p>The merchant account, the licence key, the transaction currency and other\ninformation relating to the processing of transactions through the CityPay\nPaylink hosted form payment gateway may be configured by selecting the\nplugin configuration form which is accessed indirectly through the\nWooCommerce settings page upon selecting the Checkout tab, and clicking on\nthe link labeled CityPay which appears in the list of available payment\nmethods.<\/p>\n\n<p>You can include the WooCommerce order identifier in the description sent\nto CityPay for the purpose of including a customer-friendly reference in\nthe email sent to the customer. This is\nachieved by specifying {order_id} as part of the descriptive text appearing\nin the text box labeled Transaction Description.<\/p>\n\n<p>After the settings for the plugin have been configured, they must be saved\nby clicking on the button labeled Save Changes before they take effect.<\/p>\n\n<h4>Developer Postback Testing<\/h4>\n\n<p>The Paylink service cannot send a postback\/webhook to your localhost test server\nto update the order status. Therefore token requests fail to be created when\na localhost or local network address is detected in the postback URL. To work\naround this, we recommend using <a href=\"https:\/\/ngrok.com\">https:\/\/ngrok.com<\/a> to create\na secure tunnel to your localhost server. As your WordPress installation may be\non localhost, the CityPay settings page allows the addition of a\n<strong>Postback Site Address (URL)<\/strong> which you can customise with your ngrok address i.e.\nhttps:\/\/12345678abc.ngrok.io. The value should be the host and protocol part of the\nURL.<\/p>\n\n<h4>Processing test transactions<\/h4>\n\n<p>To test the operation of an e-commerce solution based on WooCommerce in\ncombination with the CityPay Paylink WooCommerce plugin without processing\ntransactions that will be settled by the upstream acquirer, the check box\nlabeled Test Mode appearing on the plugin settings form should be ticked.<\/p>\n\n<h4>Processing live transactions<\/h4>\n\n<p>To process live transactions for settlement by the upstream acquirer, the\ncheckbox labeled Test Mode referenced in the paragraph above must be\nunticked.<\/p>\n\n<h4>Enabling logging<\/h4>\n\n<p>The interaction between WordPress, WooCommerce and the CityPay Paylink\nhosted payment form service may be monitored by ticking the check box labeled\nDebug Log appearing on the plugin settings form.<\/p>\n\n<p>Log payment events appearing in the resultant log file will help to trace\nany difficulties you may experience accepting payments using the CityPay\nPaylink service.<\/p>\n\n<p>The location of the log file is provided on the plugin settings form.<\/p>\n\n<!--section=changelog-->\n<h4>2.1.10<\/h4>\n\n<ul>\n<li>Fixed duplicate action being added for the postback handler.<\/li>\n<\/ul>\n\n<h4>2.1.9<\/h4>\n\n<ul>\n<li>Add payment functionality for CityPay to Block Editor. Add Test button to WooCommerce Payments CityPay tab to check all settings required for the plugin to connect and work with CityPay, it also checks that a valid connection can be made to the CityPay servers. Added metabox to the order screen providing details about the CityPay payment. Added extra columns to the Orders list page in relation to the payment.<\/li>\n<\/ul>\n\n<h4>2.1.6<\/h4>\n\n<ul>\n<li>Changed logo.<\/li>\n<\/ul>\n\n<h4>2.1.5<\/h4>\n\n<ul>\n<li>Updated \"tested up to\" for WordPress and WooCommerce.<\/li>\n<\/ul>\n\n<h4>2.1.4<\/h4>\n\n<ul>\n<li>Updated \"tested up to\" for WordPress and WooCommerce.<\/li>\n<\/ul>\n\n<h4>2.1.3<\/h4>\n\n<ul>\n<li>Removed lockParams cardholder.<\/li>\n<li>Fixed City not showing in Paylink form.<\/li>\n<\/ul>\n\n<h4>2.1.2<\/h4>\n\n<ul>\n<li>Updated \"tested up to\" for WordPress and WooCommerce.<\/li>\n<\/ul>\n\n<h4>2.1.1<\/h4>\n\n<ul>\n<li>Fixed alternatives payments being added when there is a subscription payment.<\/li>\n<\/ul>\n\n<h4>2.1.0<\/h4>\n\n<ul>\n<li>Updated tested up to for WordPress.<\/li>\n<\/ul>\n\n<h4>2.0.9<\/h4>\n\n<ul>\n<li>Fixed CityPay API URL when processing subscriptions.<\/li>\n<\/ul>\n\n<h4>2.0.8<\/h4>\n\n<ul>\n<li>Added Transaction Identifier Prefix.<\/li>\n<\/ul>\n\n<h4>2.0.7<\/h4>\n\n<ul>\n<li>Updated tested up to for WordPress.<\/li>\n<\/ul>\n\n<h4>2.0.6<\/h4>\n\n<ul>\n<li>Updated readme files.<\/li>\n<\/ul>\n\n<h4>2.0.5<\/h4>\n\n<ul>\n<li>Fixed decimal amount in renewals.<\/li>\n<\/ul>\n\n<h4>2.0.4<\/h4>\n\n<ul>\n<li>Fixed bug when doing an account retrieval to process renewals.<\/li>\n<\/ul>\n\n<h4>2.0.3<\/h4>\n\n<ul>\n<li>Fixed bug when plugin tries to embed wp-admin\/includes\/plugin.php file.<\/li>\n<\/ul>\n\n<h4>2.0.2<\/h4>\n\n<ul>\n<li>Integrated WooCommerce Subscriptions.<\/li>\n<\/ul>\n\n<h4>2.0.1<\/h4>\n\n<ul>\n<li>Fixed issue where cancelled transactions could result in marking an order as complete.<\/li>\n<li>Fixed issue where retrying cancelled transactions results in order notes being missed<\/li>\n<\/ul>\n\n<h4>2.0.0<\/h4>\n\n<ul>\n<li>Refactored library to be fully 3.0 compatible and remove support for 2.X of WooCommerce.<\/li>\n<li>Addition of postback URL testing for use with Ngrok or similar<\/li>\n<li>Refactoring of method of payment to ensure linkage to the Paylink form is seamless<\/li>\n<li>Prevented multiple postback calls from reverting the status of an approved authorisation<\/li>\n<li>addition of further notes to the order screen<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Refactored library to remove curl and redundant code<\/li>\n<\/ul>\n\n<h4>1.0.7<\/h4>\n\n<ul>\n<li>Refer postback messages to the http \/ https server used by Wordpress\npreventing problems testing.<\/li>\n<\/ul>\n\n<h4>1.0.6<\/h4>\n\n<h4>1.0.5<\/h4>\n\n<h4>1.0.4<\/h4>\n\n<h4>1.0.3<\/h4>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Introduces improved error reporting for SSL connectivity issues.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Support for WooCommerce versions 2.3 and above.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial version.<\/li>\n<\/ul>","raw_excerpt":"CityPay Paylink WooCommerce adds payment processing support to WooCommerce using CityPay hosted forms.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/es-gt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/78584","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/es-gt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/es-gt.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/es-gt.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=78584"}],"author":[{"embeddable":true,"href":"https:\/\/es-gt.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/citypay"}],"wp:attachment":[{"href":"https:\/\/es-gt.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=78584"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/es-gt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=78584"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/es-gt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=78584"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/es-gt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=78584"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/es-gt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=78584"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/es-gt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=78584"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}