Setup: autenticación y entornos
Qué credenciales recibes y para qué sirve cada una, cómo obtener tu token, y contra qué entorno apuntas en cada momento.
Botón
Integra el Botón de pago en tu web.
Solicitud
Envía un enlace de pago por un canal externo.
Paradas SPIDI
La Parada es una carpeta de pagos con una dirección web que no caduca: para ti es donde metes y sacas sesiones; para tu cliente es un minisitio donde encuentra todo lo suyo reunido. El criterio de agrupación lo pones tú. Cómo crearla, cómo poner y quitar solicitudes con add, remove, replace y clear, qué ve el pagador, y por qué no conviene cruzar el plazo de lo que metes dentro.
Split
Reparte un pago entre varios receptores.
Métodos de pago
Qué métodos de pago aceptas y dónde se configuran, y qué le pasa a tu cliente cuando abre el enlace: que no se registra ni instala nada, que paga desde su propio banco, y que la clave que le piden se la manda su banco y no SPIDI.
Manejar notificaciones
Verifica spidi-signature y deduplica por idempotencia.
Success URL: verificar status
Nunca des por bueno un pago por la sola redirección; confírmalo en tu backend.
Manejo de estados y errores
Envelope de error y códigos por escenario.
Arquitectura recomendada
Cómo encajan tu frontend, tu backend, SPIDI, la página de pago, los webhooks y el status.