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

# Financiamento de Comércio Internacional

> Liquide faturas e recebíveis internacionais em diferentes moedas usando stablecoins como ponte — para importadores, exportadores e plataformas de trade finance.

Fluxos de trade finance movem dinheiro entre fronteiras contra faturas, ordens de compra ou recebíveis. Os rails tradicionais — wires internacionais, bancos correspondentes, cartas de crédito — são lentos, opacos e caros. Usar stablecoins como camada de liquidação reduz os tempos de liquidação de dias para minutos e oferece visibilidade on-chain completa para ambas as partes.

Este guia cobre o padrão de integração para pagamentos importador–exportador, financiamento de fornecedores e plataformas de recebíveis B2B.

## Como funciona

O fluxo é um sanduíche de duas pernas: fiat de um lado, fiat do outro, stablecoins como ponte.

```mermaid theme={"dark"}
flowchart LR
    SB["Importer<br/>bank (origin)"] -->|"USD ACH / Wire"| SP["SpherePay<br/>on-ramp"]
    SP -->|USDC| BC["Blockchain<br/>(near-instant)"]
    BC -->|USDC| LO["Local off-ramp<br/>(destination)"]
    LO -->|Local fiat| RB["Exporter<br/>bank (destination)"]
```

O SpherePay cuida da conversão USD ↔ USDC. Onde os rails fiat do SpherePay alcançam (USD, EUR, BRL), a segunda perna também é um off-ramp do SpherePay. Para outros corredores, você (ou seu parceiro) cuida do off-ramp de fiat local no país de destino.

## Por que liquidação em stablecoin para trade finance

| Banco correspondente tradicional       | Liquidação em stablecoin                    |
| -------------------------------------- | ------------------------------------------- |
| 3–5 dias úteis                         | Minutos on-chain + liquidação fiat local    |
| \$25–50 em tarifas de wire + spread FX | Tarifas on-chain transparentes + FX à vista |
| Taxas de câmbio e roteamento opacos    | Trilha pública na blockchain                |
| Visibilidade limitada sobre o status   | Rastreamento de ponta a ponta               |

Para trade finance especificamente:

* **Plataformas de recebíveis** podem liquidar faturas a fornecedores em minutos em vez de dias, reduzindo o DSO.
* **Importadores** obtêm precificação FX previsível — a perna de stablecoin é on-chain e cotável com antecedência.
* **Exportadores** podem optar por manter USDC para flexibilidade de tesouraria em vez de converter automaticamente para fiat local.

## Cobertura atual

O SpherePay cuida de ponta a ponta onde ambas as pernas chegam em rails fiat suportados:

* ✅ USD ACH e Wire (EUA)
* ✅ EUR SEPA (UE)
* ✅ BRL PIX (Brasil)
* ✅ Transferências de stablecoin entre carteiras (USDC, USDT, EURC nas redes suportadas)

Para corredores fora desses rails (ex.: GBP, MXN, INR), você precisará de um parceiro local para o off-ramp de destino. O SpherePay cuida do on-ramp + perna de stablecoin; o parceiro converte USDC para a moeda local.

## Padrão de implementação

### Etapa 1 — On-ramp (lado do importador)

Converta o fiat do importador para 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": "100000.00",
    "customer": "customer_importer",
    "source": {
      "type": "bank_account",
      "id": "bankAccount_importer",
      "currency": "usd",
      "network": "wire"
    },
    "destination": {
      "type": "wallet",
      "id": "wallet_settlement",
      "currency": "usdc",
      "network": "sol"
    }
  }'
```

### Etapa 2 — Transferência de stablecoin (perna de liquidação)

Mova USDC para a carteira do exportador (ou a carteira de liquidação do seu parceiro). Esta é uma transferência on-chain padrão — envie USDC diretamente da sua carteira de liquidação usando sua infraestrutura de carteira preferida.

### Etapa 3 — Off-ramp (lado do exportador)

Se o exportador tiver conta bancária nos EUA, UE ou Brasil, use o SpherePay para converter de volta para fiat local:

```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": "100000.00",
    "customer": "customer_exporter",
    "source": {
      "type": "wallet",
      "id": "wallet_exporter",
      "currency": "usdc",
      "network": "sol"
    },
    "destination": {
      "type": "bank_account",
      "id": "bankAccount_exporter",
      "currency": "eur",
      "network": "sepa"
    }
  }'
