Payments system

This option becomes available only when Payments addon was enabled. Instead of plugin's payments addon you may use WooCommerce payments system with all its advantages.

When listing requires payment - after submission it redirects to invoice page at the Frontend dashboard page. This requires Frontend submission & dashboard addon to be enabled and a page with [webdirectory-dashboard] shortcode must be created.

Only registered and logged in users can pay invoice.

After activation of Payments addon - on directory settings page Payments settings tab will appear with payments settings.

Invoices management page appears at the backend. Through the frontend dashboard page authors have access only to their own invoices, administrators have permissions to manage any invoices at the backend.

Invoice log box contains information about payment transactions including failed transactions. Look at invoice log to get more information when payment on PayPal/Stripe side completed, but invoice still has "unpaid" status.
Each invoice has one of following statuses: "unpaid", "pending" or "paid". Invoice item - is an object to which this invoice belongs to.

There are 5 types of payment services:

  • listings activation - this type of service available for subscription and one time payment. After successful payment the listing status becomes "active" and displays at the frontend.
  • listings renewal - this type of service available for subscription and one time payment. This feature processes directory listing renewal. After renew process was completed successfully the listing status becomes "active" and the system sets new expiration date.
  • listings raise up - this is the service for one time payment. This feature will raise up the listing to the top of all lists, those ordered by date. For more information look at the sorting section.
  • listings upgrade - this is one time payment service. Charge users if they wish to upgrade their simple listings to featured or sticky.
  • listings claim - after successful approval of claim new owner need to pay to renew the listing.

Users are allowed to process some actions with invoices, such as print invoice with all assigned information or reset selected gateway. Also there is special action button "Set as paid" only for administrators. This allows to set up invoice status as paid manually and processes further actions. Usually this needed to complete invoices with chosen "Bank transfer" payment gateway.

Available payment gateways:

  • PayPal - this method for one time payment.
  • PayPal subscription - users may use this method to process automatic recurring payments. Look at additional information below.
  • Stripe - a beautiful, optimized, cross-device, payment form. Stripe subscriptions option is not available.
  • Bank transfer - this is semi-automatic method of payment. User selects this method, prints invoice, transfers the payment to vendor, then when site administrator will receive payment - he will manually set invoice as paid by special action button "Set as paid".

PayPal Subscriptions

Using this payment gateway directory listings owners do not need to prolong their ads each time they have been expired. They may choose to create subscription and pay automatically by recurring cycle. PayPal subscriptions available only for listings, those do not have eternal (unlimited) active period. Subscription period becomes equal to active period of the listing.

PayPal single payment and PayPal subscriptions require enabled permalinks on WordPress "Settings -> Permalinks" page.


Payments settings

This settings tab places on "Directory Admin -> Directory settings" page on the "Payments settings" tab.

This tab appears after activation of payments addon.

There is alternative payments system. You can use WooCommerce payments. It has lots of advantages and features based on WooCommerce plugin power.

General payments setting

Currency - the list of possible currencies used for payments.

Following settings are not related to price content fields. To see content fields settings - click on "Configure" link near price content field.

Currency symbol or code - this symbol or code will appear on frontend/backend pages.

Currency symbol or code position - choose preferred position of currency symbol/code.

Decimal separator - decimal separator of price value, possible values: dot or comma.

Hide decimals in levels price table - show/hide decimals (cents) on levels price table at the frontend.

Thousands separator - the separator for thousands, millions, billions, ... Possible values: no separator, dot, comma or space.

Sales tax

Enable taxes - enable/disable taxes functionality.

Selling company information - this information will appear on invoice page.

Tax name - abbreviation, e.g. "VAT".

Tax rate - insert tax rate in percents.

Include or exclude value added taxes - do you want prices on the website to be quoted including or excluding value added taxes?

Bank transfer settings

Allow bank transfer - allow users to select "Bank transfer" payment method.

Bank transfer information - this information appear on print invoice page. Provide whole instructions and payment requisite.

PayPal settings

Business email - PayPal merchant email.

Allow single payment - when this option is checked - "PayPal" payment gateway available.

Allow subscriptions - when this option is checked - "PayPal subscription" payment gateway available. Only for listings with limited active period.

Test Sandbox mode - allows to test the process of payment using PayPal sandbox credentials. You must have a PayPal Sandbox account setup before using this feature.

Stripe settings

Test secret key

Test publishable key

Live secret key

Live publishable key

The publishable key is used to generate credit card tokens and should be included with the HTML form. The secret key is used for all other API calls on the server-side.

Test Sandbox mode - Before activating your account, you can only interact with Stripe in test mode. With the exception of the ability to make a real charge to a credit card, all of Stripe's features are available in test mode.