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

# PSP, agregadores y white label

> Expande tu PSP a nuevos países y métodos de pago locales sin construir cada conexión.

Un proveedor de pagos o agregador que quiere ampliar países y métodos puede apoyarse en Vita sin construir cada conexión local. **Tu cliente ve tu marca; Vita opera por debajo.**

## Flujo

```mermaid theme={null}
sequenceDiagram
  participant Merchant as Comercio final
  participant PSP as Tu PSP
  participant Vita as Vita API
  participant Shopper as Comprador

  Shopper->>PSP: Compra en el checkout del comercio
  PSP->>Vita: GET /payment_methods/{país}
  Vita-->>PSP: Métodos locales disponibles
  PSP->>Vita: GET /payins_prices
  PSP-->>Shopper: Monto final + método
  Shopper->>PSP: Confirma método + datos
  PSP->>Vita: POST /payment_orders/:id/direct_payment
  Vita-->>PSP: Resultado del pago
  PSP->>Vita: POST /transactions (withdrawal al comercio)
  Vita-->>Merchant: Acreditación
  Vita-->>PSP: Webhooks payment / withdrawal
```

## Paso a paso

**1. Cobros con tu propia pantalla**

Usa **Direct Payment**: tu app recoge los datos y los envía a Vita sin redirigir al cliente. `GET /payment_methods/{país}` te dice qué métodos ofrecer en cada mercado.

**2. Calcula lo que cobras**

`GET /payins_prices` devuelve los precios de los métodos para que muestres el monto final al cliente antes de pagar.

**3. Dispersa a tus comercios**

`POST /transactions` con `transactions_type: "withdrawal"` hacia la cuenta de cada comercio o beneficiario.

**4. Informa a tus clientes**

Suscríbete a los webhooks de la categoría **`payment`** para enterarte de cada pago, cancelación o expiración.

## Buenas prácticas

> [!TIP]
>
> Si tu modelo es **multi-cuenta** (una por comercio), crea una empresa por cliente con `POST /business_users`.

> [!WARNING]
>
> **Suscribirte solo a `deposit` no entrega los eventos `payment_order.*`.** Si trabajas pagos online, incluye la categoría `payment` al configurar el webhook.

> [!TIP]
>
> Solicita la **certificación** cuando completes 10 pruebas por endpoint. Es requisito para pasar a producción.

## Endpoints clave

> [card] [Métodos por país](https://docs.vitawallet.io/api-reference/direct-payment/overview.md)
>
> `GET /payment_methods/{country_iso_code}`

> [card] [Direct Payment](https://docs.vitawallet.io/api-reference/direct-payment/overview.md)
>
> `POST /payment_orders/:id/direct_payment`

> [card] [Precios de payins](https://docs.vitawallet.io/api-reference/direct-payment/overview.md)
>
> `GET /payins_prices`

> [card] [Webhooks](https://docs.vitawallet.io/api-reference/webhooks/overview.md)
>
> Categoría `payment`


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