> For the complete documentation index, see [llms.txt](https://nextcommerce.gitbook.io/nextcommerce-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nextcommerce.gitbook.io/nextcommerce-docs/05-formas-pago.md).

# Formas de Pago

La sección de **Medios de Pago** te permite configurar las opciones de pago disponibles para tus clientes durante el proceso de checkout.

***

## Vista General

El listado de medios de pago se organiza en tres pestañas:

* **Todos**: Muestra todos los métodos configurados
* **Activos**: Métodos habilitados para el checkout
* **Inactivos**: Métodos deshabilitados

### Columnas del Listado

| Columna               | Descripción                   |
| --------------------- | ----------------------------- |
| **Nombre**            | Nombre del medio de pago      |
| **Descripción**       | Descripción breve             |
| **Recargo/Descuento** | Porcentaje de ajuste          |
| **Proveedor**         | Proveedor de pago (si aplica) |
| **Estado**            | Activo / Inactivo             |
| **Acciones**          | Botones de acción             |

***

## Funciones Principales

### Barra de Herramientas

* **🔍 Buscar**: Busca métodos por nombre o descripción
* **➕ Agregar medio de pago**: Crea un nuevo método

***

## Crear Medio de Pago

Para crear un nuevo medio de pago:

1. Haz clic en **➕ Agregar medio de pago**
2. Completa la información:

### Configuración Principal

| Campo           | Descripción                | Requerido |
| --------------- | -------------------------- | --------- |
| **Nombre**      | Nombre que verá el cliente | ✅ Sí      |
| **Descripción** | Información adicional      | No        |

### Instrucciones para el Cliente

El campo **"Instrucciones para tu cliente, una vez realizada la compra"** permite agregar texto que se mostrará después del checkout.

**Usos comunes:**

* Datos bancarios para transferencia
* Número de cuenta para depósito
* Alias CBU/CVU
* Instrucciones para pago en efectivo
* Información de Mercado Pago/otros

**Ejemplo para Transferencia:**

```
Realizá la transferencia a:
Banco: Banco Nación
Titular: Mi Empresa SA
CBU: 0000003100000000000000
Alias: TIENDA.ONLINE

Una vez realizada, envianos el comprobante por WhatsApp al 11-1234-5678
```

### Recargo

Si necesitas aplicar un recargo por este medio de pago:

| Campo         | Descripción                   |
| ------------- | ----------------------------- |
| **Recargo %** | Porcentaje a agregar al total |

**Ejemplo**: Un recargo del 10% en una compra de $10,000 resultará en $11,000.

> **💡 Tip**: El recargo se aplica DESPUÉS de calcular subtotal, descuentos, envío e IVA.

### Descuento

Si quieres ofrecer un descuento por usar este medio:

| Campo           | Descripción                         |
| --------------- | ----------------------------------- |
| **Descuento %** | Porcentaje a descontar del subtotal |

**Ejemplo**: Un descuento del 10% en una compra de $10,000 resultará en $9,000.

### Combinar con Promociones

| Opción                | Descripción                                                  |
| --------------------- | ------------------------------------------------------------ |
| **Permitir combinar** | ✅ El descuento del medio de pago se suma a otras promociones |

Si está desactivado, el descuento del medio de pago NO se aplica si ya hay otra promoción activa.

### Proveedor de Pago

Selecciona un proveedor si el medio de pago está integrado con una pasarela. El selector muestra los proveedores que tengas creados en **Configuración > Proveedores de Pago** (o **Sin proveedor** para pagos manuales/offline).

| Tipo de pasarela | Descripción                                                                                       |
| ---------------- | ------------------------------------------------------------------------------------------------- |
| **Mercado Pago** | Único gateway soportado actualmente. Requiere Public Key, Access Token, Client ID y Client Secret |

> **Nota**: el selector puede mostrar otras opciones (PayPal, Stripe), pero por el momento **solo Mercado Pago está operativo**.

> **💡 Tip**: Los proveedores deben estar previamente configurados en la sección de Proveedores de Pago para poder vincularlos a un medio de pago.

### Ordenamiento

| Campo                      | Descripción                       |
| -------------------------- | --------------------------------- |
| **Orden de visualización** | Posición en la lista del checkout |
| **Medio de pago activo**   | ✅ Habilita el método              |

***

## Ejemplos de Configuración

### Transferencia Bancaria

* **Nombre**: "Transferencia bancaria"
* **Descripción**: "10% de descuento"
* **Descuento**: 10%
* **Combinar con promociones**: No
* **Proveedor**: Sin proveedor
* **Instrucciones**: Datos de la cuenta bancaria

### Mercado Pago

* **Nombre**: "Mercado Pago"
* **Descripción**: "Tarjetas de crédito y débito"
* **Recargo**: 5% (para cubrir comisiones)
* **Proveedor**: Mercado Pago
* **Instrucciones**: (No necesario, redirect automático)

### Efectivo

* **Nombre**: "Efectivo al retirar"
* **Descripción**: "Pago al retirar en local"
* **Descuento**: 5%
* **Proveedor**: Sin proveedor
* **Instrucciones**: "Abonás cuando retirés tu pedido en nuestro local"

### Pago contra entrega

* **Nombre**: "Pago al recibir"
* **Descripción**: "Abonás cuando llega el pedido"
* **Recargo**: 3%
* **Proveedor**: Sin proveedor

***

## Editar Medio de Pago

Para editar un método existente:

1. Haz clic en el botón **✏️ Editar**
2. Modifica los campos necesarios
3. Haz clic en **Guardar**

***

## Activar/Desactivar Método

Para cambiar el estado de un medio de pago:

1. Edita el método
2. Activa o desactiva "Medio de pago activo"
3. Guarda los cambios

Los métodos inactivos NO aparecen en el checkout pero se conservan en el sistema.

***

## Eliminar Medio de Pago

Para eliminar un método:

1. Haz clic en el botón **🗑️ Eliminar**
2. Confirma la acción

> **⚠️ Advertencia**: Eliminar un medio de pago NO afecta órdenes históricas, pero el método ya no estará disponible.

***

## Proveedores de Pago

Los proveedores de pago son las pasarelas que procesan las transacciones. Se configuran en una sección separada (**Configuración > Proveedores de Pago**).

### Vincular un Proveedor

1. Primero configura el proveedor con sus credenciales
2. Al crear/editar un medio de pago, selecciónalo del dropdown
3. Los pagos se procesarán automáticamente por la pasarela

### Obtener las credenciales de Mercado Pago

Para configurar Mercado Pago como proveedor de pagos, necesitás generar las credenciales de integración desde tu cuenta de Mercado Pago:

1. Logueate en Mercado Pago con la cuenta a integrar.
2. Ingresá a <https://www.mercadopago.com.ar/developers/es>.
3. Seleccioná **Integraciones** (arriba a la derecha).
4. Hacé clic en el botón azul **Crear aplicación**.
5. Completá el nombre de la aplicación como `WebNextCommerce`.
6. Elegí el tipo de pago a integrar: seleccioná **Pagos online**, luego **Plataforma propia**, ingresá la URL de tu página y continuá.
7. Entre las opciones disponibles, seleccioná **Checkout Pro** y continuá.
8. Tildá los consentimientos y confirmá.
9. Con la aplicación creada, en el menú lateral izquierdo ingresá a **Credenciales de Producción**.
10. Seleccioná la industria, ingresá la URL de tu web, tildá el consentimiento y presioná **Activar credenciales de producción**.
11. Esperá a que se activen y copiá los siguientes valores para compartirlos con NextCommerce:
    * **Public Key**
    * **Access Token**
    * **Client ID**
    * **Client Secret**

> **🔒 Seguridad**: compartí estas credenciales solo por un canal seguro acordado con el equipo de NextCommerce. No las publiques ni las envíes por canales abiertos.

***

## Mejores Prácticas

### Variedad de Opciones

Ofrece múltiples medios de pago para maximizar conversiones:

* ✅ Tarjetas de crédito/débito
* ✅ Transferencia bancaria
* ✅ Efectivo (si hay retiro en local)
* ✅ Billeteras digitales (Mercado Pago, etc.)

### Transparencia en Costos

* Indica claramente si hay recargos
* Destaca los descuentos disponibles
* Explica bien las instrucciones post-compra

### Orden Estratégico

Ordena los medios de pago de más conveniente a menos:

1. Opciones con descuento primero
2. Opciones online/automáticas
3. Opciones manuales al final

### Seguridad

* Usa pasarelas de pago reconocidas
* No solicites datos de tarjeta directamente
* Mantén actualizadas las credenciales de los proveedores

### Instrucciones Claras

Para pagos manuales, incluye:

* Todos los datos necesarios
* Pasos a seguir
* Medio de contacto para confirmar
* Plazos para realizar el pago

***

## Proveedores de pago (pasarelas)

Los **Proveedores de pago** son las pasarelas que procesan realmente los cobros (por ejemplo, Mercado Pago, Stripe, PayPal, etc.). Se configuran en una sección aparte y luego se vinculan a los **Medios de pago** que ve el cliente en el checkout.

### Dónde se configura

* Menú lateral: **Configuración > Proveedores de pago**.

### Qué se configura

Para cada proveedor:

* **Nombre interno** y descripción.
* **Tipo de gateway** (Mercado Pago, PayPal, Stripe u otro según tu tienda).
* **Credenciales**:
  * Claves públicas / privadas.
  * Tokens de acceso.
  * URLs de éxito / error (si aplica).
* **Estado**:
  * Habilitado / deshabilitado.

Una vez configurado el proveedor:

1. Volvé a **Formas de Pago**.
2. Editá un medio de pago.
3. En el campo **Proveedor de Pago**, elegí el proveedor correspondiente.

De esta forma, cuando el cliente selecciona ese medio de pago, la transacción se procesa automáticamente a través de la pasarela configurada.

> **Recomendación**: probá siempre un pago real (de bajo monto) después de configurar un proveedor, para validar que las credenciales y callbacks funcionen correctamente.

***