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

# Gestão de Tesouraria com Conversão Fiat para Stablecoin

> Converta fundos da empresa entre fiat e stablecoins para operações de tesouraria — rendimento, liquidação mais rápida ou estratégia multi-moeda.

Use o SpherePay para gerenciar a tesouraria da sua empresa convertendo entre USD e stablecoins. Isso permite que você mantenha fundos em stablecoins para rendimento, liquidação mais rápida ou como parte de uma estratégia de tesouraria multi-moeda.

## Visão geral

A gestão de tesouraria com o SpherePay envolve três movimentos:

1. **On-ramp** — Converter USD da sua conta bancária para USDC ou USDT.
2. **Off-ramp** — Converter stablecoins de volta para USD quando fiat é necessário.
3. **Monitoramento** — Rastrear saldos e status de transferência em ambos os rails.

```mermaid theme={"dark"}
flowchart LR
    BA["Company<br/>bank account"] -->|On-ramp (USD → USDC)| SP["SpherePay"]
    SP -->|USDC| W["Company<br/>wallet"]
    W -->|Off-ramp (USDC → USD)| SP
    SP -->|USD| BA
```

## Transações próprias (first-party)

As operações de tesouraria são tipicamente **transações próprias (first-party)** — você está movendo fundos em nome da sua própria entidade legal, não de terceiros.

<Info>
  Transações próprias ainda requerem verificação KYB. Complete a [verificação empresarial](/pt-BR/concepts/onboarding/business-kyb) para sua empresa antes de executar transferências.
</Info>

## Opções de implementação

### Opção 1 — Transferências manuais via API

Melhor para conversões avulsas com base nas condições de mercado ou necessidades de caixa.

```bash theme={"dark"}
# Convert $10,000 USD to USDC on Solana
curl -X POST https://api.spherepay.co/v2/transfer \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "10000.00",
    "customer": "customer_your_company",
    "source": {
      "type": "bank_account",
      "id": "bankAccount_xxx",
      "currency": "usd",
      "network": "ach"
    },
    "destination": {
      "type": "wallet",
      "id": "wallet_xxx",
      "currency": "usdc",
      "network": "sol"
    }
  }'
```

### Opção 2 — Contas virtuais para on-ramp automatizado

Melhor para depósitos regulares que devem converter automaticamente para stablecoins.

1. [Crie um Onramper Account](/pt-BR/concepts/automation/onramper-accounts) vinculado ao seu cliente.
2. Faça wire de fundos para os dados bancários da conta virtual.
3. O SpherePay converte automaticamente os depósitos para stablecoins.

### Opção 3 — Offloader Wallet para off-ramp automatizado

Melhor para pagamentos em stablecoin que devem converter automaticamente para fiat.

1. [Crie um Offloader Wallet](/pt-BR/concepts/automation/offloader-wallets) vinculado ao seu cliente.
2. Envie stablecoins para o endereço do Offloader Wallet.
3. O SpherePay converte automaticamente para USD e deposita no seu banco.

## Exemplo — fluxo de tesouraria de ida e volta

### Etapa 1 — On-ramp (USD → USDC)

```bash theme={"dark"}
curl -X POST https://api.spherepay.co/v2/transfer \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "50000.00",
    "customer": "customer_your_company",
    "source": {
      "type": "bank_account",
      "id": "bankAccount_xxx",
      "currency": "usd",
      "network": "wire"
    },
    "destination": {
      "type": "wallet",
      "id": "wallet_xxx",
      "currency": "usdc",
      "network": "ethereum"
    }
  }'
```

### Etapa 2 — Manter e gerenciar USDC

Armazene USDC na sua carteira registrada. Você pode:

* Transferir entre carteiras em diferentes redes.
* Enviar para endereços externos.
* Monitorar saldos via dashboard ou API.

### Etapa 3 — Off-ramp (USDC → USD)

Quando você precisar de fiat:

```bash theme={"dark"}
curl -X POST https://api.spherepay.co/v2/transfer \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "25000.00",
    "customer": "customer_your_company",
    "source": {
      "type": "wallet",
      "id": "wallet_xxx",
      "currency": "usdc",
      "network": "ethereum"
    },
    "destination": {
      "type": "bank_account",
      "id": "bankAccount_xxx",
      "currency": "usd",
      "network": "wire"
    }
  }'
```

## Monitoramento e relatórios

### Via dashboard

1. Navegue até **Transferências** para visualizar todos os movimentos de tesouraria.
2. Filtre para mostrar apenas as transações da sua empresa.
3. Exporte relatórios para contabilidade.

### Via API

```bash theme={"dark"}
# Get all transfers for your company
curl "https://api.spherepay.co/v2/transfer?customer=customer_your_company" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Boas práticas

* **Use registros de cliente dedicados.** Crie um cliente separado para tesouraria versus operações voltadas ao cliente para manter os relatórios limpos.
* **Consulte o status.** Use `GET /v2/transfer/{id}` para verificar o status de transferência e depósito.
* **Planeje para os tempos de liquidação.** ACH leva 1–2 dias úteis; wires são no mesmo/próximo dia.
* **Pré-financie para necessidades de liquidez.** Se você precisar de fiat em um dia específico, faça o off-ramp antes do prazo em vez de no momento da necessidade.

## Relacionados

<CardGroup cols={2}>
  <Card title="API de Transferências" icon="arrow-right-left" href="/pt-BR/concepts/transfers/overview">
    Referência completa de criação e rastreamento de transferências.
  </Card>

  <Card title="Onramper Accounts" icon="landmark" href="/pt-BR/concepts/automation/onramper-accounts">
    On-ramp automatizado via contas bancárias virtuais.
  </Card>

  <Card title="Offloader Wallets" icon="wallet" href="/pt-BR/concepts/automation/offloader-wallets">
    Off-ramp automatizado a partir de um endereço de carteira dedicado.
  </Card>

  <Card title="KYB Empresarial" icon="building" href="/pt-BR/concepts/onboarding/business-kyb">
    Requisitos de KYB para operações de tesouraria.
  </Card>
</CardGroup>