产品
Doggie Pay：面向商户的稳定币支付基础设施
介绍 Doggie Pay 的产品定位、Checkout / Customers 双轨收款、商户门户与开放 API，以及当前已上线的稳定币收单能力，供投资机构、产品与研发团队参考。
Doggie Pay：面向商户的稳定币支付基础设施
稳定币在跨境和数字化业务里越来越常见，但对商户来说，难点往往不在「能不能收 USDC / USDT」，而在于要不要自己做钱包、地址池、入金确认、出金调度、账本对账，以及一套能验签的回调通知。这些事成本高，也容易把团队拖离主业。
Doggie Pay 做的是商户侧的稳定币支付基础设施。商户不必自建链上钱包体系，即可接入按笔收款（Checkout），或应用内充值 / 提现（Customers）。资金统一进入商户的 USDC / USDT 余额，业务侧用可验签的 Webhook 推进履约。
本文面向投资机构、VC、产品经理和开发人员，只写当前已上线能力，不含未交付的路线图。
1. 产品定位：服务商户收单，不是 C 端钱包
| 维度 | 当前做法 |
|---|---|
| 服务对象 | 商户及其产品 / 研发团队 |
| 资产 | USDC、USDT（EVM 白名单网络） |
| 底层 | Circle Developer-Controlled Wallets（DCW） |
| 资金归属 | 链上入金计入商户资金池；产品里的「用户余额」由商户自己记账 |
| 结算含义 | 链上交易进入 COMPLETE 后更新商户余额并推送 Webhook，不是银行 T+N |
可以概括成一句话：
Doggie Pay 让商户能收稳定币，而不必自己运维链上钱包和资金流转。
它不是法币出入金通道，也不是面向零售用户的钱包 App，更不是替商户托管用户余额、或按笔抽成的计费系统。边界说清楚，才方便评估。
2. 为什么要做收单基础设施，而不是再包一层钱包 SDK
评估稳定币收单，通常会看三件事：
- 钱怎么走——入金记到谁账上、出金从哪里发起、失败怎么回滚。
- 能不能接进业务——订单支付和 App 内余额是否都能覆盖，Webhook 能否验签、能否重试。
- 运营能不能自己搞定——余额、退款、提现、密钥和回调，是否都能在商户门户里完成。
Doggie Pay 把这些收成两条可组合的产品线，共用同一套商户余额，以及同一套 Integration API / Webhook 约定。
3. 双轨模型：Checkout 与 Customers，余额打通
3.1 Checkout：按订单、按账单收款
适合电商结账、账单付款、一次性收费这类「一笔一结」的场景。
已上线能力：
- 服务端创建 Checkout Session（金额、币种、网络、成功 / 取消回跳、metadata）
- Hosted Checkout（
pay.doggiepay.com）：专属收款地址 + 二维码，买家不用注册 Doggie Pay - Checkout Button SDK（
@doggiepay/checkout）：在商户站点放支付按钮，打开 Hosted Checkout - 支付地址从商户地址池分配，一笔一址；入金确认后记入商户余额
- Webhook：
checkout.paid/checkout.expired/checkout.cancelled - 已支付订单可退款（需指定买家收款地址与网络，支持部分退款）
常见路径：创建会话 → 买家在 Hosted 页完成链上支付 → 余额更新 → Webhook 通知业务履约。
3.2 Customers：长存充值地址与代客出金
适合应用内余额、会员储值、游戏或内容平台充值这类「用户长期充提」的场景。
已上线能力：
- 按商户侧用户标识创建 Customer，在已启用网络上分配长期充值地址（同一地址可收 USDC / USDT）
- 入金确认后记入商户资金池，Webhook：
deposit.credited - 提现：Integration API 直接指定
to_address；也可在门户走「Prepare → 邮件 → Hosted Claim」 - 提现生命周期 Webhook：
prepared/requested/submitted/complete/failed - 准备中的提现可重发邮件或取消；超时未领取会回冲余额
原则很简单：用户账本在商户；链上充提由 Doggie Pay 执行。
4. 资金与结算：商户账本怎么记
商户侧是一套加密货币账本：
- 账户按「商户 × 账户类型 × 币种」区分；当前对外可用的是 crypto 账户（USDC / USDT）
- 入金（Checkout 支付成功、Customer 充值）增加商户余额
- 出金（用户提现、商户出金、Checkout 退款）扣减商户余额，并校验余额是否足够
- 不做自动换汇；余额变动以 Circle 交易进入终态为准
对运营来说，「到账」指的是：链上入金确认完成 → 商户余额可见更新 → 业务系统收到可验签通知。商户还可以把余额出金到已登记的自有钱包（Merchant Payout）。
5. 商户门户：日常运营自己做
商户用 Google 账号登录 merchant.doggiepay.com，即可处理日常运营，不必事事找人工配置。Overview 页可直接看到余额、成交与退款指标、流水，以及发起出金。
| 模块 | 能做什么 |
|---|---|
| Overview | 查看 USDC / USDT 余额、成交与退款指标、账本流水，发起商户出金 |
| Payments | 创建 / 查看 Checkout 会话，取消待支付，看支付详情 |
| Refunds | 对已支付订单退款，查看退款历史 |
| Wallets | 查看 Checkout 地址池、Customer 长存充值钱包 |
| Customers | 检索 / 创建客户，准备提现、重发邮件、取消 |
| Integration | 管理 API Key、Webhook 地址与密钥，查看投递记录 |
注册后即生成商户主体和密钥（Secret Key 只展示一次）。同一 Google 账号可管理多个商户，方便工作室或多品牌使用。
6. 开放 API 与接入方式
第三方服务端通过 Integration API（https://api.doggiepay.com/v1/*）接入。这套鉴权与商户门户 JWT、托管页公开接口相互隔离。
已上线的开发者能力：
- Secret Key 与 Publishable Key 分权；Publishable 仅开放白名单内的只读与创建收银等操作
- 强制携带
X-DoggiePay-Request-Id；可选Idempotency-Key，减轻重试带来的副作用 - 统一响应结构与错误码
- Webhook 使用 HMAC-SHA256 签名（
X-DoggiePay-Signature），支持重试，门户可查投递日志 - 覆盖 Checkout、Customers、Wallets、User Withdrawals、Refunds、Merchant Payouts
- 公开 API Docs 与本 Learn Center
买家默认走 Hosted Checkout / Claim。若要在商户站点内嵌支付入口，可用 Checkout Button SDK（@doggiepay/checkout）打开托管收银页。
7. 资产、网络与底层
| 项目 | 当前实现 |
|---|---|
| 资产 | USDC、USDT |
| 网络 | EVM；具体启用网络由平台白名单配置（对外建议先看 Ethereum、Base） |
| 钱包 | Circle Developer-Controlled Wallets |
| 入金 | Circle 入金通知验签 → 异步确认 → 记入商户余额 |
| 出金 | 平台热钱包转账 → 状态回流 → 扣减商户余额并推送 Webhook |
非白名单代币、非 EVM 网络不在 v1 范围内。只有交易进入完成态，才会改动业务余额，避免「链上还没确认就先入账」。
8. 安全与合规：能说清楚的边界
对外沟通时，更适合强调「能核验」，而不是堆合规承诺：
- Circle 入金通知做签名校验；商户 Webhook 使用 HMAC 与时间戳
- 密钥分层：Secret 只放服务端；门户会话与 Integration 鉴权分开；Claim 密钥放在 URL fragment
- 入金与关键请求有幂等约束，降低重复入账 / 重复出金风险
- 链与资产走白名单；状态不完整或来源不明的交易，不驱动余额
- 商户可自行轮换 API Key 与 Webhook Secret；平台可停用异常商户
边界： 终端用户 KYC / AML 由商户按自身业务安排；Doggie Pay 不做 C 端身份核验产品，也不替商户记用户业务余额。
9. 适合谁来看、从哪进
| 角色 | 更关心什么 | 建议入口 |
|---|---|---|
| 投资机构 / VC | 定位是否清楚、双轨是否覆盖真实场景、资金模型是否说得通、交付是否完整 | 本文 + 商户门户演示 + API Docs |
| 产品经理 | Checkout 与 Customers 怎么选、履约怎么闭环、退款 / 提现体验 | Learn + 商户门户 |
| 服务端研发 | 鉴权、幂等、Webhook、客户与提现 API | API Docs |
| 前端研发 | Button SDK、Hosted 回跳 | Checkout SDK / Hosted Checkout |
| 商户运营 | 余额、退款、出金、密钥 | Merchant Portal |
10. 当前已上线能力一览
- 定位：面向商户的稳定币支付基础设施（Circle DCW，USDC / USDT，EVM）
- Checkout：Session → Hosted / Button → 入账与
checkout.*→ 支付退款 - Customers：长存地址 → 商户池与
deposit.credited→ API / 邮件 Claim 提现 - 商户侧资金：统一余额、指标、出金账户、Merchant Payout、密钥与 Webhook 自助管理
- 开发者接入：REST Integration API、可验签 Webhook、Checkout Button SDK、公开文档
11. 如何开始
- 打开 商户门户，用 Google 账号注册
- 保存 Secret Key，配置 Webhook 回调地址
- 按业务选用 Checkout、Customers，或两者一起开
- 对照 API 文档 完成第一次会话创建或客户创建
若要看某一条产品线的接入细节，可继续读 API Docs 里的《快速开始》《用 Checkout 收款》《Webhooks》《创建客户》《用户提现》等专题。