You can add a new currency via code changes.

To add a new currency in wprentals admin you need to edit:

1. the wprentals-core plugin . wprentals-core\redux-framework\sample\options-init.php and add the new currency.
2. the wprentals-core\redux-framework\theme-admin-sections\add-listing-page-payment-settings.php file

The post How to add a new currency in Theme Options for payments. appeared first on WP Rentals Help.

Read more about all supported payment methods here: Supported Payment Platforms in WpRentals

For WpRentals Included merchants, you can control whether to enable Sandbox or LIVE mode for payments:

• Sandbox – Used for testing the API.

• Live – Used for the LIVE API.

For WpRentals Included merchants, select the Payment Currency:

You can also set the Payment Currency for WpRentals included merchants:

Note: PayPal and Stripe support a limited number of countries and currencies.

• Check PayPal supported currencies:
  https://developer.paypal.com/docs/classic/api/currency_codes/

• Check Stripe supported currencies:
  https://support.stripe.com/questions/which-currencies-does-stripe-support

• See Stripe supported countries:
  https://stripe.com/global

If your country currency is not on the list “Currency for Paid Submission”, please open a ticket in our support system and ask for your currency to be added.

The post Theme Options -> Payment Currency Settings appeared first on WP Rentals Help.

1. Security Deposit Fee (Add Listing):

• Where it’s set:
  In the property owner’s account, under My Properties > Edit or Add Property > Price > Security Deposit.
• What it is:
  This is the amount the property owner sets as the security deposit for a specific listing.
• When it applies:
  The security deposit fee is added to the total booking amount when a booking request is made. This amount goes to the Admin Account as part of the booking deposit.
• Refund Process:
  The refund of the security deposit is manual. After the booking is completed, the admin must manually transfer the refund to the renter’s account outside the theme.

2. Deposit Fee (Theme Options):

• Where it’s set:
  Globally for all listings, under WPRentals Options > Booking Payment Options.
• What it is:
  This is the amount the renter must pay to confirm the booking, and it can be a percentage or a fixed amount. It applies to all listings. It is independent from Security Deposit Fee.
• How it works:
  • If set to 100%, the renter pays the full amount upfront, including any security deposit.
  • If set to less than 100%, the renter pays a portion of the booking fee, which may include part of the security deposit fee.

Key Differences:

• Security Deposit (Add Listing) is fee / price cost specific to each listing and is set by the property owner for that listing alone.
• Deposit Fee (Theme Options) is set globally for all listings and applies to the amount Site Admin wishes to receive in order for bookings to be confirmed

Security Deposit Fee (Add Listing):

The Security Deposit Fee is set by the property owner in the My Properties section: My Properties -> Edit or Add Property -> Price -> Security Deposit.

When a booking request is made, the Security Deposit Fee is added to the booking total.

How to return the Security Deposit Fee to the renter.

The Security Deposit Fee is part of the booking deposit and is transferred to the Admin Account. The refund must be processed manually from the Admin Account to the renter’s account (outside the theme).

Scenarios for Security Deposit Fee Handling:

Scenario 1: Deposit is 100%

• Set Deposit Fee to 100% in Theme Options > Add Listing Page & Payment Settings > Booking Payment Settings
• In this case, the full payment (including the security deposit) is collected when the booking request is confirmed, and all funds go to the Admin Account.

Scenario 2: Deposit is less than 100%

• Set Deposit Fee to less than 100% in Theme Options.
• The renter will pay a portion of the deposit to confirm the booking, which will include part of the security fee (depending on how the deposit is configured by the Admin). The deposit is calculated based on the total booking fee.
• To collect the full security fee from the renter, they will need to pay the remaining balance. A reminder is sent to the renter, and the owner can send up to three manual reminders. However, the booking will proceed unless the owner cancels it manually.

Remove Security Deposit Fee From Submit Listing Form

• Remove from Theme Options:
  For details on managing submit form fields, refer to the Help Article.

Remove with Custom CSS:

To hide the security deposit field, you can use the following custom CSS:

[for="security_deposit"] {
display: none;
}
[id="security_deposit"] {
display: none;
}

