Online Payments | Hosted Payment Page Website Widgets

4 min. readlast update: 03.12.2024

Hosted Payment Pages

Hosted Payment Pages are great for eCommerce businesses, fundraisers, service providers, dispensaries, healthcare organizations or any merchant that needs an easy way to allow customers to make an online payment without having to worry about PCI compliance. 

You can create as many secure hosted payment pages as needed. Each can be shared through a unique link, QR code or with the Pay Online embed code. 

Steps to Create and Share a Hosted Payment Page

1) Open Settings > Widgets > Add Page

 2) Enter details into the Add Hosted Payment Page window

- Rename the page which defaults to, "Open Amount Payment" 

- Rename the Service & Products which defaults to, "[BusinessName] Payment" or "[BusinessName] Donation"

- Optionally, enter a website URL if you would like to redirect customers to a specific page after successfully completing their payment. 

- Toggle the page to Active and click Save Changes to return to the Widgets settings screen

3) Choose which of the three ways you'd like to share your page: 

1. URL 

2. QR Code

3. Button Widget

 

Share Standard Hosted Payment Page with a URL

Click the copy icon in the Payment Page URL column to copy the URL  to your clipboard.

Paste the URL to hyperlink from anywhere you like to the Hosted Payment Page, so customers can click and immediately open to a secure browser page where they may enter the amount they wish to pay and be on their way. 

Share Standard Hosted Payment Page with a QR code

Click the copy icon in the QR Code column to copy the QR Code image to your clipboard.

Paste the QR Code image onto your flyers, business cards, website, signs etc. so customers can scan and immediately open to a secure browser page where they may enter the amount they wish to pay and be on their way. 

 

Install Standard Hosted Payment Page with the Website Widget Code

Click the copy icon in the Widget column to copy the page's JavaScript code to your clipboard. 

If you do not customize the widget code at all, the code you install to your webpage will allow customers to click a button labeled 'Pay Online,' which will open a payment form where they may input the amount they wish to pay or give. 

Sample Widget Code - Open Amount

<div id="EWWidget">

<script src="https://pay.everyware.com/.well-known/EWWidget.js"></script>

<script>

init(div="EWWidget",

buttontext="Pay Online",

buttonclass="",

showbutton = true,

G ="<UniqueID>");</script>

</div>

 

Sample Widget Code 2 - $ Amout Due

<div id="EWWidget">
<script src="https://portal.everyware.com/.well-known/EWWidget.js"></script>

<script>
const payInfo = {
FirstName: '',
LastName: '',
AddressLine1: '',
AddressLine2: '',
AddressCity: '',
StateCode: '',
CountryCode: '',
AddressZip: '',
EmailAddress: '',
Phone: '',
Amount: '2.00',
Description: 'Shine Texas Payment',
G:'gr3e5690-049b-4617-887b-0889225a2fff'
};init
(div ="EWWidget",
buttontext="Pay Online",
buttonclass="payonlinebutton",
showbutton = false,
csshref= "",
defaultPayInformation = payInfo);
</script>
</div>

 

Code parameters: 

The following data can be sent to pre-populate the hosted payment form.

Parameter Definition Required or Optional
FirstName First Name of customer being billed. Optional
LastName Last Name of customer being billed. Optional
Address1 First line of Billing Address for customer.  Optional
Address2 Second line of Billing Address for customer.  Optional
City City for customer Billing Address. Optional
Statecode State for customer Billing Address. Optional
Postalcode Zip code for customer Billing Address. Optional
Countrycode USA or CAN Optional
Email Customer's email address. Optional
MobilePhone Customer's mobile phone.  Optional
Amount Amount due, appears at the top of the Hosted Payment Page.  Required 
Description Line item description for invoice.  Required

⚠️Note: Hide/Show Button Parameter

  • If “show button” is “true” you will see a button like the one below; clicking this button brings up the payment form:
  • If “show button” is “false” the user will be taken directly to the payment form

👆 Like the Open Amount Hosted Payment Pages, the customer will now select to pay with a method on file through a Pay by Text message (respond YES), or enter new payment information and pay on the Hosted Payment Page.

👆 If you wish to send customers to  your home page or an upsell marketing page after they successfully make a payment, make sure to include the redirect URL in the Everyware Portal widget settings. This way, after a customer pays for 'Tennessee Fee $3.00' they'll see their payment receipt and after a few seconds, will be redirected to the page where they can make another payment or buy another item. 

👆Notice: Once you change your widget code, the URL and QR code in the portal won't link to the page on which you installed the customized widget. So, if you send a customer the URL or QR code assigned to the widget inside the Everyware portal, the page will open to the default $0.00 amount due rather than your updated version. 

 

Transaction Reports

If a customer enters a new payment method on a hosted payment pages, that transaction will appear in Everyware Payment Reports as "Hosted Pay" type. 

 

If a customer sends themself a Pay by Text message after looking up their account on a Hosted Payment Page, the successfully paid transaction will appear as "Invoice" type. 

 

 
 
Was this article helpful?