Endpoints de pagos y preautorizaciones

Esta referencia detalla los endpoints utilizados para procesar ventas, retener fondos y confirmar preautorizaciones.

1. Procesar pago (`/pago`)

Inicia una transacción de venta estándar. El terminal solicitará la tarjeta al cliente.

URL (Test): https://tpvpc-i.redsys.es:27443/TPV_PC/services/rest/tpvpcwss/v1/pago
URL (Prod): https://tpvpc.redsys.es/TPV_PC/services/rest/tpvpcwss/v1/pago
Método: POST

Campo	Tipo	Requerido	Longitud máx.	Descripción
`importe`	Double	Sí	12	Importe de la transacción (p. ej., `10.50`, `0.01`).
`factura`	String	Sí	250	ID de factura único o referencia para la transacción.

Acuse de recibo síncrono de la petición.

Campo	Tipo	Descripción
resultado.codigo	String	`0` indica una recepción correcta. Cualquier otro valor indica un error.

Inicia una retención de fondos sin capturarlos inmediatamente.

URL (Test): https://tpvpc-i.redsys.es:27443/TPV_PC/services/rest/tpvpcwss/v1/preautorizacion
URL (Prod): https://tpvpc.redsys.es/TPV_PC/services/rest/tpvpcwss/v1/preautorizacion
Método: POST

Campo	Tipo	Requerido	Longitud máx.	Descripción
`importe`	Double	Sí	12	Importe a retener.
`factura`	String	Sí	250	Referencia única. Debe conservarse para el paso de Confirmación.

Acuse de recibo síncrono.

Campo	Tipo	Descripción
`resultado.codigo`	String	`0` indica una recepción correcta.

Captura fondos previamente retenidos por una Preautorización.

URL (Test): https://tpvpc-i.redsys.es:27443/TPV_PC/services/rest/tpvpcwss/v1/confirmacion
URL (Prod): https://tpvpc.redsys.es/TPV_PC/services/rest/tpvpcwss/v1/confirmacion
Método: POST

Campo	Tipo	Requerido	Longitud máx.	Descripción
`importe`	Double	Sí	12	Importe a capturar. Puede ser menor o igual al importe de la preautorización.
`factura`	String	Sí	250	Debe coincidir con la `factura` de la preautorización original.

Acuse de recibo síncrono.

Campo	Tipo	Descripción
`resultado.codigo`	String	`0` indica una recepción correcta.