Square POS (In-Person Payments)
Last updated
Was this helpful?
Last updated
Was this helpful?
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.
Sandbox testing is unavailable for the Square POS API. Please test using production Square application details.
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.
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
Add your production application ID to the Bubble plugin page within your Bubble.io app.
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.
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.
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.
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.
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.
Add Bubble native iOS app support.
Add Bubble native Android app support.
By using the '' 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:
