Getnet DocsGetnet Docs

Refunds and Inquiries Endpoints

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

This reference details the endpoints used for searching transaction history and processing refunds (both referenced and card-present).

1. Query Transactions (/consulta)

Retrieves the status and details of past operations.

  • 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
  • Method: POST

Request Parameters (datosOperacion)

FieldTypeRequiredDescription
fechaInicioStringYesStart date (YYYY-MM-DD HH:mm:ss or YYYY-MM-DD-HH.mm.ss).
fechaFinStringYesEnd date. Max range is 30 days from start date.
pedidoStringNoSearch by system Order ID.
facturaStringNoSearch by your Invoice Reference.
operacionStringNoFilter by type: PAGO, PREAUTORIZACION, CONFIRMACION, DEVOLUCION.
resultadoStringNoFilter by result: AUTORIZADA, DENEGADA.
rtsStringNoSearch by Transaction ID. Overrides all other filters.
paginaIntNoPage number for pagination (starts at 0).

Response (resultadoConsulta)

FieldTypeDescription
numOperacionesIntTotal records found.
totalPaginasIntTotal pages available.
operacionesArrayList of transaction objects containing importe, estado, resultado, etc.

2. Referenced Refund (/devolucion)

Refunds a transaction using its Order ID (pedidoBase) without card interaction.

  • 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
  • Method: POST

Request Parameters (datosOperacion)

FieldTypeRequiredMax LengthDescription
importeDoubleYes12Amount to refund.
facturaStringYes250Reference for the refund itself.
pedidoBaseStringYes50The pedido (Order ID) of the original sale.

Response (resultadoDevolucion)

Returned only if resultado.codigo is 0.

FieldTypeDescription
importeStringAmount refunded.
resultadoStringAutorizada or Denegada.
estadoStringF (Finalized).

3. Card-Present Refund (/devolucionTarjeta)

Initiates a refund requiring the customer to insert their card.

  • 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
  • Method: POST

Request Parameters (datosOperacion)

FieldTypeRequiredMax LengthDescription
importeDoubleYes12Amount to refund.
facturaStringYes250Reference for the refund.
pedidoBaseStringYes50The pedido (Order ID) of the original sale.

Response (info)

Synchronous acknowledgment. Final result sent via notification.

FieldTypeDescription
resultado.codigoString0 indicates success.