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. Also, 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.

Announcement: In Version 2.5.5 we have improved Sandbox support with the latest version of SQUARE V2 API in order to see test transactions in Square Dashboard. Also, we integrated SCA (Strong Customer Authentication) with the latest version of WP Easy Pay.

For Paid Version: Visit Following URL: https://easypay.wpengine.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.  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. 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.

Notice: The digital wallet payments are currently not available for subscription payments.

→ Digital Wallet integration will allow users to choose options from Apple Pay, Google Pay, and Masterpass to make a payment.

→ Admin must enable Apple Pay, Google Pay, and Masterpass options from the plugin settings tab in order to receive payments through Digital Wallets.

→ Admin can select any of the digital wallets which will appear on Front End. Also, Admin can select all payment options to offer their users more payment options.

→ Digital wallets can also be enabled for individual forms.

→ To enable the digital payment options for individual form, select a form, click the square settings tab and unchecked the checkmark on “use general square account settings” , the settings for square gateway and digital wallets will display.

→ Digital Wallets are only available to use on live mode, as the plugin is fetching and sending data in real-time to digital wallets.

→ Devices that support Apple Pay need to have  Apple Pay-enabled in iPhone or Apple Watch.

→ To see the Apple Pay button, users  must use Safari on iOS 12.1 or macOS 10.14.1 on any one of the below-listed devices:

iPhone (SE, 6, 6 Plus, or newer)
iPad (Pro, Air 2, mini 3, or newer)
Apple Watch
MacBook Pro with Touch ID
Any Mac model (2012 or newer)

• 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 ==

2.5.5 – 25/09/2019
Added – Square Sandbox Support
Added – SCA (Strong Customer Authentication)
Updated – Square V2 API and SDK version updated from transactionAPI to PaymentAPI

 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

 2.5.3 – 16/04/2019 =
* Added – Square notice conditions changed.
* Added – Subscription not logged condition.

 2.5.2 – 10/04/2019 =
* Added – Square Auth notice.

 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.3.0 – 27/02/2019 =
* Updated – Freemius SDK

 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.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.

 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.

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

 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.3 2018-04-20 =
* Add – Square Transaction Note fields dynamic for Pro plans.

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

 1.0 2018-03-01 =
* Initial release

= 2.6.8 - 31/01/2020 =

* Update - Email Notifications from field sends site title instead of WordPress
* Fixed - OAuth token loss fixed
* Fixed - Subscription form validation errors fixed

= 2.6.7 - 25/11/2019 =

* Update - Update - CC and BCC fields support fixed.

= 2.6.6 - 22/11/2019 =

* Update - NDS PMD Information removed from reports.
* Added - Currency identifiers added in emails
* Added - Form validation on extra fields is added
* Update - First Name, Last name and Email is being displayed in transaction notes

= 2.6.5 - 14/11/2019 

* Update - Pop-up form validation issues fixed

= 2.6.4 - 13/11/2019 

* Update - Apple Pay and Master Pass digital wallets are disabled due to technical problems in Square API.

= 2.6.3 - 01/11/2019

* Update - Apple Pay new verification file added
* Fixed - Simple, donation and subscription form validation has been improvised
* Added - Payment processing loader with notification added

2.6.2 - 18/10/2019

* Update - Freemius SDK
* Fixed - Subscription button error fixed

 2.6.1 - 15/10/2019

* Added - Multiple Form Support with Digital Wallets
* Fixed - Every page load is not creating a new session anymore.

 2.6.0 - 01/10/2019

* Fixed - If user unchecked all digital wallet from back end in this case credit card icon not showing on front end
* Fixed - Form Validation
* Fixed - Embed Video Link placed in front of Test Mode Section
* Fixed - Apple Pay Latest Verification File Updated

2.5.9 - 25/09/2019 

* Fixed - Apple Pay verification is happening on plugin activation.
* Fixed - Charge amount now accepts decimal values
* Fixed - Amount field automatically converts the value to integar

 2.5.8 - 19/09/2019 

* Added - Digital Wallets Support (Google Pay, Apple Pay, MasterPass)
* Added - 2 Steps pop-up form support
* Added - Square Sandbox Support added
* Added - Strong Customer Authentication added.
* Updated - Square API and SDK version updated from transactionAPI to PaymentAPI

 2.5.7 - 29/07/2019 

* Added - UI Fixes
* Fixed - Input Field Alignment Issue
* Fixed - Form Fields Label Issue

 2.5.6 - 03/07/2019 =
* Updated – Freemius SDK Version 2.3.0

 2.5.5 - 14/06/2019 =
* Fixed - Errors appear in the dashboard.

 2.5.4 - 13/06/2019 
* Added - Subscription not logged condition complete code added.
* Added - credit card form field label conditional view.
* Added - Print transaction amount using in the email using predefined Mail tag.
* Added - Show first name, last name & email fields in the form editor for new forms.
* Updated - Popup header background & color fixes.
* Updated - Fixed Wrong spelling issues.
* Updated - Fixed warning issues on backend settings.
* Updated - Design and layout changes in modal popup and default form.

 2.5.3 - 16/04/2019 

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

 2.5.2 - 10/04/2019 =

* Added - Square Auth notice.

 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.3.0 - 27/02/2019 =
* Updated - Freemius SDK

 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.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 labeling.
* Update - Decimal amount support according to square API.
* Added - Amount field added inside all field tag.
* Added - Card fields mandatory on subscription button form.

 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.

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

 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.3 2018-04-20 =
* Add - Square Transaction Note fields dynamic for Pro plans.

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

1.0 2018-03-01 =
* Initial release