The post Booking Price – Understand Security Deposit Fee appeared first on WP Rentals Help.

Overview: In the WPRentals platform, admin can control how payments are handled for bookings. When setting up deposits and service fees, all payments are routed through the admin account, whether through PayPal, Stripe, or other WooCommerce-supported merchants.

Key Payment Settings:

Deposit Fee:

• Admin can set a global deposit value to confirm bookings.
• The deposit can be a fixed amount or a percentage of the booking total.
• If a deposit is set, the user must pay it before the booking is confirmed.
• If the deposit is non-zero, it must cover any service and administrative fees.

Admin Service Fee:

• Admin can set a service fee that is paid by the guest.
• The service fee is deducted from the owner’s earnings, but paid by the guest as part of the deposit.
• The service fee can also be set as a fixed amount or percentage.

Expenses:

• Admin can decide whether to include city and cleaning fees in the deposit calculation.
• If the deposit is set to 100%, including the city and cleaning fees is mandatory.

Possible Booking scenarios:

Instant Booking: No owner approval is required. How to set up Instant Booking

• Guest sends a booking request.
• The renter must pay the deposit (if set by admin) to confirm the booking.
• Payment goes to the admin account.

Manual Booking Approval: The owner must approve the booking request. More on the booking process

• Guest sends a booking request.
• The owner approves or rejects the request.
• If the owner approves, they issue an invoice.
• The renter must pay the deposit (if set by admin) to confirm the booking. The payment goes to the admin account.

Deposit Fee Required (different setup variations)

Important note for Deposit: Choose either percentage or fixed value for the deposit (not both).

Deposit asked is different than 0

• If the Deposit is set to a value greater than 0, the guest must pay that deposit before the booking can be confirmed.
• Deposit required value is set in Add Listing Page & Payment Settings -> Booking Payment Settings

Admin wishes to collect only his Service Fee with Deposit

• If the admin wishes to only collect a percentage deposit as the service fee and leave the remaining payment between the guest and owner outside of the theme, this is possible.
• He needs to set Deposit Fee and Admin Service Fee as equal values:

• In the User Dashboard, the confirmed booking will show the deposit paid and the remaining balance.
• Paying the remaining balance through the theme to the admin account is optional and can be removed with CSS if desired.

Deposit is 100% – full payment required 

• You can choose to include additional expenses (e.g., city fee and cleaning fee) when calculating the deposit.
• However, if 100% deposit is required, these fees must be included.

Admin Service fee

The Service Fee:

• Is paid by the guest and is deducted from the owner’s earnings.
• It is part of the deposit, so the deposit must be greater than or equal to the service fee.

For Service Fee Calculation:

• You can set the service fee as a fixed amount or a percentage (not both).
• The service fee is deducted from the owner’s earnings, but it’s included in the deposit paid by the guest.
• If you use 0 for Deposit, use 0 for the Service fee

Service Fee Visibility:

• The service fee is visible in the Owner Dashboard under View Invoice Details.
• The fee is deducted from the owner’s earnings.

Payment Methods

WP Rentals supports several payment options for collecting funds:

a. Theme-Integrated Payment Methods:

• PayPal: Help to set up PayPal
• Stripe: Help to set up Stripe
• Wire Transfer: Help to set up Wire Transfer

b. WooCommerce Payment Options:

• You can also use WooCommerce-supported merchants to process payments.
• To enable WooCommerce payments: Help to install WooCommerce
• WooCommerce supports hundreds of merchants. Each merchant has its own documentation for setup.

Note: Payments are processed through WooCommerce merchants, but the money always goes to the admin account.

Important Considerations

• If you set the Deposit to 0, set the Service Fee to 0 as well.
• The service fee is deducted from the deposit, and the deposit must always be greater than or equal to the service fee (including city and cleaning fees if applicable).

The post Booking: How to work with Deposit Fee and Service Fee appeared first on WP Rentals Help.

WpRentals allows you to use supported merchants for the following three purposes:

Submit Listings via Membership

Help – Membership Submission

Submit Listings via Paid Membership (One-Time Fee)

Help – Paid Submission

Pay Admin Deposit/Service Fee for Each Booking

