Square与Pilotiko:已连接您的收款账户,但不含任何自动操作

适用于使用Square同时进行线上和柜台收款的企业。

目前,Pilotiko可通过OAuth连接您的Square账户,并请求三项权限:PAYMENTS_READ、PAYMENTS_WRITE和MERCHANT_PROFILE_READ。它尚不会读取任何销售记录,也不会创建任何付款。状态:仅连接账户:目前没有任何自动操作。您的线下和线上销售仍保留在Square中。

Try 30 days freeAll integrations

30 days free, no credit card.

作者 Pilotiko editorial team · 更新于

要点

  • 状态:仅连接账户:目前没有任何自动操作。
  • 请求的权限:PAYMENTS_READ、PAYMENTS_WRITE、MERCHANT_PROFILE_READ。
  • Square的访问令牌在30天后失效,需通过刷新令牌续期。
  • 目前尚未接入销售记录读取、付款或退款功能。

How it works

  1. 1

    Create your account

    Your name, your email and a password. No credit card.

  2. 2

    Answer a few questions

    Pilotiko reads what is public about your business and only asks you for the rest.

  3. 3

    Your office is ready

    Your departments, tasks and dials, set up for your trade. Invite your team whenever you like.

Try 30 days free

了解更多

6 个部分 · 6 分钟阅读

Pilotiko中的Square连接有什么作用?

它会加密保存您授予Pilotiko访问您Square商户账户的授权。目前还没有任何功能使用该授权。

Square常常同时用于两种场景:柜台终端和线上支付。Pilotiko将Square归入“收款”功能,状态为仅连接:授权流程已搭建完成,但针对您销售记录的任何操作尚未实现。因此,Pilotiko看不到周二早上在柜台完成的销售,也无法为其办理退款。

Square按权限所开放的接口来说明每项权限 [1]。Pilotiko请求了下列三项权限,为日后的收款和销售对账做准备。请求这些权限并不代表它们已被使用:目前没有调用Payments API,也没有调用Merchants API。

Square以JSON格式返回令牌;授权码有效期为5分钟,且只能使用一次 [2]。Pilotiko与Square之间不使用PKCE:令牌交换在服务器端使用应用密钥完成。

  • PAYMENTS_READ:读取付款记录,例如ListPayments或GetPayment [1]。目前未使用。
  • PAYMENTS_WRITE:创建、取消和退还付款,例如CreatePayment或RefundPayment [1]。目前未使用;日后若要使用,也将等待人工批准。
  • MERCHANT_PROFILE_READ:读取商户账户及其销售点的信息,例如ListLocations或RetrieveMerchant [1]。目前未使用。

如何将Square连接到Pilotiko?

进行授权的Square账户必须是企业的账户。如果Pilotiko尚未启用其Square应用,卡片会提示这一点,且不显示按钮。

  1. 1

    找到Square卡片

    在Pilotiko的“连接”页面,“收款”分组中。

  2. 2

    发起连接

    点击“连接”;Pilotiko会生成一次性请求,有效期10分钟,并与您的企业和您本人绑定。

  3. 3

    查看Square授权页面

    Square会显示所请求的三项权限;请确认这是正确的商户账户。

  4. 4

    授权

    Square会携带授权码将您重定向回Pilotiko;Pilotiko用授权码换取令牌并加密保存。

  5. 5

    核对

    卡片状态变为“已连接”,并注明不会执行任何自动操作。

Square目前有哪些功能可用,哪些即将推出?

Pilotiko中的Square,截至2026年10月15日
功能状态说明
连接Square商户账户仅连接账户:目前没有任何自动操作请求三项权限,令牌已加密
读取柜台和线上销售记录即将推出未调用Payments API
创建付款或退款即将推出将需要人工批准
读取您的销售点(Locations)即将推出未调用Merchants API
在Pilotiko端断开Square可用令牌被清除,并记入审计日志

Pilotiko能看到Square一天的销售情况吗?

您的Square数据如何受到保护(Loi 25)?

Square令牌在存储时已加密(AES-256-GCM),在界面和日志中均不会显示。根据魁北克私营部门法律,任何企业都须对其持有的个人信息负责,由最高负责人确保遵守法律 [3]。目前Pilotiko不收集任何Square销售数据:除令牌本身外,没有其他需要保护的内容。

一旦开始读取销售记录,其中会包含您客户的个人信息;届时法律规定客户享有查阅权,并可应要求获得结构化、常用格式的副本 [3]。CAI提醒,这项数据可携权自2024年9月22日起适用 [4]。详情请见:您的权利和分包商。

撤销:在Pilotiko中,点击“断开连接”会清除令牌,并将该操作记入审计日志。在Square中,商户可撤销该应用的访问权限,这会使其令牌失效 [2]。

Square有哪些特有的限制?

Square的访问令牌在30天后失效 [2]。因此,长期未使用的连接需要通过刷新令牌续期,否则就要重新连接。Pilotiko用于Square的OAuth应用尚未注册。

如果只需要线上收款,请与Stripe比较;如果使用其他品牌的终端,请参阅Clover。所有连接都在集成页面,而您的预约也可以通过迁移从Acuity Scheduling导入。

常见问题

Pilotiko能看到我在Square终端上完成的销售吗?

目前不能。读取权限已被请求,但尚未安排任何读取。您的销售记录仅在Square中可见。

如果Pilotiko不创建付款,为什么还要请求PAYMENTS_WRITE?

这样日后接入收款功能时,就无需再次向您申请授权。目前不会创建任何付款,日后的任何付款也都将等待人工批准。

Square的授权有效期多长?

Square的访问令牌在30天后失效,并提供刷新令牌以获取新令牌。如果续期失败,卡片会变为“需重新连接”。

我可以连接多个Square分店吗?

连接是在商户账户层面进行的,该账户涵盖其所有销售点。Pilotiko目前还不会读取这些销售点的列表。

如何切断Pilotiko对Square的访问?

在Pilotiko中点击“断开连接”即可清除令牌。您也可以在Square中撤销该应用,这会使其令牌失效。

我的客户在收款时会看到变化吗?

不会。Square中没有任何变化:柜台和您的线上支付链接都保持不变。

资料来源

  1. Square Developer, OAuth permissions reference (查阅于 2026年10月15日).
  2. Square Developer, OAuth API overview (查阅于 2026年10月15日).
  3. LégisQuébec, Loi sur la protection des renseignements personnels dans le secteur privé (RLRQ, c. P-39.1) (查阅于 2026年10月15日).
  4. Commission d'accès à l'information du Québec, Principaux changements apportés par la Loi 25 (查阅于 2026年10月15日).

Your whole business, on one screen.

Each department is a room. Pilotiko prepares the work; you approve with one click.

Try 30 days free

The Pilotiko office of a sample company: each department is a room.
  • Call answered
  • Appointment confirmed
  • Email reply ready
  • Invoice prepared

和您的团队一起试用办公室

免费 30 天。

免费试用 30 天