Guides
英文/English中文/Chinese

产品概览与基本概念

欢迎使用 DogPay PAAS（Web3 收单）服务。在您开始进行 API 对接之前，本指南将帮助您快速了解我们的产品定位、核心优势以及对接过程中的关键技术概念。

1. 什么是 DogPay 稳定币收单服务？

DogPay 稳定币收单服务是专为现代企业打造的加密货币支付处理网关。它支持您的用户直接使用稳定币（如 USDT、USDC 等）进行支付，而商户端则可以灵活选择最终接收法币或稳定币。

相比于传统的法币收单（如信用卡、本地钱包），DogPay 提供了颠覆性的核心商业价值：

  • 去中心化清算：剔除传统法币收单中繁杂的中心化清结算机构（如卡组织、收单行），大幅提升资金流转效率。
  • 抗汇率波动：基于稳定币的底层逻辑，结合秒级结算能力，彻底消除加密货币常见的汇率波动风险。
  • 降本增效：打破地域壁垒，显著降低跨境支付的手续费和隐藏成本。

📊 稳定币收单业务全景图

以下是消费者、商户与 DogPay 之间资金与信息流转的高维视图：

sequenceDiagram
    autonumber
    actor U as 消费者 (Consumer)
    participant M as 商户平台 (Merchant)
    participant D as DogPay 网关
    participant C as 区块链网络 (Blockchain)

    U->>M: 1. 选择商品/服务并提交结算
    M->>D: 2. 委托 DogPay 进行收单
    D-->>M: 返回专属 Web3 收银台链接
    M->>U: 3. 引导用户进入收银台
    
    Note over U, C: 用户使用 MetaMask、Trust Wallet 等支付
    U->>C: 4. 发送稳定币 (如 USDT/USDC)
    
    C-->>D: 5. 链上资金确认 & KYT 实时风控审查
    Note over D: 消除汇率波动，秒级锁定价值
    
    D-->>M: 6. 异步通知商户支付成功
    M-->>U: 7. 商户放行订单 (发货/开通服务)
    
    Note over D, M: 8. 资金 T+0 结算至商户账户

2. 适用业务场景

凭借极高的灵活性与合规性，我们的收单服务可完美赋能以下行业：

  • 🌐 跨境与高端电商：免去繁琐的跨国外汇限制，适合高单价商品（如奢侈品、电子产品）的全球化售卖。
  • 💻 虚拟与在线服务：为 SaaS 平台订阅、独立站会员体系、在线咨询等提供无缝的数字货币结账体验。
  • 🎮 游戏与数字资产：原生契合 Web3 生态，支持游戏内虚拟道具购买、NFT 资产交易等高频链上支付场景。

3. 安全与风控底座

DogPay 始终将商户的资金安全与合规放在首位，在底层架构中内置了金融级的防护机制：

  • 冷热钱包隔离：采用 95% 资金离线冷存储、5% 资金留存热钱包用于实时流转的极高安全标准。
  • 多重签名 (Multi-Sig)：核心资金动用必须经过 3/5 私钥授权机制，杜绝单点故障风险。
  • KYC/AML 与 KYT 追溯：商户入驻需通过严格身份认证；且每笔交易及链上地址均接入 KYT (Know Your Transaction) 系统进行风险审查与追溯，屏蔽黑产资金，隔离法律风险。
  • 实时监控引擎：系统 24 小时进行链上异动监控，遇异常交易自动触发冻结机制，并仅允许商户提现至预先设定的地址白名单中。

4. 开发者必读：核心技术与全局架构

为了让您的系统能够安全、稳定地接入 DogPay，请在查阅具体 API 接口前，务必理解以下技术设计理念。

🌍 4.1 接口环境 (API Environments)

DogPay 为开发者提供了完全隔离的测试与生产环境。强烈建议您在上线前，在 Sandbox 环境中完成全流程的集成测试。

🪙 4.2 币种与公链配置 (Currency Config)

在 Web3 中，同一种代币（如 USDT）可能同时发行在多条不同的区块链上（如 Ethereum、Tron、Solana 等）。由于不同链的底层协议和网络手续费完全不同，“币种 + 公链”的组合必须是唯一的。

  • 对接要点：在创建订单时，您必须传入由 DogPay 系统定义的 currencyConfigId，以此精准指定用户将通过哪条公链支付哪种代币。

🛡️ 4.3 幂等性与 Call ID (Idempotency)

由于网络延迟或客户端异常，您的系统可能会针对同一笔业务发起多次 API 请求。为了防止重复扣款或产生多笔冗余订单，DogPay 的核心接口均采用了严格的幂等性设计。

  • 对接要点：在发起 POST 请求（如创建订单、划转资金）时，您必须在请求体中提供一个由您系统生成的唯一 callId。对带有相同 callId 的重试请求，DogPay 将直接返回首次处理的结果。

⚡ 4.4 异步驱动哲学 (Asynchronous Driven via Webhooks)

与传统法币接口同步返回“支付成功”不同，区块链交易从发起到最终确认存在物理上的出块延迟（例如 Ethereum 可能需要数分钟）。

  • 对接要点：DogPay 的收单 API 仅会同步返回订单的创建状态和 payUrl。您系统的所有后续发货与业务放行，必须完全依赖接收 DogPay 发送的异步 Webhook 通知。### 🔗 4.5 托管收银台 (Hosted Checkout) 为了最大程度降低商户的研发成本，DogPay 采用了托管式的 Web3 收银台设计。
  • 对接要点：您无需在自己的前端页面中集成复杂的加密钱包连接逻辑（如 WalletConnect 等）。调用创建订单接口后，DogPay 会返回一个 payUrl。您只需引导用户跳转至此链接，即可由 DogPay 处理扫码打款、链上倒计时和汇率锁定等一切复杂交互。

Updated about 15 hours ago