{"id":1303,"date":"2025-11-10T13:56:49","date_gmt":"2025-11-10T12:56:49","guid":{"rendered":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/?post_type=lsvr_kba&p=1303"},"modified":"2025-11-14T07:37:03","modified_gmt":"2025-11-14T06:37:03","slug":"square-payment-gateway-configuration","status":"publish","type":"lsvr_kba","link":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/knowledge-base\/square-payment-gateway-configuration\/","title":{"rendered":"Square Payment Gateway: Configuration"},"content":{"rendered":"
\n

Good to Know<\/strong><\/p>\n

Square Add-on<\/a> is a separate extension that adds native Square payment gateway support to the Chauffeur Taxi Booking System for WordPress plugin. Before configuring the add-on, make sure you have the latest version of the Chauffeur Taxi Booking System installed on your WordPress site.<\/p>\n<\/div>\n

The Square Add-on allows you to accept online payments processed through the Square<\/a> platform directly in the Chauffeur Taxi Booking System booking form. Configuration consists of two main steps:<\/p>\n

    \n
  1. Creating an application and generating credentials in your Square Developer Dashboard.<\/li>\n
  2. Entering these credentials and basic settings in the booking form configuration.<\/li>\n<\/ol>\n

    Creating an Application and Generating Credentials in Square<\/h2>\n

    To generate the credentials required by the plugin, follow these steps:<\/p>\n

      \n
    1. Go to https:\/\/developer.squareup.com<\/a> and click ‘Sign In’<\/mark> to log in to your Square account (or create a new account if you don\u2019t have one yet). After logging in, you will see the Applications<\/strong> page.<\/li>\n
    2. Click the large +<\/strong> tile to create a new application. A popup titled Name your application<\/strong> will appear. Enter any descriptive name, for example “Chauffeur Square Payments”, and click ‘Next’<\/mark>.<\/li>\n
    3. In the next step, What will you build first?<\/strong>, select ‘Accept payments’<\/mark> and click ‘Next’<\/mark>.<\/li>\n
    4. In the Find your audience<\/strong> step, choose the option that best fits your use case (for example ‘Myself’<\/mark>) and click ‘Complete’<\/mark>.<\/li>\n
    5. You will be redirected to the Credentials<\/strong> page of your new application. At the top of this page you will see a toggle ‘Sandbox’<\/mark> \/ ‘Production’<\/mark>. Choose the mode you want to work with:\n
        \n
      • Sandbox<\/strong> \u2013 for test transactions.<\/li>\n
      • Production<\/strong> \u2013 for real transactions.<\/li>\n<\/ul>\n

        From this page, copy your Access token<\/strong> for the selected mode; it will be required later in the plugin configuration.<\/li>\n

      • In the left-hand menu of the Square Developer Dashboard, click ‘Locations’<\/mark>. On the Locations<\/strong> page you will find your Location ID<\/strong>. Copy the Location ID<\/strong> that you want to use for processing payments.<\/li>\n
      • In the left-hand menu, go to ‘Webhooks’<\/mark> -> ‘Subscriptions’<\/mark> and click ‘Add subscription’<\/mark>.<\/li>\n<\/ol>\n

        In the Add a webhook subscription<\/strong> screen, configure the following options:<\/p>\n

          \n
        • Subscription name<\/strong> \u2013 enter any name for the webhook, for example “Chauffeur Booking Webhook”.<\/li>\n
        • Notification URL<\/strong> \u2013 paste the full URL of your site that will receive webhook notifications. TIP: after installing the add-on, this URL is displayed in your WordPress dashboard under ‘Chauffeur Booking System’<\/mark> -> ‘Booking Forms’<\/mark> -> ‘Payments’<\/mark> -> ‘Payments’<\/mark> -> ‘Square’<\/mark> -> ‘Notification URL’<\/mark>. You can copy the URL from there and paste it here.<\/li>\n
        • API version<\/strong> \u2013 leave the default value selected.<\/li>\n
        • In the Events<\/strong> section, expand the ‘Payments’<\/mark> group and select:\n
            \n
          • payment.created<\/li>\n
          • payment.updated<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n

            After filling in the fields, click ‘Save’<\/mark>. The webhook subscription will be created and listed on the Webhook subscriptions<\/strong> page.<\/p>\n

            Next, click the name of your newly created webhook. A panel will appear with detailed information about the subscription, including the Signature key<\/strong>. Copy this Signature key<\/strong>; it will also be needed in the plugin configuration.<\/p>\n

            \n

            Good to Know<\/strong><\/p>\n

            You can create separate credentials and webhooks for the Sandbox<\/strong> and Production<\/strong> environments. When testing, use the sandbox access token and webhook. When going live, switch both the Square dashboard and the plugin configuration to the production values.<\/p>\n<\/div>\n

            Configuring Square in the Booking Form<\/h2>\n

            Once the add-on is installed and activated, you can configure Square for each booking form individually.<\/p>\n

              \n
            1. In your WordPress dashboard, go to ‘Chauffeur Booking System’<\/mark> -> ‘Booking Forms’<\/mark>.<\/li>\n
            2. Edit the booking form where you want to enable Square payments.<\/li>\n
            3. Open the ‘Payments’<\/mark> tab of the form editor.<\/li>\n
            4. Go to the sub-tab ‘Payments’<\/mark> and then click the ‘Square’<\/mark> payment method tab.<\/li>\n<\/ol>\n

              On the ‘Square’<\/mark> tab you will find the following options:<\/p>\n

              Sandbox Mode<\/h3>\n

              Use this option to switch between test and live environment for this booking form:<\/p>\n

                \n
              • Enable<\/strong> \u2013 the form uses sandbox credentials and processes test transactions.<\/li>\n
              • Disable<\/strong> \u2013 the form uses production credentials and processes live payments.<\/li>\n<\/ul>\n

                Access Token<\/h3>\n

                Paste here the Access token<\/strong> copied from the Credentials<\/strong> page of your Square application (sandbox or production, depending on the mode you are using).<\/p>\n

                Location ID<\/h3>\n

                Paste here the Location ID<\/strong> copied from the Locations<\/strong> page in your Square Developer Dashboard.<\/p>\n

                Signature Key<\/h3>\n

                Paste here the Signature key<\/strong> copied from the details of your webhook subscription in the Webhooks<\/strong> section.<\/p>\n

                Notification URL<\/h3>\n

                This field will be filled automatically with your site\u2019s URL used for webhook notifications. If the field is empty for any reason, paste the full URL of your site (including https:\/\/) that you used earlier when creating the webhook subscription in the Square dashboard.<\/p>\n

                Redirection Delay<\/h3>\n

                Set the delay (in seconds) before the customer is redirected from the booking form to the Square gateway.<\/p>\n

                Logo<\/h3>\n

                Optionally, you can upload a custom logo that will be displayed on step #3 of the booking form when the customer selects the Square payment method. If you upload a logo here, it will replace the default Square logo for this gateway in the booking form.<\/p>\n

                Information for the Customer<\/h3>\n

                Use this field to display additional information to the customer before they are redirected to the Square payment page (step #5 of the booking process).<\/p>\n

                Enabling Square as a Payment Method<\/h2>\n

                After entering the Square settings, you still need to enable this gateway as one of the payment options in the booking form:<\/p>\n

                  \n
                1. While still editing the booking form, go to ‘Payments’<\/mark> -> ‘General’<\/mark>.<\/li>\n
                2. In the ‘Payment’<\/mark> option, select ‘Square’<\/mark> as one of the available payment methods for this form.<\/li>\n
                3. Optionally, set ‘Square’<\/mark> as the ‘Default Payment’<\/mark> if you want it to be preselected for customers.<\/li>\n
                4. Click ‘Update’<\/mark> or ‘Publish’<\/mark> to save your changes.<\/li>\n<\/ol>\n

                  Debugging and Log Manager<\/h2>\n

                  After installing the add-on, a new settings section will appear in your WordPress dashboard under ‘Settings’<\/mark> -> ‘Chauffeur Booking System: Square’<\/mark>. This section includes a Log Manager<\/strong> tool that allows you to verify the correctness of your configuration and review any errors or warnings related to the payment process.<\/p>\n

                  \n

                  Important!<\/strong><\/p>\n

                  Make sure that your Square account is fully activated for payments and that you are using the correct access token, location, and webhook configuration for the selected environment (sandbox or production). Incorrect or mixed credentials may cause payments to fail or webhook events not to be delivered.<\/p>\n<\/div>\n

                  \n

                  Summary<\/strong><\/p>\n

                  Document version: 1.0
                  \nLast updated: November 10, 2025
                  \nPlugin version: 9.0+<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

                  Good to Know Square Add-on is a separate extension that adds native Square payment gateway support to the Chauffeur Taxi Booking System for WordPress plugin. Before configuring the add-on, make sure you have the latest version of the Chauffeur Taxi Booking System installed on your WordPress site. The Square Add-on allows you to accept online […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"lsvr_kba_cat":[23],"lsvr_kba_tag":[],"_links":{"self":[{"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba\/1303"}],"collection":[{"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba"}],"about":[{"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/types\/lsvr_kba"}],"author":[{"embeddable":true,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/comments?post=1303"}],"version-history":[{"count":6,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba\/1303\/revisions"}],"predecessor-version":[{"id":1326,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba\/1303\/revisions\/1326"}],"wp:attachment":[{"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/media?parent=1303"}],"wp:term":[{"taxonomy":"lsvr_kba_cat","embeddable":true,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba_cat?post=1303"},{"taxonomy":"lsvr_kba_tag","embeddable":true,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba_tag?post=1303"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}