轮询与限制

请使用 webhooks 获取扣款和提现的状态更新。对同一实体的重复读取限制为每个账户和实体每 60 秒 30 次请求，该限制跨所有 API 密钥合并计算。不同实体的配额相互独立。扣款的各种别名共享同一配额，包括带有 ch_ 前缀的公开 ID 和原始 ID。

此限制适用于 GET /v1/charges/:id、GET /v1/payments/:id 和 GET /v1/withdrawals/:id（以及任何已注册的 GET /v1/pix/charges/:id 别名）。集合读取和创建操作不受影响。

收到 HTTP 429 时，请检查 error.code = entity_rate_limited，并至少等待 Retry-After 中指定的秒数。请使用带抖动的指数退避；不要通过轮换 API 密钥来重试。计数器使用从首次读取开始计算的固定 60 秒窗口。运维人员可通过 ENTITY_READ_LIMIT_PER_MINUTE 配置该配额；设为 0 即禁用。如果 Redis 不可用，读取将照常进行。

每个账户每个 UTC 日最多收到一封轮询提醒邮件，邮件使用该账户的沟通语言，并建议改用 webhooks。若在十分钟窗口内限流次数超过 100 次，运维团队会收到针对该账户的告警，每个 UTC 日最多一次。通知投递为尽力而为。