Skip to content

How to configure Square payment gateway in taskip

Square lets clients pay invoices and service orders by card through a secure Square checkout page. Follow these steps to connect Square to Taskip.

Step 1: Navigate to Payment Methods in Taskip

  1. Open Taskip Dashboard.
  2. Go to Settings > Payment Methods.
  3. Click on Square from the available payment gateways.

Step 2: Get your credentials from Square

  1. Log in to the Square Developer Dashboard and open your application.
  2. Open Credentials and copy the Access token. Use the Sandbox token while testing and the Production token for live payments.
  3. Open Locations and copy the Location ID you want to receive payments in.

Step 3: Configure Square in Taskip

  1. In Taskip's Square settings:
    • Paste the Access Token.
    • Paste the Location ID.
    • Toggle Test Mode if you are using Sandbox credentials.
    • Enable Is Default if you want Square as the primary payment method.
  2. Copy the Webhook URL from Taskip.
  3. Save the settings.

Step 4: Configure the webhook in Square

  1. In the Square Developer Dashboard, open Webhooks and add a subscription.
  2. Paste the Taskip Webhook URL. It must match exactly, because Square signs the notification URL.
  3. Subscribe to the events payment.updated and order.updated.
  4. Copy the Signature key and paste it into Webhook Signature Key in Taskip, then save.

Step 5: Test and activate Square

  • Click Save Changes to complete the integration.
  • Create a small test invoice in a supported currency and pay it from the client's invoice page to confirm the payment reaches Taskip.
  • Once it works, Square appears on invoices and service catalog checkout for your clients.

Good to know

  • Payments use the currency of your Square account.
  • The invoice is marked as paid once, whether the client returns to Taskip or the webhook arrives first.