Getnet DocsGetnet Docs

Endpoints de Estornos e 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 referência detalha os endpoints usados para pesquisar o histórico de transações e processar estornos (tanto referenciados quanto com cartão presente).

1. Consultar Transações (/consulta)

Recupera o status e os detalhes de operações passadas.

  • URL (Teste): 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 da Requisição (datosOperacion)

CampoTipoObrigatórioDescrição
fechaInicioStringSimData de início (YYYY-MM-DD HH:mm:ss ou YYYY-MM-DD-HH.mm.ss).
fechaFinStringSimData de término. O intervalo máximo é de 30 dias a partir da data de início.
pedidoStringNãoPesquisar pelo Order ID (ID do Pedido) do sistema.
facturaStringNãoPesquisar pela sua Referência de Fatura.
operacionStringNãoFiltrar por tipo: PAGO, PREAUTORIZACION, CONFIRMACION, DEVOLUCION.
resultadoStringNãoFiltrar por resultado: AUTORIZADA, DENEGADA.
rtsStringNãoPesquisar por Transaction ID (ID da Transação). Substitui todos os outros filtros.
paginaIntNãoNúmero da página para paginação (começa em 0).

Resposta (resultadoConsulta)

CampoTipoDescrição
numOperacionesIntTotal de registros encontrados.
totalPaginasIntTotal de páginas disponíveis.
operacionesArrayLista de objetos de transação contendo importe, estado, resultado, etc.

2. Estorno Referenciado (/devolucion)

Estorna uma transação usando seu Order ID (pedidoBase) sem interação com o cartão.

  • URL (Teste): 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 da Requisição (datosOperacion)

CampoTipoObrigatórioComprimento Máx.Descrição
importeDoubleSim12Valor a ser estornado.
facturaStringSim250Referência para o próprio estorno.
pedidoBaseStringSim50O pedido (Order ID) da venda original.

Resposta (resultadoDevolucion)

Retornado apenas se resultado.codigo for 0.

CampoTipoDescrição
importeStringValor estornado.
resultadoStringAutorizada ou Denegada.
estadoStringF (Finalizada).

3. Estorno com Cartão Presente (/devolucionTarjeta)

Inicia um estorno que requer que o cliente insira o cartão.

  • URL (Teste): 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 da Requisição (datosOperacion)

CampoTipoObrigatórioComprimento Máx.Descrição
importeDoubleSim12Valor a ser estornado.
facturaStringSim250Referência para o estorno.
pedidoBaseStringSim50O pedido (Order ID) da venda original.

Resposta (info)

Reconhecimento síncrono. O resultado final é enviado via notificação.

CampoTipoDescrição
resultado.codigoString0 indica sucesso.