Setting Up PayPal API with Houzez WordPress Theme

This guide provides step-by-step instructions to integrate the PayPal API with the Houzez WordPress theme to enable payment processing for real estate listings, memberships, or other monetization features. PayPal is a service that enables you to accept payments. The PayPal API setup makes it possible to link your website or mobile app to your PayPal account. You can then process transactions sent from customers directly with your chosen payment processor. This article will explain how to set up your PayPal so that you can accept payments through your website.

PayPal API Setup Video:

PayPal IPN Setup Video

Prerequisites

WordPress Site: A WordPress site with the Houzez theme installed and activated.
PayPal Account: A PayPal Business account.
Admin Access: Access to the WordPress admin dashboard and PayPal Developer account.
Houzez Theme: Ensure the latest version of Houzez is installed (check for updates in ThemeForest).
SSL Certificate: Your site must have HTTPS enabled for secure transactions

Obtain PayPal API Credentials

1. Log in to PayPal Developer Dashboard

Navigate to PayPal Developer. https://developer.paypal.com/home/
Sign in with your PayPal Business account credentials.

2. Access My Apps & Credentials

In the PayPal Developer Dashboard, go to My Apps & Credentials under the Dashboard menu.
Select Live (for production) or Sandbox (for testing) at the top of the page.

3. Create a New App

Click Create App under the REST API apps section.
Enter an App Name (e.g., "Houzez Payment Integration").
Select Merchant as the account type and click Create App.

4. Retrieve API Credentials

Once the app is created, you’ll see:
- Client ID: A unique identifier for your app.
- Secret: A secure key for API authentication.
Copy both the Client ID and Secret and store them securely. You’ll need these for the Houzez theme setup.

5. Optional: Sandbox Testing

For testing, use the Sandbox tab to create test accounts (buyer and seller) in the PayPal Developer Dashboard.
Test transactions in the sandbox environment before going live.

Configure PayPal API in Houzez Theme

1. Access WordPress Admin Dashboard

Log in to your WordPress site (e.g., www.yourdomain.com/wp-admin).
Navigate to Houzez > Theme Options in the left-hand menu.

2. Locate Payment Gateways

Select the Houzez custom Gateways as a payment gateway type:

3. Enable PayPal Payments

Toggle the option to PayPal Settings → Enable PayPal as a payment gateway
Copy and paste the Client ID, Client Secret Key, and Receiving Email obtained from the PayPal Developer Dashboard into the respective fields.

Add PayPal IPN for recurring payment

If you enable Auto Recurring payments in Theme Options → Membership →

Then navigate to your left sidebar on Dashboard to Pages → Add New to create a new page, and from the Page Template box located in the right sidebar select Template: PayPay Webhook (Recurring Payments) and Publish the page.

Add your create webhook page URL for PayPal IPN

Go to https://www.sandbox.paypal.com/ for setting up PayPal IPN

Troubleshooting

Common Issues:

Credentials Error: Double-check Client ID and Secret for typos or incorrect mode (Sandbox vs. Live).
IPN Failure: Ensure the IPN URL is correct and accessible. Check PayPal’s IPN history for errors.
Payment Not Processing: Verify that your site uses HTTPS and that the currency matches your PayPal account.

Support Resources:

Check PayPal’s Developer Documentation for API details. https://developer.paypal.com/api/rest/
Contact Houzez support via ThemeForest, Zendesk Support Forum or PayPal support for account-specific issues.