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.
要点
- 状态:仅连接账户:目前没有任何自动操作。
- 请求的权限:PAYMENTS_READ、PAYMENTS_WRITE、MERCHANT_PROFILE_READ。
- Square的访问令牌在30天后失效,需通过刷新令牌续期。
- 目前尚未接入销售记录读取、付款或退款功能。
How it works
- 1
Create your account
Your name, your email and a password. No credit card.
- 2
Answer a few questions
Pilotiko reads what is public about your business and only asks you for the rest.
- 3
Your office is ready
Your departments, tasks and dials, set up for your trade. Invite your team whenever you like.
A department for every part of your business
Leadership
Your whole business on one screen: red, orange, green, you know where to look.
Example: the late quote shows up in red.
Assistant and AI agents
They prepare the work from your real data; you approve.
Example: a customer follow-up drafted, ready to send in one click.
Appointments and schedules
Slots, assignments and the team calendar in one place.
Example: the technician free on Thursday is suggested for you.
Marketing
Your posts and editorial calendar prepared for you.
Example: this week's post, ready to approve.
Website and visibility
Get found on Google and by AI assistants.
Example: your service pages kept up to date with your real prices.
Reports and numbers
Your monthly numbers without a spreadsheet.
Example: this week's revenue compared with last week.
Phone reception
An AI receptionist that answers and offers an appointment.
Example: the 7 p.m. call becomes a confirmed appointment.
了解更多
6 个部分 · 6 分钟阅读
Pilotiko中的Square连接有什么作用?
它会加密保存您授予Pilotiko访问您Square商户账户的授权。目前还没有任何功能使用该授权。
Square常常同时用于两种场景:柜台终端和线上支付。Pilotiko将Square归入“收款”功能,状态为仅连接:授权流程已搭建完成,但针对您销售记录的任何操作尚未实现。因此,Pilotiko看不到周二早上在柜台完成的销售,也无法为其办理退款。
Square按权限所开放的接口来说明每项权限 [1]。Pilotiko请求了下列三项权限,为日后的收款和销售对账做准备。请求这些权限并不代表它们已被使用:目前没有调用Payments API,也没有调用Merchants API。
Square以JSON格式返回令牌;授权码有效期为5分钟,且只能使用一次 [2]。Pilotiko与Square之间不使用PKCE:令牌交换在服务器端使用应用密钥完成。
如何将Square连接到Pilotiko?
进行授权的Square账户必须是企业的账户。如果Pilotiko尚未启用其Square应用,卡片会提示这一点,且不显示按钮。
- 1
找到Square卡片
在Pilotiko的“连接”页面,“收款”分组中。
- 2
发起连接
点击“连接”;Pilotiko会生成一次性请求,有效期10分钟,并与您的企业和您本人绑定。
- 3
查看Square授权页面
Square会显示所请求的三项权限;请确认这是正确的商户账户。
- 4
授权
Square会携带授权码将您重定向回Pilotiko;Pilotiko用授权码换取令牌并加密保存。
- 5
核对
卡片状态变为“已连接”,并注明不会执行任何自动操作。
Square目前有哪些功能可用,哪些即将推出?
| 功能 | 状态 | 说明 |
|---|---|---|
| 连接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中没有任何变化:柜台和您的线上支付链接都保持不变。
资料来源
- Square Developer, OAuth permissions reference (查阅于 2026年10月15日).
- Square Developer, OAuth API overview (查阅于 2026年10月15日).
- LégisQuébec, Loi sur la protection des renseignements personnels dans le secteur privé (RLRQ, c. P-39.1) (查阅于 2026年10月15日).
- Commission d'accès à l'information du Québec, Principaux changements apportés par la Loi 25 (查阅于 2026年10月15日).
延伸阅读
- Pilotiko 集成Google 日历、Outlook、Zoom、Stripe、LinkedIn、Cloudflare、Twilio 等集成:Pilotiko 的每个连接目前能做什么,状态均依据程序代码如实标注,一目了然。
- Stripe 与 Pilotiko:连接您的收款账户将您的 Stripe 账户连接到 Pilotiko:详解 OAuth read_write 授权范围,说明目前已接入和尚未接入的功能,并介绍如何随时撤销访问权限,让您对 Stripe 对接的每一步都清楚放心。
- Clover 与 Pilotiko:连接您的终端账户Clover 与 Pilotiko 集成指南:了解商户授权如何完成、为何不传递任何权限范围、哪些功能尚未接入,以及如何随时撤销访问权限,让您放心连接并管理 Clover 账户。
Your whole business, on one screen.
Each department is a room. Pilotiko prepares the work; you approve with one click.
- Call answered
- Appointment confirmed
- Email reply ready
- Invoice prepared