Documentation

WP Easy Pay plugin offers many powerful features to fit your needs. If you’re looking for Square Payment Gateway for your WordPress site, then try WP Easy Pay and start accepting online credit card payments. It generates dynamic buttons using shortcodes that enable checkout on your WordPress site using Square payment gateway.  WP Easy Pay works out perfect for accepting simple payment, donation, and subscription use and fulfill your requirement of one time payments to keep your business going.

Your customers will be able to pay for your products using Square.

In Addition, you can easily manage SQUARE TRANSACTION NOTE, EMAIL NOTIFICATIONS and managed REPORTS from Admin panel.

For Paid Version: Visit Following URL: https://wpeasypay.com/pricing/

• Extract the zip archive
• Upload the WP Easy Pay folder to the /wp-content/plugins/directory
• Activate the plugin through the ‘Plugins’ menu in WordPress

For Free Version: Visit following URL: https://wordpress.org/plugins/wp-easy-pay/

• Extract the zip archive
• Upload the WP Easy Pay folder to the /wp-content/plugins/directory

OR Open your WordPress site and search for “WP Easy Pay – Square for WordPress by wpexperts” then click on install and choose Activate as shown below

Note: From version 2.5.3 we have introduced the Auth functionality to connect Square application with WP Easy Pay.

Create a Square account. If you don’t have an account, go to https://squareup.com/signup to create one. Register your application with Square

Test Mode Process

🡪 Once you got access in Square then go to https://connect.squareup.com/apps  and follow these steps for Sandbox API:

Square Dashboard 🡪 Apps 🡪 My App 🡪 Go to Developer Portal 🡪 Click on New Application

Now enter a name for your application and Create App. The application dashboard displays your new app’s credentials. One of these credentials is the personal access token. This token gives your application full access to your own Square account.

Copy These credentials from Square Dashboard As Shown in Screenshot below 🡪 Access token 🡪 Application id 🡪 Location ID

🡪 Once you Enable test mode then place above sandbox credentials in Plugin Setting Page and Click on save changes button.

Live Mode Process

🡪 Go to the Admin panel settings and Click on Connect with Square button

🡪 Insert your Square Account credentials to logins.

🡪 Once your login permission page will appear. Kindly click on the “Allow” button to proceed further.

🡪 You have authenticated Square account and will land on API Experts page, here you have the option to get a redirect yourself back to the website.

🡪 Finally, once you click on redirect me button which will bring you back on your website. Kindly select the location of your Square application and click Save changes.

You can also Customize your popup title, description and look and feel as per your theme

• Open in popup: enable this option is to override the following settings
• Popup title: add popup title
• Popup Description:  add popup description
• Popup Header Background Color: customize popup header background-color
• Popup Header Text Color: customize popup header text color
• Popup Body Background Color: customize popup body background-color
• Popup Body Text Color: customize popup body text color
• Popup Button Text Color: customize popup button text color
• Popup Button Background Color: customize popup button background color.

Popup View

Page View

Extra Fields

Our plugin comes with a number of tags built-in. You can add your own custom form-tags in Extra field option. Extra field options functionality working same as like Contact Form 7. It brings conditional logic to your contact form. Form fields can be set to appear only when the user has given a particular response.

Dynamic values you can add include:

• Text
• Email
• URL
• Tel
• Number
• Date
• Text Area
• Drop-Down Menu
• Checkboxes
• Radio Buttons

Notifications

With this plugin, you can easily customize notification e-mails, so that Admin and User will receive Notification Email on successful payment.

For activation, you need to visit WP Easy Pay🡪 Add/Edit New Form🡪 Click on Notification Tab🡪 Configure your settings.

Transaction Note

You can Send selected fields in Square Transaction. For activation, you need to visit WP Easy Pay🡪 Add/Edit New Form🡪 Click on Transaction Note Tab🡪 Select your transaction fields. Note* (60 characters Only).

Form Shortcode

🡪 Following shortcode:

🡪 Place shortcode to show payment form at any page

Pop-up Logo

🡪 You can easily set logo from back-end as per your choice. Recommended size of logo (256 x 256) px

Reports

🡪 You Get Reports of your transactions from Reports Panel. For Reports Viewing you need to visit WP Easy Pay🡪 Click on Reports,🡪you can see all of your payment reports here.

Customizing button styles of all of your forms button is pretty easy in WP Easy Pay

