# StablePay 文档

> 稳定、安全、易用的稳定币支付解决方案

## Docs

- [发票列表](https://docs.stablepayfi.ai/api-reference/发票/发票列表.md): 分页查询发票列表，支持按订阅、客户、状态筛选。
- [查询发票](https://docs.stablepayfi.ai/api-reference/发票/查询发票.md): 根据发票 ID 获取发票详情。
- [创建支付会话](https://docs.stablepayfi.ai/api-reference/支付会话/创建支付会话.md): 创建新的支付会话。服务端会按商户店铺配置解析来源系统，并生成收银台 URL。
- [取消支付会话](https://docs.stablepayfi.ai/api-reference/支付会话/取消支付会话.md): 取消/过期一个支付会话。当前实现会将会话标记为过期；不存在的会话会按幂等语义返回简化成功响应。
- [查询支付会话](https://docs.stablepayfi.ai/api-reference/支付会话/查询支付会话.md): 根据支付会话 ID 查询支付会话详情。
- [查询支付方式](https://docs.stablepayfi.ai/api-reference/支付方式/查询支付方式.md): 根据支付方式 ID 查询支付方式详情。
- [创建订阅](https://docs.stablepayfi.ai/api-reference/订阅/创建订阅.md): 创建一个新的订阅。创建后订阅通常进入 `incomplete` 状态，需用户在返回的 `checkout_url` 完成首次授权付款后才进入 `active`（或 `trialing`）。请求头中的 `Idempotency-Key` 为必填幂等键。
- [取消订阅](https://docs.stablepayfi.ai/api-reference/订阅/取消订阅.md): 立即取消订阅，或设置为周期结束时取消。
- [查询支付详情](https://docs.stablepayfi.ai/api-reference/订阅/查询支付详情.md): 根据订阅发票返回的 `payment_id` 查询支付详情。`payment_id` 是订阅账单产生的支付 ID，可用于确认该笔订阅扣款的支付状态、金额和链上支付信息。
- [查询订阅](https://docs.stablepayfi.ai/api-reference/订阅/查询订阅.md): 根据订阅 ID 获取订阅详情，可通过 `expand` 展开关联对象。
- [订阅列表](https://docs.stablepayfi.ai/api-reference/订阅/订阅列表.md): 查询订阅列表，支持按客户与状态筛选。当前接口不支持游标分页参数。
- [创建退款](https://docs.stablepayfi.ai/api-reference/退款/创建退款.md): 创建退款。`charge` 与 `payment_id` 必须二选一且不能同时传：普通支付退款传 `charge`，表示要退款的普通支付 ID；订阅退款传 `payment_id`，表示订阅账单产生的支付 ID。新建退款当前进入 `processing` 状态。
- [取消退款](https://docs.stablepayfi.ai/api-reference/退款/取消退款.md): 取消当前仍处于 `processing` 状态的退款。已完成、失败或已取消的退款不能再取消。
- [查询退款](https://docs.stablepayfi.ai/api-reference/退款/查询退款.md): 根据商户提供的 `refund_id` 获取退款详情，包含当前状态、链上交易哈希、失败原因等完整信息。
- [Checkout iframe 集成](https://docs.stablepayfi.ai/zh/api/checkout-iframe-integration.md): 如何将 StablePay Checkout 以纯 iframe 方式嵌入到网页、弹窗或抽屉中，以及这类集成方式的边界与注意事项。
- [集成前准备](https://docs.stablepayfi.ai/zh/api/getting-started.md): 集成 StablePay API 前需要了解的基础信息：API Key 获取、请求签名、Webhook 通知与安全建议。
- [Webhook 通知](https://docs.stablepayfi.ai/zh/api/webhook-notifications.md): StablePay Webhook 事件类型、请求头、签名校验要求，以及 payment.failed 中 frozen 状态的处理建议。
- [出现 404 / "Oops! Something went wrong." 怎么办？](https://docs.stablepayfi.ai/zh/faq/404-error.md)
- [Binance Wallet 通过 WalletConnect 连接失败](https://docs.stablepayfi.ai/zh/faq/Binance-Wallet-WalletConnect-Troubleshooting.md): 处理在移动端使用 Binance Wallet 扫描 WalletConnect 二维码时的常见连接失败问题。
- [找不到我想用的网络（比如 Arbitrum / Optimism 等）？](https://docs.stablepayfi.ai/zh/faq/network-not-found.md)
- [We're sorry, payment services are unavailable in your region.（你所在地区暂不可用）](https://docs.stablepayfi.ai/zh/faq/region-unavailable.md)
- [为什么我的付款订单被冻结？](https://docs.stablepayfi.ai/zh/faq/security-payment-blocked.md): 了解 StablePay 风控冻结的常见原因、调查周期、资金处理方式，以及商户在调查期间需要注意的事项。
- [找不到我想用的币种（token），能用别的币付吗？](https://docs.stablepayfi.ai/zh/faq/token-not-found.md)
- [Unsupported currency. Please switch the store currency to USD before proceeding with your payment.（不支持的计价货币）](https://docs.stablepayfi.ai/zh/faq/unsupported-currency.md)
- [We couldn't connect to your wallet.（钱包连接失败）](https://docs.stablepayfi.ai/zh/faq/wallet-connection-failed.md)
- [列表里找不到我的钱包？](https://docs.stablepayfi.ai/zh/faq/wallet-not-found.md)
- [币种与自动货币转换](https://docs.stablepayfi.ai/zh/product/Auto-Currency-Conversion.md): StablePay 的稳定币结算、标价币种、产品支持范围和自动货币转换规则。
- [品牌设置](https://docs.stablepayfi.ai/zh/product/Branding-Settings.md): 在 StablePay Portal 中上传商家 logo 并设置品牌颜色，将品牌元素应用到 StablePay 托管客户页面。
- [收银台展示与 Logo 规范](https://docs.stablepayfi.ai/zh/product/Checkout-Display-Guide--StablePay-Logo.md): 展示 StablePay 和稳定币支付方式的通用规范。
- [合规与可用地区](https://docs.stablepayfi.ai/zh/product/Compliance-and-Regional-Availability.md): StablePay 产品的区域可用性、合规限制和环境说明。
- [企业卡](https://docs.stablepayfi.ai/zh/product/Corporate-Cards.md): 在 StablePay Portal 中创建预算、充值并签发虚拟美元卡，用于团队支出、广告投放与企业日常支出管理。
- [开始使用](https://docs.stablepayfi.ai/zh/product/Get-Started.md): 先完成商户注册，再按 Pay In / Pay Out 选择产品路径，最后完成审核、测试和上线。
- [账单收款](https://docs.stablepayfi.ai/zh/product/Invoicing.md): 通过邮件、PDF 和托管账单页创建并交付稳定币账单。
- [收款链接](https://docs.stablepayfi.ai/zh/product/Payment-Links.md): 用于一次性稳定币收款的可复用托管收款链接。
- [向 StablePay Account 付款](https://docs.stablepayfi.ai/zh/product/Payout-to-StablePay-Account.md): 通过收款邮箱或 8 位 Account No.，将稳定币内部转给另一个 StablePay Account。
- [向钱包付款](https://docs.stablepayfi.ai/zh/product/Payout-to-Wallets.md): 将稳定币从 StablePay 分发到外部钱包地址，用于薪酬、佣金、返利和商家自主管理的出款场景。
- [退款](https://docs.stablepayfi.ai/zh/product/Refunds.md): StablePay 各支付产品共享的退款能力。
- [SaaS 平台集成](https://docs.stablepayfi.ai/zh/product/SaaS-Platform-Integration.md): 通过 StablePay 已提供的 SaaS 平台集成，更快完成店铺收单接入。
- [SHOPYY](https://docs.stablepayfi.ai/zh/product/SaaS/SHOPYY.md)
- [Shopify](https://docs.stablepayfi.ai/zh/product/SaaS/Shopify.md)
- [Shoplazza](https://docs.stablepayfi.ai/zh/product/SaaS/Shoplazza.md)
- [WooCommerce](https://docs.stablepayfi.ai/zh/product/SaaS/WooCommerce.md)
- [稳定币订阅支付](https://docs.stablepayfi.ai/zh/product/StablePay-Stablecoin-Subscription.md): 基于首次钱包授权和后续自动续费的稳定币订阅支付。
- [稳定币收银台](https://docs.stablepayfi.ai/zh/product/Stablecoin-Checkout.md): 用于一次性 USDT / USDC 付款的托管收银台。
- [支持的网络](https://docs.stablepayfi.ai/zh/product/Supported-Networks.md): StablePay 稳定币支付支持的区块链网络。
- [支持的钱包](https://docs.stablepayfi.ai/zh/product/Supported-Wallets.md): StablePay Checkout 和 StablePay Subscriptions Checkout 支持的钱包范围。
- [Telegram 支付通知](https://docs.stablepayfi.ai/zh/product/Telegram-Payment-Notifications.md): 在 StablePay Portal 中自助配置 Telegram Bot 通知，让团队在群组中接收实时支付提醒。

## OpenAPI Specs

- [refund-openapi](https://docs.stablepayfi.ai/en/api/refund-openapi.json)
- [subscription-openapi](https://docs.stablepayfi.ai/en/api/subscription-openapi.json)
- [openapi](https://docs.stablepayfi.ai/en/api/openapi.json)
- [invoice-openapi](https://docs.stablepayfi.ai/en/api/invoice-openapi.json)