收款管理助手

解决的痛点

在多支付网关环境下，直接对接 Braintree 处理客户订阅和交易流水需要编写大量状态同步与分页样板代码。本技能通过 Composio 平台将 Braintree 工作流映射到 Stripe 兼容工具集，让 Agent 能够直接操作底层支付数据，无需关心底层 HTTP 请求的签名与重试机制。

核心工作流

• 客户与订阅管理：使用 STRIPE_CREATE_CUSTOMER 建档，并通过 STRIPE_CREATE_SUBSCRIPTION 绑定价格计划。支持设置 trial_period_days 试用或 send_invoice 手动账单模式。
• 支付方式绑定：通过 STRIPE_ATTACH_PAYMENT_METHOD 将处于 detached 状态的支付凭证挂载到指定客户。
• 账务核对：调用 STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS 拉取余额变动历史，支持基于时间戳和发票 ID 的精准过滤。

工程实践注意点

• 搜索语法严格：客户搜索必须使用 field:value 格式（如 email:'user@example.com'），裸字符串会直接触发异常。
• 金额单位转换：所有余额和交易金额均以最小货币单位（如美分）返回，聚合计算时需显式进行除法转换。
• 分页游标机制：分页依赖 starting_after 和 ending_before，必须从上一页响应中提取末尾对象 ID，严禁直接传入页码。