Payments

How to connect Square to your IPTVbp store

Connect your own Square account with an access token, a location ID and a webhook, so card payments confirm orders by themselves.

2 min read
Published November 18, 2026
Last checked November 18, 2026
payments
square
cards
gateway

Square takes card payments, plus Apple Pay, Google Pay and Cash App Pay, through your own Square account. Your store sends the customer to Square's checkout and confirms the order when Square reports the payment.

1Step 1 of 4Get your Square details

Open the Square Developer Console (developer.squareup.com/apps), not your normal Square Dashboard, and open your application. Switch it to Production. Under Credentials, copy the production Access Token. Note your Location ID too.

2Step 2 of 4Add Square to your store

Go to Payment gateways → All gateways and click Add Gateway. Under Gateway, click the Square tile. The fields for Square appear below it.

  • Access Token: the production access token.
  • Location ID: your Square location ID.
  • Webhook Signature Key: from the webhook in step 3.

Optional: Name at checkout and Short description at checkout set what your customers see for this payment method. Leave them empty to show the gateway's own name.

3Step 3 of 4Set the webhook

The add page shows Webhook setup — required for automatic confirmation, with the address under Webhook / notification URL and a copy button.

  1. In the Developer Console, still in Production, open Webhooks → Subscriptions and click Add subscription.
  2. Paste the copied address as the notification URL exactly as shown, and pick the newest API version.
  3. Tick the event payment.updated and save.
  4. Open the subscription, click Show next to its Signature Key, and paste it into Webhook Signature Key.

Square signs every message with that exact address. A trailing slash or your own domain makes every payment fail to confirm.

4Step 4 of 4Save and check that it shows Active

Click Add Gateway. Your store saves the keys encrypted. The gateway is listed under Configured Gateways. Active means it is offered at checkout. To take it off checkout for a while, click Configure and switch Gateway Status off.

Frequently asked questions

Do I need the webhook?

Yes. Webhook Signature Key is a required field: Square tells your store about each payment through the webhook, and your store checks its signature with that key.

Can I use Square's sandbox?

Use your production access token. Test with a small real order on your own store, then refund it in Square.

What is Cash App Pay in the gateway list?

Cash App Pay is a separate gateway that runs on a second Square account. See Cash App Pay.

Ready to try it yourself?

Spin up your own IPTVbp store and connect a panel. It's free until you have 25 paying customers, no card needed.

Start free trial