Help – How to Work with Deposit and Service Fees

You can combine Option 1 with Option 3, or Option 2 with Option 3.

Supported Merchants in WpRentals

WpRentals supports several payment merchants, and payments always go to the admin’s account.

1. Theme-Included Merchants

These merchants are included by default and can be used for Membership-based submission, Paid Submission, and Booking Deposit payments:

• PayPal
  Help – Set up PayPal

• Stripe
  Help – Set up Stripe

• Wire Transfer
  Help – Set up Wire Transfer

2. WooCommerce-Supported Merchants

You can disable the default theme merchants and use any WooCommerce-supported merchants to process payments directly to the admin. This option works for Paid Submission or Membership Submission (but NOT for recurring payments), and for Booking Deposit Payment.

• Help – Enable WooCommerce Option

WooCommerce supports hundreds of merchants, each with their own documentation available on the WooCommerce website. Please note, while the theme’s booking system operates independently from WooCommerce, payments are processed through Woo merchants, but the funds always go to the site admin.

The post What payment platforms are supported in WpRentals? appeared first on WP Rentals Help.

WooCommerce is supported for the following options:

• Paid Submission (pay for a listing to be published and separately for a listing to be marked as featured)
• Pay for bookings (deposit and the remaining balance can be paid through WooCommerce payment methods)
• Pay for bookings with Instant Booking checked WITHOUT HAVING TO LOGIN first
• Pay for membership based subscription (does not apply to recurring payments) starting theme version Version 3.9.0

How to install WooCommerce

Install the Plugin:

• Go to Plugins > Add New.
• Search for WooCommerce and click Install Now.
• After installation, click Activate.

Set-up WooCommerce payments:

• WooCommerce will prompt you to go through a quick setup. Complete the setup as instructed.
• You do not need additional plugins for basic WooCommerce functionality.
• Disable shipping if you are only using digital products.

When WooCommerce is activated, it automatically creates essential pages under Admin > Pages:

• Cart Page
• Checkout Page
• My Account Page

You can edit these pages and customize their headers. If you don’t see the WooCommerce shortcodes on these pages, you can regenerate them from WooCommerce settings:

1. Go to WooCommerce > Status > Tools.
2. Scroll to Create Default WooCommerce Pages and click Create Pages.

Checkout page

My account page

You can edit these pages and set custom header

Re-generate WooCommerce Pages:

If the pages do not have the shortcode you can regenerate the pages from Woo Commerce settings:

Step 1 Go to Woo Commerce – Status – Tools

Step 2  Scroll down to Create default WooCommerce pages and press Create pages

Set the merchants in WooCommerce

WooCommerce supports over 100 payment gateways. You can explore the list of supported gateways here:
WooCommerce Payment Gateways.

Some gateways are free, while others require a paid extension. After selecting a gateway, ensure it is configured according to WooCommerce’s instructions.

Direct Bank Transfer (BACS) Specifics:

• Instant Booking Compatibility: Direct Bank Transfer does not work with Instant Booking.
• Payment Confirmation: After a payment is made via Direct Bank Transfer, admins need to manually confirm it by changing the order status from On Hold to Processing in the admin dashboard.

New orders will have the ON HOLD status and to confirm payments the order status will need to be changed to Processing

Refer to WooCommerce’s documentation for further details on setting up Direct Bank Transfer: Direct Bank Transfer (BACS) WOO commerece documentation.

Currency & Timezone Settings:e

• Set the Currency in WooCommerce by navigating to WooCommerce > Settings > General.
• Ensure you set the Timezone to Universal Timezone in WooCommerce settings for consistent processing.

Set WooCommerce Timezone to Universal Timezone for bookings to match correctly the availability calendar

Enable the option to use WooCommerce Payments 

Go to Theme Options -> Add Listing Page & Payment Settings ->WooCommerce Settings

How it works

The “Pay Now” button will appear when paying for:

• Instant booking deposit (deposit must be greater than 0)
• Regular booking deposit
• Remaining balance payment
• Paid submission fee for listing creation (including fees for marking listings as featured)

Example with Instant Booking enabled

