> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 核心使用场景

> 最常见 VelaFi 集成的端到端指南：收取本地付款、出金、与稳定币之间的兑换，以及商户入驻。

以下每篇指南都完整介绍一个流程：需要调用哪些接口、需要处理哪些 Webhook、如何处理失败、如何对账，以及上线前需要检查什么。

## 您想构建什么？

> [card] [使用虚拟账户收取本地付款](https://docs.velafi.com/cn/docs/use-cases/collect-with-virtual-accounts.md)
>
> 为每个付款人提供专属的本地收款信息，并将收到的转账入账到您的法币余额。

> [card] [从余额支付本地货币](https://docs.velafi.com/cn/docs/use-cases/payouts-from-balance.md)
>
> 从您的法币余额向本地银行账户付款，并在您的各个商户之间划转余额。

> [card] [将本地货币兑换为稳定币](https://docs.velafi.com/cn/docs/use-cases/convert-to-stablecoins.md)
>
> 通过入金订单将本地货币兑换为 USDT 或 USDC。

> [card] [以稳定币注资支付本地货币](https://docs.velafi.com/cn/docs/use-cases/payouts-funded-by-stablecoins.md)
>
> 卖出余额中的稳定币，并将本地货币支付到收款人的银行账户。

> [card] [将您的客户注册为商户](https://docs.velafi.com/cn/docs/use-cases/onboard-your-customers.md)
>
> 注册您自己的客户，完成 KYC/KYB，并激活其币种账户。

> [card] [跨境支付](https://docs.velafi.com/cn/docs/guides/global-payments.md)
>
> 以一种货币发送法币、以另一种货币交付，以稳定币作为通道。

> [card] [上线检查清单](https://docs.velafi.com/cn/docs/use-cases/go-live-checklist.md)
>
> 适用于所有集成的凭证、Webhook、幂等性、错误处理和对账要求。

## 预先注资还是按单付款？

入金订单有两种付款方式。请在开始构建前做出选择，因为它会改变付款人的付款方式以及订单的失败方式。

| | 预先注资 | 按单付款 |
| - | - | - |
| **工作方式** | 商户的法币余额（待处理资金 / Pending Fund）中已有资金，例如来自向其账户或虚拟账户的充值。VelaFi 从该余额中扣除订单金额。 | 您先创建订单，付款人再按照订单 `paymentInfo` 中返回的付款信息发起银行转账。 |
| **适用于** | 先收款再兑换的平台，以及任何定期或高交易量的流程。 | 无法为付款人保留余额的一次性付款。 |
| **失败方式** | 只要余额足以覆盖订单，失败就很少。请在创建订单前检查余额。 | 如果付款人未在付款时限内付款，订单将过期并被取消（`orderStatus` `70`）。您必须创建新订单并发送新的付款指引。 |

> [!TIP]
>
> 请尽可能使用预先注资模式。预先备好的余额消除了对付款人按时完成转账的依赖，而这正是大多数按单付款失败的根源。

出金也是同样的方式：[从余额出金](https://docs.velafi.com/cn/docs/use-cases/payouts-from-balance.md)从法币余额中支付，[以稳定币注资的出金](https://docs.velafi.com/cn/docs/use-cases/payouts-funded-by-stablecoins.md)则从商户的加密货币余额中支付。

## 组合使用场景

这些流程共用相同的商户余额，因此您可以将它们串联起来：

* **先收款，再兑换。** [使用虚拟账户收款](https://docs.velafi.com/cn/docs/use-cases/collect-with-virtual-accounts.md)到法币余额，然后通过预先注资的入金订单，从该余额[兑换为稳定币](https://docs.velafi.com/cn/docs/use-cases/convert-to-stablecoins.md)。
* **先充值稳定币，再本地出金。** 将 USDT 或 USDC 充值到商户的加密货币钱包（[获取加密货币充值地址](https://docs.velafi.com/cn/api-reference/merchant/get-crypto-deposit-address.md)），然后[以稳定币注资支付本地货币](https://docs.velafi.com/cn/docs/use-cases/payouts-funded-by-stablecoins.md)。
* **先收款，再出金。** 将本地付款收取到法币余额，然后以相同币种[从该余额出金](https://docs.velafi.com/cn/docs/use-cases/payouts-from-balance.md)。
* **先完成入驻。** 如果您服务的是自己的客户，请[将每位客户注册为商户](https://docs.velafi.com/cn/docs/use-cases/onboard-your-customers.md)，再使用该客户的 `merchantId` 运行上述任一流程。

无论构建什么，最后都请完成[上线检查清单](https://docs.velafi.com/cn/docs/use-cases/go-live-checklist.md)。


## Related topics

- [使用 AI 开发](https://docs.velafi.com/cn/docs/developer-tools/build-with-ai.md)
- [Agent Skills](https://docs.velafi.com/cn/docs/developer-tools/agent-skills.md)
- [上线检查清单](https://docs.velafi.com/cn/docs/use-cases/go-live-checklist.md)
- [使用虚拟账户收取本地付款](https://docs.velafi.com/cn/docs/use-cases/collect-with-virtual-accounts.md)
- [从余额支付本地货币](https://docs.velafi.com/cn/docs/use-cases/payouts-from-balance.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.