Square POS (In-Person Payments)

This Bubble.io plugin will allow you to easily and securely take in-person payments using the Square POS (Point of Sale) Android or iOS app directly from your Bubble web application on a handheld device.

Square API Reference Documentation

Forum: Help - Feedback - Feature Requests

[New Plugin] Square POS (Point of Sale) - By InterwebbBubble Forum

Plugin Page: Purchase - Ratings

Square POS (Point of Sale) Plugin for Bubble, by InterwebbBubble

Sandbox testing is unavailable for the Square POS API. Please test using production Square application details.

Key Concepts

Devices

Square offers in-person payment solutions using a mix of your own devices and their own hardware. For example, you can use your own iPad + Bubble.io app and the Square card reader to securely take card payments.

POS Hardware & Solutions | SquareSquare

Call Back URL Response

The call back URL is the required URL that the Square POS app returns to after a payment has been successful or an error has occurred.

The response URL includes parameters and It is usually defined as a confirmation page or backend workflow/api endpoint within your Bubble.io app. Multiple call back URLs can be added to the Square Developer Dashboard in the Point of Sale API section.

Example call back URL: https://interwebbplugins.bubbleapps.io/version-test/confirmation-page

Example call back URL response: https://interwebbplugins.bubbleapps.io/version-test/confirmation-page?data=%7B%22error_code%22:payment_cancelled%22

By using the 'Get data from page URL' option within your workflows, you have the ability to utilise the URL parameters from your call back URL response to update data or trigger workflows within your Bubble app.

The full list of response parameters available can be found in the Square developer documentation: https://developer.squareup.com/docs/pos-api/web-technical-reference

Getting Set Up

1. Add your production application ID to the Bubble plugin page within your Bubble.io app.

2. Within the Square developer dashboard, under the 'Point of Sale API' section, add one or many web call back URLs. The Square POS app will send a response to these URLs with parameters such as error codes.

3. Finally, download and install the Square POS app from the app store on your device, make sure to sign in for the plugin to be able to open the Square POS app from your Bubble app.

Workflow Actions

Take Payment (iOS)

Use this action to automatically open the Square POS app on any device running iOS.

Note: Make sure you have the Square POS app installed and signed in.

Take Payment (Android)

Use this action to automatically open the Square POS app on any device running Android.

Note: Make sure you have the Square POS app installed and signed in.

Additional Information

• The POS Android/iOS app has no sandbox capability so testing has to be completed with live payments. Refunds can be easily processed for free from the seller dashboard.

Possible Roadmap

• Add Bubble native iOS app support.

• Add Bubble native Android app support.