# 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` 获取退款详情，包含当前状态、链上交易哈希、失败原因等完整信息。
- [集成前准备](https://docs.stablepayfi.ai/zh/api/getting-started.md): 集成 StablePay API 前需要了解的基础信息：API Key 获取、请求签名、Webhook 通知与安全建议。
- [币种与自动货币转换](https://docs.stablepayfi.ai/zh/product/Auto-Currency-Conversion.md): 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/Get-Started.md): 选择适合你业务场景的 StablePay 产品。
- [账单收款](https://docs.stablepayfi.ai/zh/product/Invoicing.md): 通过邮件、PDF 和托管账单页创建并交付稳定币账单。
- [支付链接](https://docs.stablepayfi.ai/zh/product/Payment-Links.md): 用于一次性稳定币收款的可复用托管支付链接。
- [限制 Payment Link 的支付次数](https://docs.stablepayfi.ai/zh/product/Payment-Links-Limit-Payment-Count.md): 设置 Payment Link 可被成功支付的次数上限，并在达到上限后自动停用。
- [Payment Links 多标价币种](https://docs.stablepayfi.ai/zh/product/Payment-Links-Multi-Currency-Pricing.md): 使用支持的本地法币为 Payment Links 进行统一标价，并在创建与管理流程中保持一致的币种规则。
- [退款](https://docs.stablepayfi.ai/zh/product/Refunds.md): StablePay 各支付产品共享的退款能力。
- [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 支持的钱包范围。

## 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)