Puesta en marcha
Cobra por domiciliación SEPA en tres bloques
Lo que tienes que pedir a tu banco, cómo se conecta tu aplicación y una prueba completa antes de cobrar de verdad. Cada paso se marca solo en cuanto está hecho.
0/8
pasos completados
1 · Lo que necesitas de tu banco
Una sola cita con tu gestor de empresa. Lleva esta lista: con sus respuestas se configura todo lo demás.
| Qué pedir | Qué te tienen que dar | Dónde va en KeePay |
|---|---|---|
Contrato de adeudos SEPA Core También «remesas de recibos» o «cuaderno 19-14» |
El contrato firmado y sus condiciones: límite de emisión (máximo por remesa), comisión por recibo y por devolución, y cuándo te abonan cada remesa. | Paso 2 de esta guía |
Identificador de acreedor SEPA Creditor ID |
ES + 2 dígitos de control + sufijo de 3 caracteres (normalmente 000 o ZZZ) + tu NIF. Ejemplo: ES12000B12345678. | Paso 1 · Datos fiscales |
Cuenta de abono |
IBAN y BIC de la cuenta donde recibirás los cobros y la razón social exacta tal como figura en el banco. | Paso 1 · Datos fiscales |
Formato de las remesas |
Confirmación de que aceptan SEPA XML pain.008.001.02 (adeudos Core). Es el estándar europeo. | Automático Lo genera KeePay |
Canal de ficheros SFTP «Host to host» o «transmisión de ficheros» |
Servidor, puerto, usuario y las carpetas donde dejar las remesas y donde ellos dejan los extractos.
El banco te pedirá a cambio nuestra clave pública SSH (la generas en el paso 3) y la IP desde la que conectamos: 168.119.101.91, para autorizarla. |
Paso 3 de esta guía |
Extracto diario Norma 43 Cuaderno 43 |
Que lo dejen cada día por el mismo canal, con el detalle de los recibos devueltos (referencia del adeudo y código de motivo, p. ej. AM04). | Automático Concilia cobros y devoluciones |
Datos fiscales e identificador de acreedor
Razón social, NIF, cuenta de abono (IBAN + BIC) y el identificador de acreedor que te dé el banco. Compáralo con el previsible que calculamos con tu NIF:
Identificador previsible
—
Contrato de adeudos SEPA Core
Anota las condiciones que te dé el banco para tenerlas siempre a mano.
Canal de ficheros con el banco
Por aquí salen las remesas y entran los extractos. Con SFTP todo es automático; sin él, operas por banca online desde el panel.
A · Lo que entregas al banco
El banco da de alta esta clave para tu usuario SFTP y autoriza nuestra IP. La clave privada nunca sale de KeePay.
Clave pública SSH
IP de salida a autorizar
C · Comprueba la conexión
Conectamos, verificamos las carpetas y fijamos la huella del servidor del banco. Hasta la primera prueba correcta, las remesas siguen en modo manual (se descargan en Remesas).
Correo saliente
SEPA obliga a avisar a cada cliente del importe y la fecha antes de cobrarle. KeePay envía esos preavisos (y los de devolución o reintento) desde tu buzón.
2 · Conecta tu aplicación
Solo si integras KeePay en tu software por API. Si trabajas desde este panel, sáltate este bloque.
Claves de API
Empieza con una clave de prueba: opera sobre un banco simulado, con los mismos endpoints. Cuando todo funcione, cambia a la clave real.
Prueba · kp_test_…
Real · kp_live_…
Copia la clave ahora — no se volverá a mostrar. Guárdala en el servidor de tu aplicación (nunca en el navegador ni en una app móvil).
Webhooks
Tu aplicación se entera al momento de cada cambio (mandato firmado, cobro pagado o devuelto, suscripción impagada…) sin preguntar. Cada envío va firmado y se reintenta hasta 2 días si tu servidor no responde.
Secreto de firma de este endpoint — cópialo ahora para verificar la cabecera KeePay-Signature:
Guía de integración
Endpoints, objetos, ejemplos con curl, verificación de firmas y códigos de devolución SEPA. Tu primer cobro de prueba en 10 minutos.
# Crea tu primer cliente en modo prueba
curl https://keepay.es/v1/customers \
-H "Authorization: Bearer kp_test_…" \
-H "Content-Type: application/json" \
-d '{"name":"Talleres Ruiz, SL","email":"admin@talleres-ruiz.es"}'
3 · Prueba completa y salida a real
Recorre el circuito entero en modo prueba; cuando todo cuadre, cambia a la clave real.
7 Recorrido en modo prueba
Se marca solo según lo que hagas con la clave de prueba (o desde el panel en modo prueba).
8 Listo para cobrar de verdad
Lo que KeePay comprueba antes de presentar tu primera remesa real.
Cobros liquidados por mes
Actividad reciente
| Producto | Total (IVA incl.) | Tipo | Estado |
|---|
Haz clic en un enlace para ver sus cobros o sus suscripciones.
Nuevo enlace de pago
El enlace es reutilizable: créalo una vez y envíaselo a cualquier cliente.
1 Añade los productos
Así lo verá el cliente en la página de pago:
Aún no hay productos en el enlace.
2 Elige el tipo de cobro
3 Genera el enlace
| Cliente | Mandato | Importe/ciclo | Próximo cargo | Estado |
|---|
| Referencia | Cliente | Importe | Fecha cargo | Origen | Estado | Importe editable |
|---|
| Número | Cliente | Importe | Estado |
|---|
Cada remesa se descarga como XML (pain.008) desde su fila. Si tu canal es la banca online, sube aquí el extracto norma 43 del banco: se concilia al momento (liquidados, devoluciones y reintentos).
| MsgId | Presentación | Fecha cargo | Operaciones | Total | Estado |
|---|
| Código | Fecha | Cliente | Cargo | Importe | Acción |
|---|
Nueva suscripción
Para clientes con mandato activo. El primer cargo entra en cola y su preaviso sale solo.
Productos
El primer cargo se presenta hoy, prorrateado hasta el día fijo; después, siempre ese día.
Durante la prueba no se cobra; el primer cargo se presenta al terminar.
La fecha elegida es el día de presentación de la orden al banco; el cargo llega ~2 días hábiles después (normativa SEPA).
Cambiar fecha del próximo cobro
Nuevo cliente
Con su IBAN queda listo para cobrarle por adeudo SEPA.
Ficha del cliente
Mandatos
Añadir mandato
Enviar email
De:
Para:
Las plantillas admiten {cliente} y {marca}: se rellenan solos con el destinatario al aplicarlas.
Selecciona texto y aplica formato.
Se añadirá tu firma
Al enviarlo quedará registrado en la actividad del cliente.
| Código | Producto | Tipo | Precio sin IVA | IVA | Total | Estado |
|---|
Haz clic en un producto para ver su detalle, enlaces e ingresos.
Nuevo producto
Se añade al catálogo y queda disponible para los enlaces de pago.
| Nombre | Importe/ciclo | Ciclo | Activo |
|---|
Nuevo plan
Nueva empresa
Da de alta la empresa y pulsa «Invitar» en su fila: la persona recibe un enlace para crear su contraseña y entra directa a «Primeros pasos», donde ve qué pedir a su banco.
| Empresa | Slug | Clientes | Susc. activas | Acceso | Estado |
|---|
Cada empresa es su propio acreedor SEPA: su banco, su identificador y su cuenta. El dinero nunca pasa por Keemetrix.
| Nombre | Clave | Creada | Último uso | Estado |
|---|
La clave completa solo se muestra al crearla; aquí queda el prefijo para identificarla. Revocar una clave corta el acceso al instante.
Nueva API key
Para tu aplicación (API v1) u otras integraciones de esta empresa. Guía: documentación de la API.
Copia la clave ahora — no se volverá a mostrar:
Raíl Stripe
Puente mientras llega el canal bancario: KeePay cobra por Stripe usando el mandato ya firmado de cada cliente. «Tomar el control» cancela la suscripción en Stripe Billing y KeePay pasa a programar sus cobros desde el ciclo siguiente — el cliente no firma nada y no hay hueco ni doble cobro. Los resultados llegan por webhook y entran en el mismo circuito de conciliación y reclamaciones que el resto.
Suscripciones activas en Stripe Billing
Penalización por impago
Recargo del reintento tras una devolución
—
Penalización por impago
Recargo que se suma al reintento tras una devolución. Debe estar recogido en las condiciones de contratación aceptadas por el cliente; el preaviso del reintento desglosa importe original + recargo.
Correo saliente
Preavisos SEPA, confirmaciones y correos manuales
—
—Correo saliente (SMTP)
Buzón desde el que salen los preavisos SEPA, confirmaciones y correos manuales. La contraseña se guarda cifrada y nunca vuelve al navegador. Sin configurar, los emails solo se registran en el log del servidor.
Firma de correos
Cierra cada correo que envías, manual o automático: nombre, cargo y web enlazada. Vacío = "El equipo de tu marca".
Así se verá
Correos automáticos
Los envía el sistema solo cuando toca (altas, preavisos, devoluciones…). Personaliza el asunto y la introducción, o desactiva los opcionales.
Plantillas manuales
Estas son las que aparecen en el desplegable de «Enviar email» de la ficha del cliente. Créalas y envíalas cuando tú quieras.
Cambiar contraseña
La de tu usuario del panel. Se pide la contraseña actual por seguridad.
Apariencia del panel
Se guarda en este navegador: cada persona del equipo elige la suya.
Tema
Color de acento
Nueva plantilla manual
Quedará disponible en el desplegable de «Enviar email» de la ficha del cliente, con el diseño de tu marca.
Admite {cliente} {marca}, **negritas** y listas con «- ».
Editar plantilla
Admite {cliente} {marca}, **negritas** y listas con «- ».
Vista previa (datos de ejemplo)
Datos fiscales y bancarios del acreedor
Estos datos viajan en cada remesa pain.008. La razón social debe coincidir exactamente con el titular de la cuenta bancaria.
Marca del checkout
Personaliza las páginas públicas de pago: nombre comercial, color de acento y logo. Si lo dejas vacío se usa la razón social y el estilo por defecto.