Using plug-in for WordPress CMS

Testing the Flashpay Payments plug-in operation and various payment scenarios without actual debiting of funds is possible via the test environment of the Flashpay payment platform. You can connect to the platform by using the corresponding form on the company's main site and the identifier and key of the test project received from Flashpay. Along with that, it is necessary to provide the Flashpay technical support specialists with the name of the web service, for which the plug-in from Flashpay should be used, the web service URL, and the payment currency.

Keep in mind that, when using the test environment of the Flashpay payment platform, the plug-in is connected to the web service and becomes available to customers as the payment option. Thus, in cases when the plug-in is connected to a web service that operates in live mode, it is recommended to ensure that testing takes place during a low-load period and notify the customers about the ongoing testing activities.

To prepare the plug-in for testing, proceed as follows:

1. Open the plug-in tab in the WordPress interface.

   For this, proceed as follows:

   1. Go to the Payments tab in the Settings subsection of the WooCommerce section.
   2. Find one of the payment methods set up for working with Flashpay in the Method column and click the General settings button in the corresponding line.
2. Set up the basic parameters of the plug-in operation on the General tab:
   • Project ID—the test project identifier.
   • Secret Key—the test project key for interacting with the platform.
   • Language—the language in which the payment form is displayed.

   

3. If necessary, specify additional plug-in parameters.:

   For this, click the Advanced settings link on the General tab and set up the parameters in the sections Transaction Cache and Shop Admin Setup:

   • Enable Caching—the feature for caching payment data to optimise the plug-in operation in the web service.
   • Cache Expiration—the duration of cached data storage in seconds.
   • Log Level—the level of logging the plug-in operation.

     The information about created logs is provided on the Logs tab in the Status subsection of the WooCommerce section.

   • Fetch Payment Info—the feature for displaying payment statuses in the Orders section.

     For the payment statuses to be displayed in the Orders section, select the Enable checkbox, otherwise, clear the checkbox. By default, the checkbox is selected.

   • Complete order automatically—the feature for completing orders automatically when payments are processed.

     For orders to be completed automatically when payments get the Success status, select the Enable checkbox, otherwise, clear the checkbox. By default, the checkbox is not selected.

   

4. Save the basic plug-in parameters.

   For this, click the Save changes button.

When testing the plug-in operation, you can process test purchases in the web service and obtain information about them via the WordPress interface. in the Orders section. Along with that, you can use special payment credentials that allow testing particular payment scenarios.

To test card payments, you can use the numbers of test cards. For testing according to the shortest scenarios (without the emulation of the 3‑D Secure authentication), the following numbers of cards can be used:

• 4000 0000 0000 0077—for a purchase to be processed
• 4111 1111 1111 1111—for a purchase to be declined

For more comprehensive testing, it is possible to use extended test data for card payments (details). (including scenarios with the 3‑D Secure authentication) provided in the Test cards article.

In order to process payments with actual debiting of funds, you should initially solve all organisational issues related to the interaction with Flashpay (submit the application for connecting to the payment platform, provide all necessary information, and receive a notification from Flashpay about the possibility to process payments, as well as the identifier and secret key of the production project). Along with that, it is necessary to provide the Flashpay technical support specialists with the name and URL of the web service for which the Flashpay Payments plug-in is set up and the currency in which payments are to be processed.

After that, you specify the identifier and secret key of the production project received from Flashpay in the parameters of the plug-in operation and set up other necessary parameters. (or check whether the current setup is relevant for working in real-life conditions). If later you need to suspend the plug-in operation, the plug-in methods can be disabled. Besides, if additional testing is needed, for example when setting up new features, the plug-in can be switched to using the test environment.

To set up the plug-in for processing one-time purchases, proceed as follows:

1. Open the plug-in tab in the WordPress interface.

   For this, proceed as follows:

   1. Go to the Payments tab in the Settings subsection of the WooCommerce section.
   2. Find one of the payment methods set up for working with Flashpay in the Method column and click the General settings button in the corresponding line.
