用途：为 PagBank（PagSeguro）生态的支付集成提供参考指引，覆盖 REST/OpenAPI 接口、OAuth Connect、结账、分账、Webhook、mTLS 转账与 PCI 合规等主题。回答领域问题前应先阅读 reference.md，请求/响应示例见 examples.md，涉及生产代码、Webhook 处理、卡流程、OAuth Connect、mTLS 转账或凭据存储前应阅读 security.md。
主要能力与集成路由：托管结账（Checkout Redirect/Lightbox，PCI 范围最小）；站内自定义 UX（Transparent Checkout + SDK，客户端加密强制）；支付链接（无需独立站点）；多租户 SaaS/市场入驻（PagBank Connect OAuth 2.0，X_CLIENT_ID + 令牌生命周期）；单商户服务端对服务端（静态令牌，禁止暴露客户端）；市场资金分配（Split Payments API，固定或百分比，最多 5 个接收方）；订阅/周期计费（Recurring Payments API，8 个强制 Webhook 事件）；账户间转账（Transfer API，需 mTLS）；ERP 对账（EDI Statement API v3.00，D+1 数据，检查 VALIDADO 头）；电商平台连接器（优先原生插件）；实体终端（PlugPag/SmartPOS SDK，5 步认证生命周期）；TEF；n8n 节点。
关键规则：绝不向商户服务器发送原始卡数据，使用 SDK 客户端加密与令牌化（Transparent Checkout v4.1）；Webhook 仅作提示，更新内部状态前必须 GET 资源（幂等）；Transfer API 需配置 mTLS 数字证书；Connect Challenge 2FA 使用 RSA 2048 位密钥（公钥 X.509 SPKI、私钥 PKCS8），OAEP/MGF1/SHA-256 解密 Base64 challenge，令牌 30 秒过期；分账 FIXED 模式接收方金额之和等于订单总额，PERCENTAGE 模式百分比之和为 100%；Boleto 百分比以整数发送（real_value × 100）；令牌轮换会使旧令牌立即失效，生产令牌仅邮件发送，需同步更新所有系统并自动化 OAuth 刷新；Webhook 签名用 x-authenticity-token 头，计算 SHA256("{account_token}-{raw_unformatted_payload}") 并常量时间比较；mTLS 证书轮换同样立即失效旧证书；错误 40002 通常是商户账户支付方式未启用；沙箱与生产凭据、公钥、证书、Webhook 端点与数据库必须隔离。
使用方式：结账流程为 POST /checkouts 携带 items 与 buyer，解析响应 links[]，找到 rel: "PAY" 的对象并跳转；认证决策树区分多租户（OAuth 2.0：注册应用、授权、POST 令牌交换、refresh/revoke）与单商户（静态 Bearer 令牌）。
限制与注意：资料未提供具体价格、费率或效果数据；生产代码需幂等键、结构化错误处理、限流退避、脱敏审计日志与功能开关；上线前需完成认证或确认豁免、环境隔离、密钥外置、mTLS 配置与续期、Webhook 签名校验、分账公式校验、OAuth 刷新自动化等检查项。官方文档见 https://developer.pagbank.com.br，API 索引见 https://developer.pagbank.com.br/llms.txt。