支付
AM 会自动追踪 Stripe 支付,同时也支持手动记录其他来源的支付。
支付历史归属到账户维度,方便你随时确认谁在何时支付了什么。
支付记录
{
id: "pay_...",
account_id: "acc_...",
amount_cents: 9900, // cents
currency: "usd",
status: "succeeded",
payment_method: "card",
external_id: "pi_..."
}
操作
| 操作 | Endpoint | 说明 |
|---|---|---|
| 创建 | POST /api/accounts/:account_id/payments | 记录支付 |
| 列表 | GET /api/accounts/:account_id/payments | 支付历史 |
| 获取 | GET /api/payments/:payment_id | 支付详情 |
| 更新 | PATCH /api/payments/:payment_id | 更新元数据 |
支付状态
| 状态 | 说明 |
|---|---|
pending | 等待处理 |
succeeded | 支付成功 |
failed | 支付失败 |
canceled | 支付已取消 |
refunded | 已退款给客户 |
支付方式
| 类型 | 说明 |
|---|---|
card | 信用卡/借记卡 |
ach | 银行转账(美国) |
wire | 电汇 |
other | 其他方式 |
自动追踪
Stripe 支付会通过 Webhook 自动记录。手动追踪主要用于:
- 银行转账
- 支票
- 外部支付处理器
- 信用额度/账务调整
元数据
可为支付附加业务上下文:
- 购买的计划或产品
- 发票引用
- 自定义追踪 ID