Consultar Histórico de Transações

A API de Consulta (/consulta) permite pesquisar transações passadas com base em intervalos de datas, resultados ou identificadores específicos. Esta é sua ferramenta principal para conciliação e para “recuperar” o status das operações se o seu servidor não receber uma notificação assíncrona.

O Endpoint de Consulta

• URL de Teste: https://tpvpc-i.redsys.es:27443/TPV_PC/services/rest/tpvpcwss/v1/consulta
• URL de Produção: https://tpvpc.redsys.es/TPV_PC/services/rest/tpvpcwss/v1/consulta
• Método: POST

Critérios de Pesquisa

Para realizar uma pesquisa, você deve enviar uma requisição JSON assinada. Os campos específicos que você inclui determinam o escopo da pesquisa.

Campos Obrigatórios

• fechaInicio: Data de início (Formato: YYYY-MM-DD-HH.mm.ss ou YYYY-MM-DD HH:mm:ss).
• fechaFin: Data de término. Nota: O intervalo máximo entre o início e o término é de 30 dias.

Filtros Opcionais

Você pode refinar sua pesquisa usando estes campos:

• pedido: O Order ID específico atribuído pelo sistema.
• factura: Sua referência de fatura personalizada.
• operacion: Filtrar por tipo (PAGO, PREAUTORIZACION, CONFIRMACION, DEVOLUCION).
• resultado: Filtrar por resultado (AUTORIZADA, DENEGADA).
• rts: O Transaction ID específico (RTS). Se fornecido, ele substitui outros filtros e retorna apenas essa operação específica.

Passo 1: Enviar uma Requisição de Consulta

Aqui está um exemplo de requisição pesquisando por pagamentos autorizados dentro de uma janela de tempo específica.

{
  "info": {
    "comercio": "777888991",
    "timestamp": "20250428 111217",
    "datosOperacion": {
      "fechaInicio": "2025-03-03-16.00.01",
      "fechaFin": "2025-03-04-16.35.09",
      "operacion": "PAGO",
      "resultado": "AUTORIZADA",
      "factura": "FAC-LATENTE",
      "pagina": 0
    }
  },
  "signature": "YOUR_CALCULATED_SIGNATURE"
}

Paginação: Se sua pesquisa retornar muitos resultados, use o campo pagina (começando em 0) para navegar pelos conjuntos de resultados.

Passo 2: Tratar a Resposta

A resposta contém metadados de paginação e uma lista de operaciones.

{
  "info": {
    "comercio": "777888991",
    "resultadoConsulta": {
      "numOperaciones": 1,
      "numPagina": 0,
      "totalPaginas": 1,
      "operaciones": [
        {
          "tipoOper": "Autorizacion",
          "tarjeta": "************7899",
          "importe": "2.02",
          "moneda": "978",
          "pedido": "4894",
          "fechaOperacion": "2025-05-05 16:10:56.0",
          "factura": "FAC-LATENTE",
          "estado": "F",
          "resultado": "AUTORIZADA",
          "codigoRespuesta": "0",
          "numAutorizacion": "577498"
        }
      ]
    },
    "resultado": {
      "codigo": "0"
    }
  },
  "signature": "SERVER_SIGNATURE"
}

Interpretando o Status da Transação

Dentro da lista operaciones, o campo estado informa o estado atual do ciclo de vida da transação:

Próximos Passos

• Depurar Problemas de Assinatura e Conectividade: Se a sua consulta retornar “Firma Incorrecta”, certifique-se de estar assinando a string JSON exata enviada.
• Endpoint de Totais e Conciliação: Aprenda como obter totais diários em vez de listas de transações individuais.