Introducción
Ya está disponible la versión 2.2 de la API de Inespay, que incorpora mejoras en rendimiento, seguridad y funcionalidad. La estructura de la documentación API ha sido renovada y ahora está disponible única e íntegramente en inglés para facilitar la accesibilidad y la estandarización.
Con este lanzamiento, iniciamos el plan de deprecación de versiones anteriores.
Para garantizar la continuidad del servicio, es imprescindible completar la migración antes del 31 de marzo de 2026. A partir de esa fecha, las versiones v1, v2.0 y v2.1 dejarán de estar disponibles.
Cambios principales en v2.2
- Consulta de pago por ID (
GET /payins/single/{singlePayinId}):
Ahora incluye:scheme: esquema SEPA utilizado en la transferencia (estándar (SCT) o instantánea (SCT-INST)).debtorBankId: identificador del banco emisor.creditorBankId: identificador del banco receptor.
- Consulta de pagos por rango de fechas (
GET /payins/single):
Se ha añadido soporte para filtros por rango de fechas (from,to).
- Consulta de bancos (
GET /banks):
Posibilidad de aplicar múltiples filtros en la consulta.
Guía de migración
Para facilitar la transición, a continuación se detallan los cambios que debe aplicar en función de la versión que esté utilizando actualmente:
Migración desde API v1
Inicio de pago simple
| Entorno | v1 | v2.2 Nueva |
| SAN | apiflow.inespay.com/san/url/signer | apiflow.inespay.com/san/v22/payins/single/init |
| PRO | apiflow.inespay.com/pro/url/signer | apiflow.inespay.com/pro/v22/payins/single/init |
Parámetros petición
| v1 | v2.2 Nueva |
| subject | description |
| urlOk | successLinkRedirect |
| urlOkMethod | successLinkRedirectMethod |
| urlError | abortLinkRedirect |
| urlErrorMethod | abortLinkRedirectMethod |
| urlNotif | notifUrl |
| urlNotifContentType | notifUrlContentType |
| expireMinutes | expiration |
| accountDestiny | creditorAccount |
| customRecipient | (Eliminado) |
Respuesta
| v1 | v2.2 Nueva |
| description | statusDesc |
| idDebt | singlePayinId |
| url | singlePayinLink |
Notificación electrónica (callback)
| v1 | v2.2 Nueva |
| transactionId | singlePayinId |
| status (éxito con valor 200) | codStatus (OK o SETTLED) |
| subject | description |
| dateInitPayment | date |
| accountDestiny | creditorAccount |
| holderOrigin | debtorName |
| accountOrigin | debtorAccount |
Inicio de pago periódico
| Entorno | v1 | v2.2 Nueva |
| SAN | apiflow.inespay.com/san/url/periodic-payment-signer | apiflow.inespay.com/san/v22/payins/periodic/init |
| PRO | apiflow.inespay.com/pro/url/periodic-payment-signer | apiflow.inespay.com/pro/v22/payins/periodic/init |
Parámetros petición
| v1 | v2.2 Nueva |
| subject | description |
| urlOk | successLinkRedirect |
| urlOkMethod | successLinkRedirectMethod |
| urlError | abortLinkRedirect |
| urlErrorMethod | abortLinkRedirectMethod |
| urlNotif | notifUrl |
| urlNotifContentType | notifUrlContentType |
| expireMinutes | expiration |
| accountDestiny | creditorAccount |
| customRecipient | (Eliminado) |
Respuesta
| v1 | v2.2 Nueva |
| description | statusDesc |
| idDebt | periodicPayinId |
| url | periodicPayinLink |
Migración desde API v2.0
Inicio de pago simple
| Entorno | v2.0 | v2.2 Nueva |
| SAN | apiflow.inespay.com/san/v2/payins/simple/init | apiflow.inespay.com/san/v22/payins/single/init |
| PRO | apiflow.inespay.com/pro/v2/payins/simple/init | apiflow.inespay.com/pro/v22/payins/single/init |
Parámetros petición
| v2.0 | v2.2 Nueva |
| customRecipient | (Eliminado) |
Respuesta
| v2.0 | v2.2 Nueva |
| simplePayinId | singlePayinId |
| url | singlePayinLink |
Notificación electrónica (callback)
| v2.0 | v2.2 Nueva |
| simplePayinId | singlePayinId |
Migración desde API v2.1
Inicio de pago simple
| Entorno | v2.1 | v2.2 Nueva |
| SAN | apiflow.inespay.com/san/v21/payins/simple/init | apiflow.inespay.com/san/v22/payins/single/init |
| PRO | apiflow.inespay.com/pro/v21/payins/simple/init | apiflow.inespay.com/pro/v22/payins/single/init |
Pasos recomendados
1. Revisar los cambios en la tabla correspondiente a su versión actual.
2. Actualizar su integración con los nuevos entornos, parámetros y campos de respuesta.
3. Validar en entorno de pruebas (sandbox) la correcta integración.
4. Planificar la migración a producción antes de la fecha límite.
5. Supervisar tras la migración, monitorizando errores y tiempos de respuesta.
Preguntas frecuentes (FAQ)
¿Qué ocurre si no realizo la migración a tiempo?
Las versiones v1, v2.0 y v2.1 dejarán de estar operativas a partir del 31 de marzo de 2026, y no podrán procesar solicitudes de pago.
¿Cambian las credenciales o la autenticación?
No, la autenticación mantiene el esquema actual.
¿Debo modificar callbacks?
Únicamente se amplían los datos disponibles en las respuestas y se modifican la nomenclatura de algunos parámetros.
Soporte
Si necesita ayuda durante la migración, nuestro equipo está a su disposición:
- Correo: developer@inespay.com
- Horario: lunes a viernes, 9:00–18:00 (CET)
