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

# Comercio exterior y tesorería B2B

> Cobra, convierte y paga grandes montos entre países con trazabilidad para auditoría contable.

Importadores, exportadores, portuarios, bancos y mesas de dinero mueven montos grandes entre países. Necesitan pagar a proveedores en otra moneda, cobrar de clientes del exterior y convertir entre dólares y cripto **con trazabilidad completa**.

## Flujo

```mermaid theme={null}
sequenceDiagram
  participant Importer as Importador
  participant Vita as Vita API
  participant Supplier as Proveedor del exterior

  Importer->>Vita: POST /payment_orders (cobro de cliente)
  Vita-->>Importer: payment_url
  Importer->>Vita: GET /prices (fijar tasa)
  Note over Importer,Vita: Ejecuta antes de valid_until
  alt Pago bancario
    Importer->>Vita: POST /transactions (withdrawal)
  else Pago en stablecoin
    Importer->>Vita: POST /transactions (crypto_payout)
  end
  Vita-->>Supplier: Acreditación
  Importer->>Vita: GET /transactions/:id (trazabilidad)
```

## Paso a paso

**1. Cobra de tu cliente**

Crea una orden con `POST /payment_orders` en la moneda local del pagador. El monto queda en tu wallet.

**2. Fija la tasa**

`GET /prices` (fiat) o `GET /crypto_prices` (cripto) según el caso. La tasa tiene `valid_until`: **ejecuta antes de que venza** para no revalidar.

**3. Paga al proveedor del exterior**

`POST /transactions` con `transactions_type: "withdrawal"` a su cuenta bancaria, o `crypto_payout` si prefiere stablecoin.

**4. Deja trazabilidad**

`GET /transactions/:id` entrega el detalle de cada operación con `included.withdrawal` completo para auditoría y conciliación contable.

## Buenas prácticas

> [!TIP]
>
> **Registra tu propia referencia en `order`** (número de factura o de importación). Esto convierte el `order` en tu puente entre la API y tu contabilidad.

> [!NOTE]
>
> Algunas transacciones B2B requieren **documentación adicional de respaldo** (factura comercial, DJAI, etc.). Tenlo listo antes de ejecutar el payout.

> [!TIP]
>
> Para saldos grandes, revisa el saldo con `GET /wallets/{uuid}` **antes** de disparar el payout. Evita rechazos innecesarios.

## Endpoints clave

> [card] [Crear payin](https://docs.vitawallet.io/api-reference/payins/overview.md)
>
> `POST /payment_orders`

> [card] [Precios](https://docs.vitawallet.io/api-reference/vita-sent/overview.md)
>
> `GET /prices` / `GET /crypto_prices`

> [card] [Payout](https://docs.vitawallet.io/api-reference/bank-payouts/create-payout.md)
>
> `POST /transactions` con `transactions_type: "withdrawal"`

> [card] [Detalle de transacción](https://docs.vitawallet.io/api-reference/transactions/overview.md)
>
> `GET /transactions/:id`


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