CLOUDTRAX USER GUIDE:
Using PayPal in CloudTrax 4
Overview: what we’re doing
This guide is intended to help you set up your CloudTrax wireless network to accept payments through PayPal. With PayPal, you can charge users for access to your network based on time increments or bandwidth tiers.
Key features include:
- You keep 100% of revenue (less PayPal transaction fees). All payments go directly to you; Cloudtrax does not take a cut.
- You can use PayPal “Website Payments Standard”. You will only pay transactions fees—no commission or monthly fee.
- You keep control of the look and feel of your splash page and simply paste a PayPal “Buy Now” button into your splash page.
- With automatic MAC Authentication, you can allow users to roam between nodes without seeing the splash page again.
- You can offer multiple bandwidth tiers, or offer a free lower-speed service tier and one or more paid tiers at higher speeds.
Here’s what’s about to happen:
- We’ll create an account on PayPal where you can receive payments.
- We’ll enable auto-return and Payment Data Transfer in PayPal and integrate this into Cloudtrax.
- We’ll create a “Buy Now” button and payments page at PayPal.
- We’ll integrate PayPal into your splash page at Cloudtrax.
This guide is intended to be used with existing networks. If you haven’t set up your network yet, download the CloudTrax Quick Start Guide.
How it works: user perspective
With PayPal-enabled CloudTrax networks, a splash page with a “voucher” and “PayPal” option appears for users. To access the network, they:
- Click on the PayPal button and complete the payment with a PayPal account or credit card.
- Are directed to a simple screen on CloudTrax (with your logo if you choose) that gives them their new voucher. They simply click the ‘begin browsing’ button.
At this point the user is online. The voucher token is also emailed to them for future use should they need it.
What you’ll need
To set up PayPal on your network, you’ll need the following:
- A CloudTrax network running on Firmware ng 573 or later, using the CloudTrax 4 dashboard at ct4.cloudtrax.com.
Quick Tip: Check your firmware version
We’ll make this process as easy as possible. Here are a few key words that will help:
PayPal: An online payment service that, in our case, allows users to pay for network access with their Visa, MasterCard, American Express, or PayPal account.
Voucher: A code generated by CloudTrax that lets you control access on a per-user basis without requiring an external captive portal service provider.
Step 1: Create a PayPal account
Note: if you have an account already, skip to Step 2.
Start by going to PayPal.com and sign up for a new account.
- Click the “Sign Up” button at the top right of the page.
- Next, select “Business” and click “Continue”.
- Select “PayPal Payments Standard”.
- Fill in the form then click “Continue”. Fill in the second page, then click “Agree and Continue”.
After a few seconds, you should see this message: Welcome! Your account is open. Let's set it up so you can get paid.
Step 2: Enable auto-return and Payment Data Transfer (PDT)
If you skipped Step 1, go to PayPal.com and login.
- Click on the “Profile” button (on the top right of the page next to “log out”) and choose “Profile and settings” from the list.
- Next click on the “My Selling Tools” section, then the “update” button next to “Website preferences”.
- Under “Auto Return for Website Payments,” click “On” and enter the following URL in the “Return URL” field: https://paypal.cloudtrax.com/v2/return (Note the “https”)
- Under “Payment Data Transfer,” click “On.”
- Leave the remaining options as default and click the “Save” button at the bottom of the page. Your “Identity Token” will appear at the top of the page in a green highlighted box. You will want to select that and copy it (Ctrl-C in Windows or Command-C on Mac). Next we will paste it into CloudTrax.
- Open up Cloudtrax.com in a new browser window or tab and login to your account. Select the network from the drop-down list that you are going to link to this PayPal account. Configure / Vouchers pages is a section titled “PayPal”. It has a few options we will now set:
- Clients Per Voucher: Number of Client Devices per PayPal purchase. Typically one to five (maximum 10). If you're running a coffee shop, you’ll likely want one device. If you run a hotel or apartment complex, you might want to set this to 3 to 5 to cover multiple guests and their laptops, phones, tablets, etc.
- Download Bandwidth: Download bandwidth per client device (in kbps) for PayPal. For example, 500 kbps is “500” and 1.5 Mbps (megabits per second) is “1500”.
- Upload Bandwidth: Upload bandwidth per client device (in kbps) for PayPal. PayPal Identity Token: This is the unique string of numbers and letters you copied from the PayPal website. Paste it here.
Note: Bandwidth throttling for PayPal vouchers will *not* work unless you've enabled bandwidth throttling for all SSID's being used with the captive portal and splash-page.
Step 3: Create your Buy Now button
- Login (or flip back) to your PayPal account. Click on the “Profile” button again and choose “Business Setup” from the list.
- Choose whether or not you wish to: Process all payments through PayPal or Add PayPal checkout as another way to get paid.
- Under "Now, how do you want to set up PayPal on your website?", choose Option B for Add HTML buttons to your website yourself
- Click "Create Payment Buttons" and you'll be brought here:
- Choose "Buy Now" for button type (the default is "Shopping Cart" which isn't supported)
- Enter “Internet Access” in the “Item Name” box.
- Go to the Configure / SSID page for the SSID on which you are enabling Paypal. At the bottom of that page is the item ID. Select this value and copy it.
- Paste the Item ID that you copied in step 4 into the “Item ID” field on the Paypal site. This is very important. It is how CloudTrax will know what network users belong to when they purchase.
- Leave the price field blank.
- In the “Customize Button” box, click on “Add drop-down menu with price/ option”. Enter “Purchase:” (or whatever you’d like to title the “purchase” option) in the “Name of drop-down menu” box.
- Enter your various durations and prices in the three boxes. It is very important that you use terms that CloudTrax can parse. CloudTrax knows “hour”, “week”, “day” and “month” (including plural versions), so you can use any of these terms (but not abbreviations) in specifying your times. “2 hours”, “3 days”, “1 week” and “3 months” are all examples of durations you can enter. You must use the numerical value, not the number spelled out (i.e. use “3” instead of “three”).
Note: If you need non-English words, you'll need to manually edit the PayPal-generated button code, for example (in Spanish)
<option value="1 hour">1 hour $1.00 USD</option>would be changed to
<option value="1 hour">1 hora $1.00 USD</option>Enter the price you would like to charge next to each duration you enter (the minimum value we accept is 1.00). If you need more than three, there is an “Add another option” link you can click to add up to ten options.
- Next, click on the “Step 3: Customize advanced features (optional)” headline (you might have to scroll down to see it). This will open up a new section with various options we need to customize:
- Make sure that “Do you want to let your customer change order quantities?”, “Can your customer add special instructions in a message to you?”, and “Do you need your customer’s shipping address?” are all set to “No”.
- Check “Add Advanced Variables” and in the box below, enter this line exactly: notify_url=https://paypal.cloudtrax.com/v2/notify
Note this URL is “https” (not “http”). This is essential: this is the URL that will give your users their voucher after paying. If it is missing or not correct, they will not be able to login.
- Click on the “Create Button” button at the bottom of the page.
- Now you will see your button “source” in a box on the left and what the button will look like on the right. You can click on the drop down menu on the right to make sure your options look the way you want. If you want to change anything, you can do so by clicking the “Go back to edit this button” link. When you are satisfied with your button, click the “Select Code” button, then click the Ctrl-C (Windows) or Cmd-C (Mac) to copy the button source to your computers clipboard.
Next, we will paste it into a splash page.
Step 4: Add the button to your splash page
- Go back to the browser tab or window containing your CloudTrax network that you opened in Step 2 above.
- Select the Configure / SSID page for the SSID which you are configuring for Paypal.
- Select Splash Page: "Custom"
- Click the “Edit Splash Page” button.
- Choose a template from the drop down list at the top.
- Click the HTML editing (“<>”) button at the top left of the editor.
- Scroll the page down to the bottom. Look for the lines: <-- PayPal Button Start --> and <-- PayPal Button End -->
- Select the sample PayPal button code (everything between the above lines) and delete it. Then hit “CTL-V” (windows) or “CMD-V” (Mac) to paste your PayPal button code into the splash page between the lines.
- Click the “Preview” tab below your splash page to see what it will look like. You should see both a voucher entry field and your new PayPal Buy Now button.
- Click the Save Changes button at the top-right of the editor window. Your splash page has now been saved. Close the Splash Page editor window.
- Your site is now ready to accept payments. Give your nodes 10-15 minutes to update.
Testing your new splash page with PayPal
When you connect to the SSID you just enabled PayPal on, you should see your new splash page. To test the page, follow these steps:
- Click the PayPal “Buy Now” button you created.
- Purchase one of your options using a different PayPal account or use the “Credit card as a PayPal Guest” option.
- When you are done paying, you will be automatically (if paying with a PayPal account) redirected back to CloudTrax. If you paid via a credit card, there will be a “return to ” link. Click this link and you will be returned to CloudTrax.
- CloudTrax will display (with your logo if you uploaded one to the CloudTrax site) the voucher (and will also email it to you as the customer for future reference). Click the “Begin browsing” button.
- You should now be online (at Google.com). From here you can browse to any site you wish.
Users will see the splash page whenever their duration (that they selected from the Buy Now button) expires. They can roam within your network without seeing the splash page again as their MAC address will be automatically verified as they move between nodes.
Need additional help?
To learn more about planning and optimizing your network, read the Cloudtrax Network Planning Guide.
To learn more about the features within CloudTrax, read the CloudTrax Quick Start Guide.
To learn more about CloudTrax’s splash page feature, read the Using the Splash Page Editor Guide.
To learn more about CloudTrax’s vouchers feature, read the Using Vouchers in CloudTrax Guide.
To use Lobby Assistant or train others, read the Using Lobby Assistant Guide. This guide is written specifically for hotel and apartment front-desk staff.