Square
Last updated
Was this helpful?
Last updated
Was this helpful?
Square is one of the most affordable and user-friendly payment platforms with simple and transparent fees for businesses with physical and online locations.
App developers can make use of the Square API to securely process payments as well as link seller accounts to easily integrate with pre-built features such as subscriptions, invoicing, inventory, customer profiles and much more.
Firstly, .
Next, follow the to create an application in the Square developer dashboard.
On the plugin page of your Bubble.io app, enter your personal access tokens and the endpoints for sandbox and production for each plugin you are using.
Please note that you will need to keep the API Version of your Square application up to date to avoid errors in our plugins. This can be done within your Square Developer dashboard.
Your Square account can have multiple business addresses, represented by different Location Id's which means you can process and report on payments for these addresses separately.
Some actions allow pagination if there are more results returned than the specified limit.
It is possible to view the next 'page' using a text string called a Cursor, which is returned in the previous workflow action and used in a repeat of the same workflow action to give the next page's query results.
Any data run in a page workflow (client-side) is accessible to the user through their browser, therefore, do not include sensitive information that is not relevant to the current user in your page workflows.
It's best practice to make use of the database privacy rules to control which information from your database different users can 'use' within your workflows.
Important
It is especially important to only use OAuth Access Tokens or Personal Access Tokens within BACKEND workflows, which run server-side, therefore, the user has no visibility of these actions through their browser.
Square Webhooks are subscriptions to events that update data in a Square account. Webhooks POST data state updates on specific events. To detect changes to data, typical APIs would require calls at regular time intervals. Square Webhooks replace regular API calls with instant, real-time notifications to your app.
Square Orders - create and manipulate orders.
Square Invoices - create and manage invoices.
Square Inventory & Catalog - manage the catalog and inventory.
Loyalty & Gift Cards - manage discounts and loyalty programs.
Bookings - create and manage bookings.
If interested, here are the latest .
Square offers a and test seller accounts to use as a sandbox environment for testing your app before going live.
Payment card values for testing in your sandbox environment can be found here:
Even if your business does not have a physical location, at least one business location needs to be defined in the , this generates a Location Id which is required in some plugin workflow actions.
Only use the Access Token (OAuth) field in the Square plugin workflow actions along with the plugin.