• Override theme style on the button: this will override your current setting
• Button text color: customize button text color
• Button text Hover color: customize text hover color
• Button Background color: customize the button background-color
• Button Background Hover color: customize background hover color
• Button Border color: customize button border-color
• Button Border Hover Color: customize border hover color

Create a button to accept a fixed amount in WP Easy Pay. We have three types of Button type in WP Easy Pay. Each button type functioning as per their payment method.

1. Simple Payment
2. Donation
3. Subscription

1. Simple Payment

🡪 If selected type is “Simple button” → The following fields should be added (payment success URL, Button price, Button title) if the selected checkbox is “User set donation amount” then price field will be disabled, so user will be able to add donation amount from frontend)

2. Donation

🡪 If selected type is “Donation button” → The following fields should be added (Payment access URL, Button price, Organization name, Button title)

3. Subscription

🡪 If selected type is “Subscription button” → The following fields should be added (Payment access URL, Button price, Button title, Subscription cycle, subscription length) (every 1 to 6 options with options “day, week, month, year”, subscription length (Never expire, cycle “from 1 to 24 cycles options”). Also, if the selected checkbox is “User set donation amount” then price field will be disabled, so the user will be able to add donation amount from frontend)

🡪 Square account settings screen

1. Mode: Select either live or test mode
2. Test Mode: Click on Test environment where you can experiment with various features without fear of accidentally spending real money.  For testing purpose Add Token – Application ID – Location ID fetch from Square app settings
3. Test Card: Card number🡪4716381512382830 / CVV🡪 909 / ZipCode🡪44101
4. Live Mode: Enable live to mode to automatically integrate settings from the square payment account

Individual Form settings:

Square Account Setting

🡪 Square account settings Screen:

🡪Click on Use general square account setting, to use Square general setting.

🡪 These settings will override the Square general settings.

Button Settings:

🡪 Create a button to accept a fixed amount in WP Easy Pay. We have three types of Button type in WP Easy Pay. Each button type functioning as per their payment method.

1. Simple Payment
2. Donation
3. Subscription

1. Simple Payment
🡪 If selected type is “Simple button” → The following fields should be added (payment success URL, Button price, Button title) if the selected checkbox is “User set donation amount” then price field will be disabled, so user will be able to add donation amount from front-end)

2. Donation

🡪 If selected type is “Donation button” → The following fields should be added (Payment access URL, Button price, Organization name, Button title)

3. Subscription

🡪 If selected type is “Subscription button” → The following fields should be added (Payment access URL, Button price, Button title, Subscription cycle, subscription length) (every 1 to 6 options with options “day, week, month, year”, subscription length (Never expire, cycle “from 1 to 24 cycles options”). Also, if the selected checkbox is “User set donation amount” then price field will be disabled, so the user will be able to add donation amount from frontend)

Button Styling:

🡪 Customizing button styles of all of your forms button is pretty easy in WP Easy Pay

• Override theme style on the button: this will override your current setting
• Button text color: customize button text color

• Button text Hover color: customize text hover color

• Button Background color: customize the button background color

• Button Background Hover color: customize background hover color

• Button Border color: customize button border color
• Button Border Hover Color: customize border hover color

Popup Styling:

🡪 You can also Customize your popup title, description and look and feel as per your theme

• Open in popup: enable this option is to override the following settings

• Popup title: add popup title

• Popup Description:  add popup description

• Popup Header Background Color: customize popup header background color

• Popup Header Text Color: customize popup header text color

• Popup Body Background Color: customize popup body background color

• Popup Body Text Color: customize popup body text color
• Popup Button Text Color: customize popup button text color
• Popup Button Background Color: customize popup button background color.

Popup View:

Page View:

Extra Fields:

🡪 Our plugin comes with a number of tags built-in. You can add your own custom form-tags in Extra field option. Extra field options functionality working same as like Contact Form 7. It brings conditional logic to your contact form. Form fields can be set to appear only when the user has given a particular response.

Dynamic values you can add include:

• Text
• Email
• URL
• Tel
• Number
• Date
• Text Area
• Drop-Down Menu
• Checkboxes
• Radio Buttons
• First Name, Last Name, Email address fields showing by default in editor

Notifications:

With this plugin, you can easily customize notification e-mails , so that Admin and User will receive Notification Email on successful payment.

For activation, you need to visit WP Easy Pay🡪 Add/Edit New Form🡪 Click on Notification Tab🡪 Configure your settings.

Transaction Note:

