Getnet DocsGetnet Docs

Endpoints de devoluciones y consultas

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

Esta referencia detalla los endpoints utilizados para buscar en el historial de transacciones y procesar devoluciones (tanto referenciadas como con tarjeta presente).

1. Consultar transacciones (/consulta)

Recupera el estado y los detalles de operaciones pasadas.

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

Parámetros de la petición (datosOperacion)

CampoTipoRequeridoDescripción
fechaInicioStringSíFecha de inicio (YYYY-MM-DD HH:mm:ss o YYYY-MM-DD-HH.mm.ss).
fechaFinStringSíFecha de fin. El rango máximo es de 30 días desde la fecha de inicio.
pedidoStringNoBuscar por ID de pedido (Order ID) del sistema.
facturaStringNoBuscar por su referencia de factura.
operacionStringNoFiltrar por tipo: PAGO, PREAUTORIZACION, CONFIRMACION, DEVOLUCION.
resultadoStringNoFiltrar por resultado: AUTORIZADA, DENEGADA.
rtsStringNoBuscar por ID de transacción (Transaction ID). Anula todos los demás filtros.
paginaIntNoNúmero de página para la paginación (empieza en 0).

Respuesta (resultadoConsulta)

CampoTipoDescripción
numOperacionesIntTotal de registros encontrados.
totalPaginasIntTotal de páginas disponibles.
operacionesArrayLista de objetos de transacción que contienen importe, estado, resultado, etc.

2. Devolución referenciada (/devolucion)

Devuelve una transacción utilizando su ID de pedido (pedidoBase) sin interacción con la tarjeta.

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

Parámetros de la petición (datosOperacion)

CampoTipoRequeridoLongitud máx.Descripción
importeDoubleSí12Importe a devolver.
facturaStringSí250Referencia para la propia devolución.
pedidoBaseStringSí50El pedido (ID de pedido) de la venta original.

Respuesta (resultadoDevolucion)

Se devuelve únicamente si resultado.codigo es 0.

CampoTipoDescripción
importeStringImporte devuelto.
resultadoStringAutorizada o Denegada.
estadoStringF (Finalizada).

3. Devolución con tarjeta presente (/devolucionTarjeta)

Inicia una devolución que requiere que el cliente inserte su tarjeta.

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

Parámetros de la petición (datosOperacion)

CampoTipoRequeridoLongitud máx.Descripción
importeDoubleSí12Importe a devolver.
facturaStringSí250Referencia para la devolución.
pedidoBaseStringSí50El pedido (ID de pedido) de la venta original.

Respuesta (info)

Acuse de recibo síncrono. El resultado final se envía mediante notificación.

CampoTipoDescripción
resultado.codigoString0 indica éxito.