The driver enables the granular control useful in more complex integrations or network topologies; for example, connecting from behind a firewall. In this section you will find more advanced driver configurations, as well as steps to troubleshoot connection errors.

Create an App

You can follow the procedure below to register a custom OAuth app and obtain the OAuth client credentials, the Application Id and Application Secret. You will need to sign up for a Square account before starting this procedure.

1. Navigate to the Developer Dashboard and create an app.
2. Enter a name to be displayed to users when they log in to grant permissions to your app.

3. Click Create App. Set the Redirect URL on the OAuth tab to http://localhost:33333 or a different port number of your choice. If you are making a desktop application, set the Redirect URL, on the OAuth tab, to http://localhost:33333 or a different port number of your choice.

   If you are making a Web application, set the Redirect URL, on the OAuth tab, to a page on your Web app you would like the user to be returned to after they have authorized your application. Set CallbackURL to be equal to the value of the Redirect URL.

Set OAuthClientId to be equal with the Application Id on the Credentials page and set OAuthClientSecret to be equal to the Application Secret on the OAuth tab.