You can Send selected fields in Square Transaction. For activation, you need to visit WP Easy Pay🡪 Add/Edit New Form🡪 Click on Transaction Note Tab🡪 Select your transaction fields. Note* (60 characters Only).

Form Shortcode:

🡪 Following shortcode:

🡪 Place shortcode to show payment form at any page

Pop-up Logo:

🡪 You can easily set logo from back-end as per your choice. Recommended size of logo (256 x 256) px

Reports:

🡪 You Get Reports of your transactions from Reports Panel. For Reports Viewing you need to visit WP Easy Pay🡪 Click on Reports,🡪you can see all of your payment reports here.

Square Account Setting:

 Square account settings Screen:

Click on Use general square account setting, to use Square general setting.

These settings will override the Square general settings.

• Collect donation and simple payment from a single button.
• User can enter a custom amount to make payment for the donation.
• Square card payment API support is currently available in US, Canada, UK, Australia, and Japan only.
• Sandbox support is available for developer testing.
• The notification email will send to admin on successful transaction.

• Accept payment in three different ways: simple payment, donation, and subscription.
• Auth functionality to connect Square application with WP Easy Pay.
• Create multiple buttons, each button for each page of your site.
• Place shortcode to show payment gateway at any page.
• Form builder feature will let you customize form according to your requirement.
• Send selected fields in Square Transaction Note (60 characters Only).
• Admin and User will receive Notification Email on successful payment.
• User can enter a custom amount.
• Sandbox support is available to test functionality before moving to the production phase.
• Whenever a user clicks on a button, you have an option show payment form in a modal / popup.
• Get Reports of your transactions from Reports Panel.
• Easily Customize your button like Button Text Color, Hover Color, background color, button border color, and button border hover color.
• Easily Customize your Popup Design like Body Background color, Header Background + Text Color and Pop up button Background + Text Color
• You can edit the form template using via Extra Fields option.
• First Name, Last Name, Email address fields showing by default in editor
• Predefined Mail Tags under notification settings like Transaction ID, Amount e.t.c
• Follow our Price Plan and choose one which fits perfect for your requirement.

== Changelog ==

= 1.0 2018-03-01 =
* Initial release

= 1.2 2018-04-18 =
* Add – Support for premium plans

= 1.3 2018-04-20 =
* Add – Square Transaction Note fields dynamic for Pro plans.

= 1.5 2018-05-28 =
* Added – Custom Pricing for simple and subscription payment
* Added – First name, Last name and email field in all forms i.e donation, simple and subscription form

= 1.6 2018-08-16 =
* Updated – Freemius SDK

= 1.8 2018-10-16 =
* Add – Dynamic form fields for pro feature.
* Add – Dynamic transaction note for pro feature.
* Add – Admin as well notification email templates for pro feature.
* Update – Popup issues for pro feature.
* Add – Multi Currency support in free version tested upto Version 4.9.8.

= 2.0 2018-10-26 =
* Added – Multiple payment buttons support on same page.
* Fixed – Form fields issue.
* Added – Subscription activation by default.
* Update – Email body template labelling.
* Update – Decimal amount support according to square API.
* Added – Amount field added inside all field tag.
* Added – Card fields mandatory on subscription button form.

= 2.2 – 18/12/2018 =

* Enhancement – Added compatibility for WordPress 5.0.1
* Enhancement – Added compatibility for WooCommerce 3.5.2
* Added – Action hook for wp_easy_payment_success and wp_easy_payment_failed.
* Added – Redirect page after payment success.
* Added – code quality.

= 2.3.0 – 27/02/2019 =
* Updated – Freemius SDK

= 2.5.1 – 09/04/2019 =

* Updated – Freemius SDK
* Added – Square Auth Connection simple way to connect with square.
* Added – Square Sandbox Auth Connection Payment process.
* Added – Square Auth Connection button css.

= 2.5.2 – 10/04/2019 =

* Added – Square Auth notice.

= 2.5.3 – 16/04/2019 =

* Added – Square notice conditions changed.
* Added – Subscription not logged condition.

= 2.5.4 – 13/06/2019 =

*Fix – Guest User Subscription Issue fixed
*Fix – Popup header and background color fixes.
*Fix – Dashboard warning issues resolved
*Improvement – Design and layout changes
* Improvement- Field Labels are now conditional
* Improvement- Sent transaction amount using [wpep_amount] Tag in notification Email Setting
* Improvement – Default field added first name, last name and email