```

Para outros corredores, repasse para seu parceiro local.

## Exemplo detalhado — plataforma de recebíveis

Para uma plataforma de recebíveis comerciais liquidando faturas de fornecedores:

```javascript theme={"dark"}
async function settleInvoice(buyerId, supplierCountry, invoiceAmount) {
  // 1. On-ramp buyer USD → USDC
  const onRamp = await createTransfer({
    amount: invoiceAmount,
    customer: buyerId,
    source: {
      type: "bank_account",
      id: buyerBankAccount,
      currency: "usd",
      network: "wire",
    },
    destination: {
      type: "wallet",
      id: settlementWallet,
      currency: "usdc",
      network: "sol",
    },
  });

  await waitForTransfer(onRamp.id);

  // 2. Route USDC to destination
  if (supplierCountry === "BR") {
    // SpherePay can off-ramp BRL directly
    return createTransfer({
      amount: invoiceAmount,
      customer: supplierId,
      source: { type: "wallet", id: settlementWallet, currency: "usdc", network: "polygon" },
      destination: { type: "bank_account", id: supplierBrlBank, currency: "brl", network: "pix" },
    });
  } else {
    // Hand off to local partner for unsupported corridors
    const partnerWallet = getPartnerWallet(supplierCountry);
    await sendOnChain(settlementWallet, partnerWallet, invoiceAmount);
    await notifyPartner(supplierCountry, invoiceAmount);
  }
}
```

## Requisitos de conformidade

### Lado originador

* **Verificação KYC/KYB** — Todas as empresas originadoras devem completar [KYB](/pt-BR/concepts/onboarding/business-kyb); pessoas físicas requerem [KYC](/pt-BR/concepts/onboarding/individual-kyc).
* **Documentação de origem dos fundos** — Exigida para pagamentos comerciais maiores; colete faturas comerciais, POs ou contratos comerciais.

### Lado receptor

* **Regulamentos locais** — Qualquer parceiro terceiro deve cumprir as leis de transmissão de dinheiro do país de destino.
* **KYC/AML sobre o destinatário** — Conforme requisitos locais.
* **Relatório cross-border** — Mantenha registros conforme exigido por ambas as jurisdições.

## Boas práticas

* **Escolha a rede certa.** Solana e Base oferecem as taxas mais baixas e finalidade mais rápida. Ethereum é melhor para contrapartes institucionais que já custodiam USDC lá.
* **Bloqueie o FX com antecedência.** Para valores faturados, cotar e bloquear a taxa de câmbio antes de iniciar o on-ramp torna a margem previsível.
* **Construa redundância de parceiros.** Tenha parceiros de off-ramp alternativos para cada país de destino caso as rotas primárias estejam indisponíveis.
* **Rastreie de ponta a ponta.** Consulte o status de transferência e combine com monitoramento de blockchain para visibilidade completa desde o wire do importador até o depósito do exportador.
* **Reconcilie com faturas.** Mantenha um mapeamento entre documentos comerciais (número de fatura, PO) e IDs de transferência.

## Roadmap

O SpherePay está expandindo ativamente os rails internacionais — acompanhe o [Changelog](/pt-BR/changelog) para corredores fiat adicionais, transferências cross-currency em uma única chamada e integrações diretas de trade finance.

## 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="Trading" icon="refresh-cw" href="/pt-BR/solutions/trading">
    Tutoriais por corredor (BRL ↔ USD, USD ↔ EUR) com o padrão Offloader Wallet para liquidação em uma chamada.
  </Card>

  <Card title="Onboarding" icon="user-check" href="/pt-BR/concepts/onboarding/overview">
    Requisitos de KYC/KYB para ambas as pernas.
  </Card>

  <Card title="Rails suportados" icon="globe" href="/pt-BR/concepts/transfers/supported-rails">
    Compatibilidade de moeda, rede e rail.
  </Card>
</CardGroup>
