Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Instructions

  1. Set up a Redirect URL and Notification URL on your application

  2. Configure Square Terminal in the Backend

  3. Set up Pusher Sockets

...

1. Set up a Redirect URL and Notification URL on your application

Before configuring Square Terminal in the Backend, you need to set up a Redirect URL and Notification URL on your application.

  • Redirect URL

    The redirect URL is the endpoint for your application or web page that processes the seller authorization response and manages the seller’s OAuth tokens. You need to add this URL to your application using the Developer Dashboard.

    To set up the redirect URL, go to the Developer Dashboard, choose Open for your application, in the left pane, choose OAuth. In the Redirect URL box, enter the URL that redirects the seller authorization to your application, then choose Save (or you can get the redirect URL quickly by copying the redirect URL that is auto-generated by your domain into the Guide section of Square Terminal in the Backend page, then paste it to the Redirect URL box.

  • Notification URL

Applications need at least one reachable notification URL to receive and process webhook events from Square. Notification URLs are specified on the Webhooks page of your application in the Developer Dashboard.

To set up a notification URL, you need to define an endpoint that will direct webhook event notifications to your application by going to the Webhooks page of your application in the Developer Dashboard, click on the Add Endpoint subscriptions button, on the Add Endpoint popupa webhook subscription page, enter your notification URL into the URL box (or you can get the notification URL quickly by copying the notification URL that is auto-generated by your domain into the Guide section of Square Terminal in the Backend page then paste it to the URL box).

...

Recommended: While adding Endpoint, you should select the following events

  • device.code.paired

  • refund.updated

  • terminal.checkout.updated

  • terminal.refund.updated

...

2. Configure Square Terminal in the Backend

To be able to use Square Terminal as a payment method on Point of Sales of Magestore, you first need to set up Square Terminal in the Backend.

...

Fill out the following fields:

Field

Description

Enabled

Yes/No

Title

Enter a title to identify Square Terminal as a payment option during checkout, take payment, refund

Client ID

Enter the Client ID from your Square application (Application ID is also known as the Client ID). 

Get it from the Oauth page.

Client Secret

Enter the Client Secret from your Square application (Application Secret is also known as the Client Secret)

Get it from the Oauth page.

Webhook Signature Key

Enter the Webhook Signature Key.

Get it from the Endpoint Details on the Webhooks page. http://prntscr.com/1t4cgx3

Sandbox Mode

Yes/No

Set the current operating environment for Square Terminal transactions

Sort Order

Define the display order of this payment method on the checkout/take payment screen

If the Square SDK has not installed yet, you need to install Square SDK by running the command:

...

In sandbox mode, the seller dashboard should be opened in the same browser with your website: Make sure you’re opening Square Developer > Sandbox Test Accounts > Square Dashboard when connecting

After connecting with Square successfully, the “Location” field is displayed to allow mapping the POS Locations with Square Locations. You can remove a mapping by clicking the Recycle Bin icon and re-mapping with another one.

...

You can click this button to revoke the access token.

3. Set up Pusher Sockets

Since we are using Pusher Sockets to push the information from server to client, you need to go to POS > Admin > Settings > Pusher Channels (WebSocket) to enable and configure this.

Before you configure Pusher Sockets, you need to install Pusher SDK by running the following command via your SSH:

composer require "square/square:13.1pusher/pusher-php-server:5.0.20210818"3

...

To get the information about: App ID, Key, Secret, Cluster of Pusher, you need to create an account on Pusher.com, then create a Channels app. Go to the “Keys” page for that app, and get your app_id, key, secret and cluster.

...

After you have filled out the information to configure Pusher Socket, click on the Save Config button. You now can click on the Test API connection button to make sure that you have already configured correctly.


Filter by label (Content by label)
page
showLabelsfalse
max5
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@9f4
showSpacefalse
sortmodified
showSpacetypefalsepage
reversetruetype
labelskb-how-to-article
cqllabel = "kb-how-to-article" and type = "page" and space = "PD"labelskb-how-to-article
Page Properties
hiddentrue

Related issues