在 Stellar 上收款
Cosmos Pay 为每笔支付生成带二维码的 SEP-7 链接。客户用自己的 Stellar 钱包付款，款项直接进入您的地址。
Stellar 上的支付如何运作
- 支付链接
- 带二维码的 SEP-7 链接（web+stellar:pay）。来自已知账户的付款也可以改为携带预先构建的交易（web+stellar:tx）。
- 可付款的钱包
- 任何能打开 SEP-7 链接的钱包。托管收银台还可以在 Cosmos Pay Wallet 扩展程序或其网页钱包中打开付款。
- Cosmos Pay Wallet
Freighter
LOBSTR
xBull
Albedo
Rabet
- 如何匹配
- 链接上的 memo，即数字型 MEMO_ID。打开链接的钱包会自动添加；手动发送的付款也必须带上它。
- 款项去向
- 网络确认付款后直接进入您的 Stellar 地址：约 5 秒。
- 测试网络
- 使用测试密钥（dv_）时为 Stellar Testnet；使用正式密钥（prod_）时为公共网络。
预设资产
控制台按名称提供以下资产。其他 Stellar 资产按资产代码和发行方指定。
| 资产 | 发行方 | 环境 |
|---|---|---|
| XLM | 网络原生币 | Mainnet |
| USDCCircle | GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN | Mainnet |
| USDT0Tether | GATISXX6BZ6NC7IKQBY37CJD4SOZL3CYZJWXEDG6JVIY4WBS6KXJHN6Q | Mainnet |
| EURCCircle | GDHU6WRG4IEQXM5NZ4BMPKOXHW76MZM4Y2IEMFDVXBSDP6SJY4ITNPP2 | Mainnet |
| XLM | 网络原生币 | Testnet |
| USDCCircle | GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5 | Testnet |
| USDBBlindPay | GCQSSIMOW5OCGULZATDXKU5MOJBOMFX6G65X6CXZDQ7AIB3SKFUZ67NX | Testnet |
curl https://api.cosmospay.lat/cosmos-api/v1/payment-intents/pay \ -H "Authorization: Bearer $COSMOS_PAY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "chain": "stellar", "destination": "G…YOUR_STELLAR_ACCOUNT", "amount": "25", "assetCode": "USDC", "assetIssuer": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN", "msg": "Order #1001" }'测试密钥（dv_）会在 Testnet 上创建链接：请使用上表中 Testnet 的 USDC 发行方，或省略 assetCode 和 assetIssuer 以 XLM 收款。
哪些钱包可以支付 Stellar 支付链接？
任何能打开 SEP-7 链接的钱包，例如 Freighter、xBull、Rabet、LOBSTR、Albedo 或 Cosmos Pay Wallet，都可以支付 Stellar 上的 Cosmos Pay 支付链接。托管收银台还可以在 Cosmos Pay Wallet 扩展程序或其网页钱包中打开这笔付款；在电脑上，客户也可以用手机钱包扫描二维码。客户无需注册账户：Stellar 网络手续费由其钱包支付，款项直接进入您的 Stellar 地址。
为什么 Stellar 付款要带 memo？
Cosmos Pay 依靠链接的 memo（一个数字 MEMO_ID）将每笔 Stellar 付款与其支付链接匹配。打开 SEP-7 链接的钱包（无论是点击还是扫描二维码）会自动添加 memo。手动发送的付款也需要带上同一个 memo：没有它，Cosmos Pay 就无法将付款与链接匹配。网络确认带有正确 memo 的付款后（在 Stellar 上约 5 秒），收银台状态变为“已支付”，您的 webhook 随即触发。
可以在 Stellar 上用 USDC 或 EURC 收款吗？
可以。在 Stellar 公共网络上，Cosmos Pay 按名称提供 Circle 的 USDC 和 EURC，另有 XLM 和 Tether 的 USDT0；Stellar Testnet 上的 USDC 也是预设资产。其他 Stellar 资产在创建链接时按资产代码和发行方指定。客户以链接设定的资产付款，网络确认后，同一资产会进入您的 Stellar 地址：约 5 秒。
如何在不使用真实资金的情况下测试 Stellar 付款？
在 Cosmos Pay 控制台创建测试 API 密钥（dv_），或在控制台中选择“沙箱”：支付链接随即在 Stellar Testnet 上运行，收银台会注明不涉及真实资金。您可以用预设发行方的 Testnet USDC 收款，也可以用 XLM 收款，Testnet 的水龙头 Friendbot 可为测试账户充入 XLM。之后，生产 API 密钥（prod_）会在 Stellar 公共网络上创建同样的链接：网络由密钥决定，而不是由代码决定。
可以在 Stellar 付款上加收自己的费用吗？
可以。Cosmos Pay 可以在 Stellar 付款上加收您自己的费用，支付到您选择的收费钱包；这笔费用独立于您的套餐费率，每笔付款仍按套餐费率计费。SEP-7 支付链接只能向一个账户付款，因此带有您费用的链接会请付款方提供其 Stellar 账户，并构建一笔预先准备的交易（web+stellar:tx），同时向您和您的收费钱包付款。付款方在钱包中确认这一笔交易即可。
Stellar 付款的金额可以保密吗？
可以，使用 Cosmos Pay 的隐私支付：网络验证零知识证明，而不读取金额，因此金额在链上保持私密。隐私支付运行在 Stellar 上，基于 OpenZeppelin 为 Stellar 打造的保密代币，目前仅在 Testnet 提供；Solana 和 Monad 上的付款不提供隐私支付。每笔隐私支付按交易收费 0.18%，所有套餐相同。