Clicking on “Pay Now” will redirect user to WooCommerce Check-out Page.

The payment will be processed through WooCommerce merchants and those you set from WooCommerce settings.

The check-out page can show “Terms and Conditions” check as well as other profile information which you will save in WooCommerce plugin reports.

Enable “terms and conditions” on checkout page

Go to Settings -> Account & Privacy and select the page you wish to show for “Privacy page”

How to use Booking without login

Live demo – https://demo1.wprentals.org/properties/condo-in-liberty-state-park/

The user login can be bypassed when a booking is placed by using Instant Booking and WooCommerce,

Settings to make in WooCommerce

• Account account creation
• Enable Send Password setup link (for users to receive the account details by email

How to manage checkout fields

WP Rentals hides some default fields during checkout that aren’t required to process payments. If you encounter duplicate checkout pages when purchasing WooCommerce products, you may need to adjust the fields:

• Remove unnecessary fields using the file located at:
  plugins/wprentals-core/classes/wpestate_global_payments.php

Note: You might have duplicate checkout pages if you try to buy WooCommerce products as the checkout process can’t be completed because of missing fields.

You can delete all the lines for the fields you wish to show (and not use any plugin) – file path plugins/wprentals-core/classes/wpestate_global_payments.php

For additional customization of checkout fields, you can use WooCommerce-compatible plugins like Flexible Checkout Fields.

Handling Shipping in WooCommerce:

For products marked as non-virtual, you can enable shipping details by following this guide:
Enable Shipping for Non-Virtual Products.

How to use WooCommerce to collect extra taxes on Check-Out

To set up taxes at checkout in WooCommerce, you need to configure the tax settings within the WooCommerce plugin.

Follow this guide from WooCommerce for detailed instructions on setting up taxes: Setting up Taxes in WooCommerce.

WooCommerce also offers additional tax-related add-ons, which may be useful if you need special tax collection or invoice generation for country-specific regulations. You can explore all available tax extensions here: WooCommerce Tax Extensions.

In the WooCommerce Tax section, you can define multiple tax rates, and these can be applied based on the customer’s billing address. Be sure to set the tax calculation to use the customer’s billing address for accurate tax application.

You can add customer billing fields for addresses in the Checkout page using the Flexible Checkout Fields

In checkout, the taxes will be displayed only when the user fills in all address details set for tax settings

The post Install WooCommerce and use WooCommerce Payments appeared first on WP Rentals Help.

Submitted Listings should be approved by admin?

From this section, you can choose whether property submissions should be approved automatically (after payment is received, if payment is required) or manually (admin always reviews submissions).

• NO – Submissions are approved automatically.
• YES – Submissions are approved manually.

Help: https://help.wprentals.org/article/how-to-approve-properties-manually-how-to-approve-properties-automatically/

Note: Only the initial submission requires admin approval. Any subsequent edits to the listing will be saved automatically and do not require re-approval.
If you wish to change this behavior and require admin approval after each edit, follow the instructions here:
How to make admin approve listings after each edit

Enable Paid Submission – NO

This option means users can add listings for free. You can set properties to be submitted without any payment.

More on this option here – https://help.wprentals.org/article/free-submission/

Enable Paid Submission – PER LISTING

This option requires users to pay a fee for each listing they submit.

Help:  https://help.wprentals.org/article/paid-submission/

Enable Paid Submission – MEMBERSHIP

With this option, listing submission is based on the user’s membership package.

Help: https://help.wprentals.org/article/membership-submission/

Read more about all supported payment methods here: Supported Payment Platforms in WpRentals

The post Theme options – Listings Submission Settings appeared first on WP Rentals Help.

How to enable Wire Transfer as payment method

To enable Wire Transfer, go to Theme Options -> Add Listing Page & Payment Settings ->Wire Transfer Setting and fill in the details where users should send their payments.

If you want to use only Wire Transfer and your currency is not listed, you can add your currency in Theme Options > Add Listing Page & Payment Settings > Payment Currency Settings.

How does Wire Transfer button display in Front-End

On the front end, users will see a “WIRE TRANSFER” button next to PayPal or Stripe.

A. For Paid Submission

B. For Membership Packages

C. For Booking Payments

How does Wire Transfer work

When the user clicks the Wire Transfer button, a modal info box with Wire Instructions will appear.

The modal box will display the details you’ve set in Theme Options.

The user then clicks the “Send me the invoice” button to receive the same information via email.

After clicking on the button, the user will receive an email with a unique Invoice ID (payment reference number).

The email will include the INVOICE NUMBER generated by the system. The user should reference this ID in their payment information. After the payment is received, the admin can search for the invoice using the ID.

• The email’s default text (like the subject) can be updated from Email Management in Theme Options: Help: Email Management.

What to do as Admin to activate purchases

Once you receive the payment via bank transfer, go to Admin > Invoices and search for the invoice using the ID.

In the Admin Invoices section, you’ll see the invoice status:

• Issued – The invoice is not paid.

• Confirmed/Paid – The invoice has been paid.

To activate the purchase, the admin will click the EDIT INVOICE button.

Notes about Wire Transfer and Membership:

• In Users > Edit Users, you can confirm the user has received the correct package ID, listings included, and featured listings automatically.
• The package will expire based on the Membership Package expiration settings, counting days, weeks, months, or years starting from the package activation date.

• Wire Transfer does not work with the recurring option.

Notes about Wire Transfer and Paid Listing:

• Once the admin marks the invoice as paid, the property is published, and the owner will be notified that their property has been published on the website.

• When enabling Paid Listings, the PAID status will also appear in the Properties List.

The post Wire Transfer payment method appeared first on WP Rentals Help.

Only the admin or registered users, depending on the submission settings, can make a property featured. The method depends on the Paid Submission Type configured in the theme.

Ways to Make a Property Featured (Based on Submission Type)

Membership Submission

If the Membership System is enabled:

• The admin creates membership packages that include a set number of regular and featured listings.

• A user purchases a package and can then list properties and mark a limited number as featured—based on their package.

• Membership packages have an expiration date.

Help article – Membership Submission

Paid Listing (Pay Per Listing)

If Paid Submission is enabled:

• Users pay a one-time fee to publish a listing.

• They can optionally pay an additional fee to make the listing featured.

• These listings do not expire unless manually removed.

Help article – Paid Submission

Free Submission

If Paid Submission is set to NO (i.e., property submission is free):

• Users cannot mark properties as featured from the front-end dashboard.

• Only the admin can make a property featured from the WordPress admin panel by editing the property and selecting “Make it Featured”

Where Featured Properties Appear

Featured properties are shown first in:

• Recent Items Shortcode
• Recent Items Slider Shortcode
• Properties List Standard
• Properties List Half Map
• Advanced Search Results
• Property Taxonomies (city, category, area, state, type)

How to Identify Featured Properties

Featured listings are marked with a special icon or label on the top-left corner of the property image. The design depends on the card unit type selected in Theme Options.

The post Featured Properties: How they work appeared first on WP Rentals Help.

PayPal and Stripe merchants require that the processor payment page is unique. This cannot be translated to other pages.

For payments to work in other languages you must exclude these 2 pages from translation.

How:

Use the Exclude URL feature (WordPress Dashboard > Weglot)

Add http://yourdomain.coml/stripe-processor/ in the list. Check that this url is exact permalink name of the page url created with the Page Template “Stripe Charge Page”

Repeat the same for PayPal processor page.

Add http://yourdomain.coml/paypal-processor/ in the list. Check that this url is exact permalink name of the page url created with the Page Template “PayPal Processor”

The post 3rd Party: Weglot Multi Language Plugin and Stripe and Paypal payments appeared first on WP Rentals Help.

Choose a Submission Model

Pick one submission model to use on your site:

• Paid Submissions (users pay per listing, no expiration)
• Membership Packages (users pay for a package with multiple listings)

Free Membership & Listings

• Each new account gets free membership at registration.
• Free membership includes a set number of free and featured listings, defined by the admin.
• Changes to these limits apply only to new accounts.

Important: If you modify membership settings after users have registered, old accounts will not update automatically. You will need to manually adjust existing accounts.
How to add a membership package manually

Membership Package Rules

• Users cannot have two active packages at the same time.
• Buying a new membership package replaces the previous one (listings do not add up).
• If a user downgrades to a package with fewer listings, all their listings will be set to EXPIRED. They must resubmit listings within their new limit.
• Deleting a listing does not restore it—it still counts as a used listing

How to Enable Membership Submission

Go to Theme Options -> Add Listing Page & Payment Settings -> Submission Settings -> Enable Paid Submission -> Select “Membership”

Setting Up Membership Features

Create a “My Subscription” Page

If you did not import demo content, you must create this page manually.
How to import demo content

Set Free Membership Options

From Theme Options, you can:

• Define the number of free and featured listings included.
• Set how long each free listing stays published.
• Free listing expiration is calculated as:
  Publish date + Number of days set in admin.
• Users receive email notifications when free listings expire.

Expired listings appear in My Listings under “Expired.”

Set Paid Membership Packages

A paid membership package includes:

• Package Name
• Payment cycle (daily, weekly, monthly, yearly)
• Listings included (regular & featured)
• Price
• Option to show/hide package in the user dashboard

Currency for Payments Admin Receives

For WpRentals Included merchants, you can control whether to enable Sandbox or LIVE mode for payments:

• Sandbox – Used for testing the API.

• Live – Used for the LIVE API.

For WpRentals Included merchants, select the Payment Currency:

You can also set the Payment Currency for WpRentals included merchants:

Note: PayPal and Stripe support a limited number of countries and currencies.

• Check PayPal supported currencies:
  https://developer.paypal.com/docs/classic/api/currency_codes/

• Check Stripe supported currencies:
  https://support.stripe.com/questions/which-currencies-does-stripe-support

• See Stripe supported countries:
  https://stripe.com/global

WpRentals supports multiple payment methods for processing property submissions:

1. Direct Theme Payment Methods

These methods are built into the theme and allow users to pay for memberships or individual property submissions.

PayPal (Supports Recurring Payments)

• Users can pay via PayPal for one-time or recurring payments.
• Supports automatic subscription renewals.
• Users must cancel subscriptions from their PayPal account if they enable recurring but do not want automatic renewals anymore.
  PayPal Setup Guide

Stripe (Supports Recurring Payments)

• Allows users to pay using credit or debit cards.
• Supports automatic subscription renewals.
• Users can cancel Stripe subscriptions directly from their WpRentals user dashboard.
  Stripe Setup Guide

Wire Transfer (Manual Payment Processing)

• Users receive payment instructions and must manually send a bank transfer.
• The admin must manually approve the payment before activating the package.
  Wire Transfer Setup Guide

2. WooCommerce Payment Integration (Optional)

• Enable WooCommerce to use any WooCommerce-supported payment method (e.g., Stripe, PayPal, Authorize.net, local bank payments, etc.).
• WooCommerce does NOT support recurring payments for membership packages.
• Payments processed via WooCommerce are handled entirely through the WooCommerce system.

How to Install WooCommerce & Use WooCommerce Payments

How Users Buy or Manage Memberships

Users manage their membership packages from the User Dashboard -> My Subscription page. 

Buying a Package

• Users can purchase a membership package that includes a set number of listings and featured listings.
• A recurring payment checkbox is available for PayPal and Stripe payments. If enabled, the package will renew automatically upon expiration.

What Happens If Payment Fails?

• If a first-time payment fails (PayPal/Stripe), the user will have a Free Membership by default.
• If a recurring payment fails, the user is downgraded to Free Membership automatically.

Upgrading to a New Package

• When upgrading, the new package limits apply immediately, even if time remains on the previous package.
• Users receive the number of listings included in the new package.
• Listings do NOT accumulate across packages.

Listings and Package Upgrades

• If users already have published properties, those properties will be automatically deducted from the new package’s available listings.
• Deleted properties still count as used listings. Deleting a property does not restore an extra listing slot.

Downgrading to a Lower Package

If a user downgrades to a package with fewer listings than they currently have published:

• ALL listings are set to “EXPIRED.”
• The user must manually resubmit listings for approval, but cannot exceed the new package’s limit.

Published & Expired Listings After an Upgrade/Downgrade

• If the number of published listings is within the new package limit, they stay published.
• Expired listings remain expired and do not reactivate automatically.

Package Restrictions

Users CANNOT have multiple packages at the same time.
A new package replaces the existing package immediately.

Managing Featured Listings

• Users can mark a property as featured from My Properties.
• Featured listings are deducted from the package limit.
• Only the admin can unmark a featured property and grant a new featured slot.

Cancelling a Membership Package

One-time Payment Packages

• These automatically expire at the end of the billing period.

Recurring Subscriptions

• Stripe subscriptions can be canceled from the User Dashboard.
• PayPal subscriptions must be canceled from the user’s PayPal account.

What Happens if a Payment Fails?

• If a user does not renew their package, their account reverts to free membership.
• All listings will be marked as EXPIRED.
• The user must purchase a new package to reactivate listings.

Expired Listings

A listing will expire if:

1. The user’s membership package expires and is not renewed.
2. A recurring payment fails (e.g., insufficient funds).
3. The user downgrades to a package with fewer listings.

Users can resubmit only the number of listings allowed by their current package.

The post Adding Listings with Membership Submission appeared first on WP Rentals Help.

Paid Submission Rules:

• Decide from the beginning if you want to use Paid Submission or Membership Packages — switching later is not recommended.

• Changing the submission model after users have already registered and submitted listings can cause listing count or payment inconsistencies. The new settings only apply to new users and future submissions.

• Each listing must be paid for individually.

• Paid listings do not expire — they remain active unless manually removed by the user or the admin.

• Users can see submission pricing and payment options in their User Dashboard > My Properties.

• Paid listings will show the status “PAID” in the admin area under Properties > All Properties and on the Edit Property screen.

How to Enable Paid Submissions

• Go to Theme Options -> Add Listing Page & Payment Settings -> Submission Settings -> Enable Paid Submission -> Select “per listing”
• Add the Price Per Submission (for “per listing” mode) Use .00 format for decimals (ex: 5.50). Do not set price as 0! and use only numbers 
• Price to make the listing featured (for “per listing” mode)Use .00 format for decimals (ex: 1.50). Do not set price as 0! and use only numbers 

Currency for Payments Admin Receives

For WpRentals Included merchants, you can control whether to enable Sandbox or LIVE mode for payments:

• Sandbox – Used for testing the API.

• Live – Used for the LIVE API.

For WpRentals Included merchants, select the Payment Currency:

You can also set the Payment Currency for WpRentals included merchants:

Note: PayPal and Stripe support a limited number of countries and currencies.

• Check PayPal supported currencies:
  https://developer.paypal.com/docs/classic/api/currency_codes/

• Check Stripe supported currencies:
  https://support.stripe.com/questions/which-currencies-does-stripe-support

• See Stripe supported countries:
  https://stripe.com/global

Set Payment Options

WpRentals supports multiple payment methods for processing property submissions:

1. Direct Theme Payment Methods

These methods are built into the theme and allow users to pay for memberships or individual property submissions.

PayPal (Supports Recurring Payments)

• Users can pay via PayPal for one-time or recurring payments.
• Supports automatic subscription renewals.
• Users must cancel subscriptions from their PayPal account if they enable recurring but do not want automatic renewals anymore.
  PayPal Setup Guide

Stripe (Supports Recurring Payments)

• Allows users to pay using credit or debit cards.
• Supports automatic subscription renewals.
• Users can cancel Stripe subscriptions directly from their WpRentals user dashboard.
  Stripe Setup Guide

Wire Transfer (Manual Payment Processing)

• Users receive payment instructions and must manually send a bank transfer.
• The admin must manually approve the payment before activating the package.
  Wire Transfer Setup Guide

2. WooCommerce Payment Integration (Optional)

• Enable WooCommerce to use any WooCommerce-supported payment method (e.g., Stripe, PayPal, Authorize.net, local bank payments, etc.).
• WooCommerce does NOT support recurring payments for membership packages.
• Payments processed via WooCommerce are handled entirely through the WooCommerce system.

How to Install WooCommerce & Use WooCommerce Payments

How Users Buy with Paid Submission

Users manage properties with Paid Submission from the User Dashboard -> My Properties List. 

They will pay the property only once.

They will pay for featured property only once.

For site Administrator, paid submissions will have status PAID in admin – Properties and in Edit Property view.

How Submission & Approval Works with Paid Submission

1. User Submits a Property

• The user fills out the property form and clicks “Submit Property”.

• The property is saved as a pending

2. User Pays for the Listing

• After submission, the user is taken to the payment step (PayPal, Stripe, Wire Transfer, or WooCommerce).

• Once payment is completed:

  • The property gets the “PAID” status in admin.

  • If automatic publishing is enabled in Theme Options, the listing is published right away.

  • If manual approval is required, the listing will stay in “pending” status until an admin approves it.

3. Admin Approval (if required)

• If manual approval is active:

  • Go to Admin > Properties > All Properties.

  • Find the listing with status Pending.

  • Click Edit, review it, and click Publish.

4. Listing Goes Live

• After approval (or automatically, if set), the listing appears on the website.

• It will never expire unless the admin or user removes it.

The post Adding Listings with Paid Submission appeared first on WP Rentals Help.

Can You Use Stripe?

• Supported Currencies: Check here

• Available Countries: Check here

Step 1: Set Up the Stripe Processor Page

• Go to Pages > Add New
• Use the Stripe Merchant Processor template (this is already added if you imported demo content)
• Only one page should use this template. Delete duplicates, even from the Trash.
• Copy the URL of this page — you’ll need it for the next steps.

Step 2: Choose Your Stripe Environment

• Use SANDBOX for testing or LIVE for real payments.
• API keys will be different depending on the mode.

Steps to Create Stripe Keys:

Step 1: Create and Activate Your Stripe Account

1. Go to Stripe to create and activate your account.
2. For LIVE API, complete the onboarding process as described here:
   Activate Stripe Account.
3. The SANDBOX API Key is automatically provided.

Step 2: Define Webhook

1. Go to Developers > Webhooks.
2. Click + Add endpoint.
3. Add the Stripe URL page URL (with the stripe processor template) from your site to track all transactions.
4. Select Receive all events to get notifications for all events.
5. Click Add endpoint.
6. Copy the Signing Secret Key and paste it into your website.

• Click receive all events to get all events selected

• Click the Add endpoint button

• Copy Signing secret key in your site to Theme Options -> Add Listing Page & payment Settings -> Stripe Settings -> Stripe Webhook Secret Key

Step 3: Copy API Credentials

1. Go to Developers > API keys in your Stripe dashboard.
2. Copy both the Publishable Key and Secret Key.

Step 4: Enter API Credentials in WP Rentals

1. Go to Theme Options -> Add Listing Page & payment Settings -> Stripe Settings
2. Paste the copied keys into the respective fields (Stripe Publishable Key and Stripe Secret Key)

STRIPE and Membership-based submission enabled.

Create Your Product (Membership Package) in Stripe:

• Go to Stripe > Product Catalog

• Click + Add Product

• Match the WP Rentals package:

  • Product name = Membership name
  • Price
  • Billing interval (monthly, yearly, etc.)
  • Currency

Add price information. Set the Currency, Price per package and billing interval to match the package settings from theme.

After creating the Stripe product, the Stripe Product ID will be generated automatically. Copy the Stripe Product ID

In WP Rentals > Edit Membership, paste the Stripe Product ID for that package.

How to Cancel a Subscription

• A “Cancel Stripe Subscription” button automatically appears for users who paid via Stripe.

Stripe Fatal error

Error Message:

Fatal error: Uncaught exception ‘Exception’ with message ‘Stripe needs the Multibyte String PHP extension.’ in ...

Cause:

The error occurs because Stripe requires the Multibyte String PHP extension to function properly.

Solution:

1. Contact your hosting provider and request that they enable the Multibyte String PHP extension on your server.
   PHP Manual – Multibyte String
2. Without this PHP module, Stripe will not work correctly.

The post Stripe Merchant Set-Up Tutorial appeared first on WP Rentals Help.