Volver al blog
Facturación

Security Deposits API: lista de pruebas de integración

Comprueba tu API de garantías con una matriz para creación duplicada, autorización, captura final, liberación y cambios de reserva.

13 de octubre de 20265 min de lectura
P
PayRequest Team
Equipo editorial PayRequest

Antes del lanzamiento, verifica todo el ciclo de Security Deposits API: creación, autorización del cliente, sincronización, cobro compatible y liberación. Una respuesta correcta de creación no demuestra que haya fondos retenidos.

Esta lista propone un plan de aceptación para software de alquiler. No es una certificación ni un informe de pruebas ejecutadas.

Prepara una prueba controlada de la API de garantías

Confirma la configuración de pruebas con PayRequest y tu proveedor. Usa clientes ficticios y credenciales de prueba compatibles; no supongas un servidor sandbox PayRequest separado. La referencia API requiere billing.read para consultar y billing.write para crear, capturar y liberar. Guarda tokens en el servidor y conserva bytes originales para verificar firmas.

Prepara TEST-104 con una garantía ficticia de €350. Registra referencia, identificador, proveedor, estado, captured_amount y capture_before. Usa reservas distintas para captura y liberación porque ambas finalizan la retención.

Recorre la matriz de aceptación

Los resultados esperados siguen el flujo Stripe documentado. Confirma compatibilidad de cuenta y método de pago.

EscenarioComprobación esperada
Dos creaciones con la misma claveUna asociación y un mensaje al cliente
Cliente sin autorizaciónPending; no mostrar fondos retenidos
Autorización en procesoPending y metadatos disponibles; sin sustitución automática
Autorización completadaAuthorized y capture_before real
Capturar €150 de €350Captured; €200 liberados, sin segunda captura
Segunda captura tras finalización localHTTP 409 documentado; ningún segundo cobro
Liberar otra retención activaReleased; mensaje describe liberación
Webhook duplicado o tardíoNinguna acción repetida ni retroceso de estado final

Conserva referencias verificables de solicitudes y respuestas sin secretos ni datos de tarjeta. Las capturas de pantalla ayudan; el estado API actual establece el resultado financiero.

Prueba los cambios de reserva por separado

Modifica la devolución y comprueba que el sistema no prolongue silenciosamente la autorización. Stripe exige capturar antes del plazo real. Una devolución próxima al vencimiento debe generar una revisión, no un cobro total automático.

Separa alquiler mediante enlaces de pago, disponibilidad de reservas y garantía. Acuerdo, inspección y acción compatible determinan la decisión.

Consulta respuestas ambiguas antes de reintentar

Simula una respuesta de creación perdida y reutiliza la clave guardada. Para captura o liberación, consulta el registro antes de actuar: la idempotencia de creación no garantiza otras operaciones. Usa el plan de recuperación.

Pending puede incluir un intento vencido; expired corresponde a una retención confirmada que venció. Comprueba también móvil, rechazo de firmas inválidas, aislamiento de cuentas y permisos de lectura o escritura.

Inicia un piloto con los depósitos de garantía PayRequest y revisa planes y límites. Exige evidencia por escenario y un responsable de excepciones.

Nota editorial: texto e ilustración asistidos por IA. Documentación revisada el 13 de octubre de 2026. No se ejecutaron movimientos financieros reales; la matriz es una propuesta original.

Frequently Asked Questions

¿Crear un enlace ya retiene fondos?

No. Verifica authorized y el plazo del proveedor después de la autorización del cliente.

¿Cambiar la devolución prolonga la retención?

No. Modificar una reserva no reemplaza el plazo del proveedor. Revisa la garantía y el siguiente paso compatible.

Compartir este artículo