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

# Activar un método de pago

> Activa un método de pago para un merchant: credenciales, entorno, reglas y dónde aplica.

Activar un método crea un **pago** para tu merchant. El catálogo de proveedores y métodos es el mismo para todos los merchants; tu pago guarda tus credenciales y tus reglas.

## Antes de empezar

* Un rol del dashboard que pueda administrar pagos.
* El método debe figurar como disponible en [Métodos de pago soportados](https://firespark.cloud/docs/es/integrations/payments/index.md).
* Para proveedores distintos del efectivo: un contrato con el proveedor y las credenciales que te entregó. La página de cada método lista los campos exactos.

## Crear el pago

**1. Abre Payments**

En el dashboard, abre tu merchant, entra a **Payments** y crea un pago nuevo.

**2. Elige la integración**

Elige el proveedor y el método.

**3. Completa la conexión**

Llena los campos que pide el método. Los campos secretos (claves privadas, firmas de webhook y cualquier campo cuyo nombre empiece con `secret_`) se guardan en Fire spark y nunca se envían a apps, web ni kioscos.

**4. Define la disponibilidad**

Elige las tiendas, canales y tipos de fulfillment donde aplica el método, y las condiciones de monto.

## Ajustes opcionales

Estas claves sirven para cualquier método. Si no las pones, se usan los valores por defecto.

| Ajuste | Qué hace |
| - | - |
| `provider_environment` | `sandbox` o `production`. Por defecto sigue el entorno del merchant: los merchants de producción usan la producción del proveedor y el resto usa sandbox. |
| `runtime.timeout_ms` | Cuánto esperar al proveedor antes de tratar el intento como desconocido. |
| `runtime.interaction_timeout_ms` | Cuánto esperar al cliente en cada pregunta del terminal. |
| `runtime.max_attempts` | Reintentos para errores reintentables (de 1 a 10). |
| `runtime.qr_ttl_ms` | Cuánto dura un QR o un pago de billetera pendiente. |
| `runtime.batch_close_at` | Hora diaria del cierre de lote del terminal, `HH:MM`. |
| `installments` | `enabled`, las `options` permitidas (número de cuotas) y `types` cuando el proveedor tiene varios. |
| `charge_currency` | Cobrar en una moneda distinta a la del pedido (tres letras). |
| `exchange_rate` | Con `charge_currency`: `{ "source": "manual", "rate": 36.5 }` o `{ "source": "provider" }`. La tasa se fija por intento y queda en el intent. |

## Webhooks del proveedor

Cuando un método usa webhooks, configura esta URL en el portal del proveedor:

```
https://firespark.cloud/api/webhooks/payments/{provider}
```

`{provider}` es el id del proveedor, por ejemplo `mercadopago`. Fire spark verifica la firma con el secreto de webhook que pusiste en la conexión. La página de cada método dice si necesita webhook.

## Siguiente

> [card] [Usar pagos en el SDK](https://firespark.cloud/docs/es/guides/payments/use-payments-in-the-sdk.md)
>
> Cobra pedidos desde tu canal

> [card] [Configurar un dispositivo](https://firespark.cloud/docs/es/guides/payments/configure-a-device.md)
>
> Datos del terminal de cada kiosco


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