Obtener Transacción Compra

Consulta un listado paginado de transacciones

GET /TransaccionCompra

Autenticación: Cuenta Wompi o negocio

Autorización: Requiere permisos adicionales

Parámetros de ruta:

Campo	Tipo Dato	Es Requerido	Descripción
cantidadPorPagina	int (anulable)	No	Cantidad de elementos por página. Valor por defecto: 20.
paginaActual	int (anulable)	No	Página actual. Por defecto es la primera.
fechaInicio	DateTimeOffset (anulable)	No	Fecha inicial de las transacciones. Si no se incluye, se toma desde la primera transacción realizada.
fechaFin	DateTimeOffset (anulable)	No	Fecha final de las transacciones. Si no se incluye, se toma hasta la última transacción realizada.
numeroCuenta	string	No	Número de cuenta bancaria. Opcional.
formaPago	int (anulable)	No	Forma de pago utilizada para realizar la transacción. Las formas pueden ser: · PagoNormal = 0 · Puntos = 1 · Cuotas = 2 · Bitcoin = 3 · QuickPay = 4
resultadoTransaccion	int (anulable)	No	Número relacionado al resultado de la transacción. Los valores pueden ser: · ExitosaAprobada = 0 · ExitosaDeclinada = 1 · Fallida = 2
emailCliente	string	No	Correo electrónico del cliente que realizó la transacción. Opcional.
idAplicativo	string	No	Identificador del negocio a consultar.
montoInicial	decimal (anulable)	No	Monto inicial de las transacciones a buscar.
montoFinal	decimal (anulable)	No	Monto final de las transacciones a buscar.

Objeto de respuesta:

Campo	Tipo Dato	Descripción
paginaActual	int	Número de la página actual.
cantidadPorPagina	int	Cantidad de elementos solicitados por página.
totalDeElementos	int	Total, de elementos en todas las páginas.
resultado	List<Transacción>	Lista de transacciones correspondientes a la página actual.
totalPaginas	int	Total, de páginas calculado a partir del total de elementos y cantidad por página.

Objeto Transacción

Campo	Tipo Dato	Descripción
Campo	Tipo Dato	Descripción
idTransaccion	string	Identificador único de la transacción.
esReal	bool	Indica si la transacción fue real según el ambiente del negocio.
esAprobada	bool	Indica si la transacción fue autorizada correctamente.
codigoAutorizacion	string	Código de autorización retornado cuando la transacción es exitosa.
mensaje	string	Mensaje de error retornado cuando la transacción no fue exitosa.
formaPago	int (anulable)	Forma de pago utilizada para realizar la transacción. Las formas pueden ser: · PagoNormal = 0 · Puntos = 1 · Cuotas = 2 · Bitcoin = 3 · QuickPay = 4
monto	decimal	Monto de la transacción en dólares.
idExterno	string	Identificador definido por el comercio para la transacción.

Ejemplo de respuesta

{
  "paginaActual": 0,
  "cantidadPorPagina": 0,
  "totalDeElementos": 0,
  "resultado": [
      {
      "datosAdicionales": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      },
      "resultadoTransaccion": 0,
      "fechaTransaccion": "2026-03-10T16:15:40.547Z",
      "montoOriginal": 0,
      "idTransaccion": "string",
      "esReal": true,
      "esAprobada": true,
      "codigoAutorizacion": "string",
      "mensaje": "string",
      "formaPago": 0,
      "monto": 0,
      "idExterno": "string"
    }
  ],
  "totalPaginas": 0
}