# 就在此刻 一笔款项到账 。

> 为每笔 Stripe 付款、扣款失败和订阅事件接收推送通知。在 Stripe 或 Paddle 中添加 Webhook，即可在手机上跟踪销售和用户流失。

<!-- source: https://pocketalert.app/zh/use-cases/payment-alerts -->

最后更新：2026-10-25

Pocket Alert 可将 Stripe Webhook 转为你手机上的推送通知。每笔成功的扣款、扣款失败和取消订阅都会在一秒内送达，并附带金额和客户信息。在客户给你发邮件之前，你就能先得知支付失败。

## 三步开启支付告警

1. **创建 Webhook** — 创建一个 Pocket Alert Webhook，并使用 GJSON 模板映射 Stripe 负载，然后复制其接收 URL。
2. **添加 Stripe 端点** — 将接收 URL 作为端点粘贴到 Stripe 中，并订阅 charge.succeeded、charge.failed 以及你需要的其他事件。
3. **查看销售** — 进行一笔测试支付。该笔扣款会连同金额和客户邮箱显示在你的手机上。

## 实时掌握你的营收

只要支付服务商触发 Webhook，每笔销售、每次扣款失败和每次取消订阅都会立即送达你的手机。

- **兼容任意支付服务商** — 在 Stripe、PayPal、Paddle 或 LemonSqueezy 中将你的 Webhook URL 添加为端点，销售数据便会开始送达。
- **金额与客户** — 映射金额、客户邮箱和事件类型，让推送内容读起来就像一笔真实的销售。
- **自选事件** — 只订阅你需要的事件：成功扣款、扣款失败和取消订阅。
- **捕获失败与流失** — 为 charge.failed 和 customer.subscription.deleted 分别创建 Webhook，让扣款失败与客户流失各自在独立频道中提醒。
- **实时营收** — 成功的销售会立即送达。无需刷新控制台，也无需等待每日报表。
- **直接且安全** — 每个 Webhook URL 都有独立作用域，并通过 HTTPS 保密，因此你可以直接将 Stripe 指向它。

## 连接 Stripe

### 1. 创建 Pocket Alert Webhook

定义一个名称，并编写一个用于映射 Stripe 负载字段的 GJSON `message` 模板。此操作将返回你的入站接收 URL。

```
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Stripe Payments","application_id":"qm47b9pzxzxg","message":"Payment %data.object.amount% %data.object.currency% from %data.object.billing_details.email%"}'
```

响应中包含一个 slug，对应的接收 URL 为 `https://p4a.me/wh/1234abcd`。你也可以在 [Webhooks](https://pocketalert.app/zh/webhooks) 页面中创建。

### 2. 将接收 URL 粘贴到 Stripe 中

在 Stripe 控制台中打开 Workbench，然后切换到 Webhooks 标签页，点击 Create an event destination。选择 Snapshot 作为负载格式，因为 thin 事件只包含对象 ID，模板会为空。接着选择 `charge.succeeded`、`charge.failed`、`customer.subscription.deleted` 等事件，并将你的 Pocket Alert 接收 URL 粘贴为端点 URL。

### 3. 映射字段

Stripe 会将其事件 JSON 以 POST 方式发送到你的接收 URL，模板会基于该数据进行渲染：`%data.object.amount%`（以最小货币单位计，例如分）、`%data.object.currency%` 和 `%data.object.billing_details.email%`。使用 `%type%` 为事件添加标签。完整的 GJSON 路径说明请参阅[文档](https://info.pocketalert.app/api/webhooks/settings.html)。

## 常见问题

### 如何接收支付通知？

在 Pocket Alert 中创建一个带消息模板的 Webhook，然后将其接收 URL 作为端点粘贴到 Stripe 中。每个 Stripe 事件（charge.succeeded、charge.failed、customer.subscription.deleted）都会按你的模板渲染，并以推送通知的形式送达。

### 能否显示金额和客户信息？

可以。你的 GJSON 模板可以直接从 Stripe 负载中提取字段，例如 %data.object.amount% 和 %data.object.billing_details.email%，这样告警内容就会显示为“新支付 4900 · alex@acme.com”。Stripe 的金额以最小货币单位（分）表示。

### 能否选择接收哪些事件？

为 Stripe 端点订阅你需要的事件，例如 charge.succeeded、charge.failed 和 customer.subscription.deleted。只有这些事件会 POST 到你的接收 URL 并送达手机。

### 支持哪些支付服务商？

Stripe、PayPal、Paddle、LemonSqueezy、Chargebee 以及任何发送 Webhook 的支付服务商都可以使用。将其端点指向你的 Pocket Alert 接收 URL，并在模板中映射其负载字段即可。

### 能否将扣款失败与销售通知分开？

可以。为每种事件类型创建一个 Pocket Alert Webhook，例如一个用于 charge.failed，一个用于 customer.subscription.deleted，并为每个 Webhook 分配独立的应用，这样扣款失败与客户流失的通知就能在不同频道中区分开。

### 扣款失败能否比日常销售更醒目？

为每个 Webhook 设置默认级别：日常销售保持默认，为 charge.failed 设置高级别，使其能突破 iPhone 上的专注模式；如果只想留作记录，可将客户流失事件设为静默。在 Android 上，紧急级别甚至能突破勿扰模式，当扣款失败意味着生产环境账户失去服务时，这一点非常有用。