2. Set up the basic parameters of the plug-in operation on the General tab:
   • Demo mode—the feature for switching the plug-in operation mode.

     For using the production environment of the platform, clear the Enable Demo mode checkbox and specify the parameters for connecting to the platform received from Flashpay in the fields Project ID and Secret Key.

   • Project ID—the production project identifier.
   • Secret Key—the production project key for interacting with the platform.
   • Language—the language in which the payment form is displayed.

   

3. If necessary, specify additional plug-in parameters.:

   For this, click the Advanced settings link on the General tab and set up the parameters in the sections Transaction Cache and Shop Admin Setup:

   • Enable Caching—the feature for caching payment data to optimise the plug-in operation in the web service.
   • Cache Expiration—the duration of cached data storage in seconds.
   • Log Level—the level of logging the plug-in operation.

     The information about created logs is provided on the Logs tab in the Status subsection of the WooCommerce section.

   • Fetch Payment Info—the feature for displaying payment statuses in the Orders section.

     For the payment statuses to be displayed in the Orders section, select the Enable checkbox, otherwise, clear the checkbox. By default, the checkbox is selected.

   • Complete order automatically—the feature for completing orders automatically when payments are processed.

     For orders to be completed automatically when payments get the Success status, select the Enable checkbox, otherwise, clear the checkbox. By default, the checkbox is not selected.

   

4. Save the basic plug-in parameters.

   For this, click the Save changes button.

In order to set up registering and processing of COF purchases (subscriptions) with the use of the Flashpay Payments plug-in and the WooCommerce Subscriptions extension, you should set up the parameters of the Flashpay Payments plug-in (according to the setup instructions for one-time purchases) and use the tools available in the WooCommerce plug-in tab of the Subscriptions tab. On the Subscriptions tab, it is possible to set up different parameters, including the following ones: the names of the buttons, which are used for adding the products to the cart and paying for them, options of COF purchases renewal after their suspension, and other parameters. Information about working with COF purchases via the WooCommerce Subscriptions extension is provided in the WooCommerce documentation.

If the web service and the plug-in have been set up correctly, purchases are processed automatically. Along with that, it is important to ensure that all necessary data is collected on the web service side.

In case of questions or issues related to purchase processing, contact the Flashpay technical support specialists.

The information about payments (including series of debits as part of COF purchases) processed with the use of the Flashpay Payments plug-in and about the corresponding orders can be monitored via the WordPress interface via the tools of the Orders subsection in the WooCommerce section.

Additionally, the payment information can be obtained via the Dashboard interface from Flashpay (details). This interface provides the information about payments and refunds processed via the Flashpay payment platform, but it does not display information about orders.

The Orders subsection contains an orders register with main details about every order and with the capabilities of searching and filtering data, as well as opening the tabs of separate orders and performing various actions related to the orders. (Alongside order statuses, the register can also contain payment statuses—if the Fetch Payment Info checkbox in the plug-in parameters is selected.)

Clicking on an order's entry leads you to the order's tab containing the details about the order andTo open a tab of a particular order, click on the order's entry in the register. The tabs contain the details about orders and payments, such as the order creation date, the purchase amount, the payment option and status, delivery address, and other data. The tabs also contain the specialised panels:

• Flashpay Payment—with the payment information and the capability to update this information manually using the Refresh button.
• Order actions—with tools for performing various actions on the order.
• Order notes—with notifications about various events related to the order and the payment.

More detailed information about working with orders in the WordPress interface is provided in the WooCommerce documentation.

With the WooCommerce Subscriptions extension, you have the access to the Subscriptions subsection in the WooCommerce section. This subsection contains the information about COF purchases (in addition to the information displayed in the Orders subsection). Similarly to the Orders subsection, the Subscriptions subsection displays the subscriptions register with main details about every subscription and provides the capabilities of searching and filtering data as well as opening the tabs of separate subscriptions and performing various actions related to the subscriptions.

More detailed information about working with COF purchases in the WordPress interface is provided in the WooCommerce documentation.