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

# Pagos embebidos en ERP y software de gestión

> Ofrece cobros, pagos y conversión dentro de tu propio producto para todas las empresas que lo usan.

Un ERP o software contable puede ofrecer pagos dentro de su propio producto: cobrar facturas, pagar proveedores y mover dinero entre monedas. Con una sola integración sirves a **todas las empresas que usan tu software**.

## Flujo

```mermaid theme={null}
sequenceDiagram
  participant ERP as Tu ERP
  participant Vita as Vita API
  participant Customer as Cliente del ERP
  participant Supplier as Proveedor

  ERP->>Vita: POST /business_users (por cada empresa)
  Vita-->>ERP: business_user verificado
  ERP->>Vita: POST /payment_orders (factura N°)
  Vita-->>Customer: Checkout con método local
  Customer->>Vita: Paga
  Vita-->>ERP: Webhook payment_order.paid
  ERP->>ERP: Marca factura como pagada
  ERP->>Vita: POST /transactions (withdrawal, order=factura_id)
  Vita-->>Supplier: Pago en moneda local
  Vita-->>ERP: Webhook transaction.completed
  ERP->>ERP: Conciliación automática en libro contable
```

## Paso a paso

**1. Una integración, muchas empresas**

Da de alta a cada empresa cliente con `POST /business_users`. Cada una queda verificada y con su propio saldo.

**2. Cobra una factura**

Crea una orden por factura con `POST /payment_orders`, usando el **número de factura** como `order` en tu sistema. El cliente paga con su método local.

**3. Paga a proveedores**

Desde el módulo financiero, `POST /transactions` con `transactions_type: "withdrawal"`: una orden de pago por proveedor y por factura.

**4. Registra el movimiento**

Con webhooks marca la factura como pagada y concilia automáticamente en el libro contable.

## Buenas prácticas

> [!TIP]
>
> **Guarda el `order` igual al identificador del documento en tu ERP** (número de factura o de orden de pago). Facilita la conciliación y hace el `order` legible para auditoría.

> [!TIP]
>
> Consulta saldos con `GET /wallets/{uuid}` para **mostrar disponibilidad dentro del software** antes de que el usuario intente pagar.

> [!TIP]
>
> Usa la [colección Postman](https://docs.vitawallet.io/postman.md) para que tu equipo pruebe la integración antes de programar.

## Endpoints clave

> [card] [Crear usuario (empresa)](https://docs.vitawallet.io/api-reference/users-creation/overview.md)
>
> `POST /business_users`

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

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

> [card] [Saldo de wallet](https://docs.vitawallet.io/api-reference/user-information/overview.md)
>
> `GET /wallets/{uuid}`


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