> For the complete documentation index, see [llms.txt](https://docs.payvalida.com/apipse/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payvalida.com/apipse/ordenes-de-pse/consultar.md).

# Consultar

Consulta el estado de la transacción en PSE

## Consultar

<mark style="color:blue;">`GET`</mark> `https://api.payvalida.com/pse/transactions/{ticketid}`

**URLSandbox:** *<https://api-test.payvalida.com/pse/transactions/{ticketid}>*

#### Path Parameters

| Name     | Type   | Description                                       |
| -------- | ------ | ------------------------------------------------- |
| ticketid | string | Código de transacción en PSE. Máx. 19 caracteres. |

#### Query Parameters

| Name     | Type   | Description                                                   |
| -------- | ------ | ------------------------------------------------------------- |
| merchant | string | Identificación del comercio en Payvalida. Máx. 50 caracteres. |
| checksum | string | Cadena de comprobación con SHA512 (ticketid + FIXED\_HASH)    |

{% tabs %}
{% tab title="200 La ejecución retorna un JSON estructurado de esta manera:" %}

```
{
    "CODE": "0000",
    "DATA": {
        "TRANSACTION_DATE": "20/11/2020",
        "BANK": "1051-BANCO DAVIVIENDA",
        "STATUS": "APROBADA",
        "NIT": "9004186855",
        "TRAZABILITY_CODE": "805402411"
    },
    "DESC": "Consulta exitosa"
}
```

{% endtab %}
{% endtabs %}

#### Detalles

* **ticketid:** identificador único de la orden en PSE. Este identificador se da al momento de la creación de esta orden utilizando el endpoint de creación.
* **merchant:** identificador único del comercio en Payvalida, cada comercio tiene asignado un FIXED\_HASH único, solo conocido por Payvalida y el Comercio.
* **checksum:** verificación de la identidad del comercio.

{% hint style="success" %}
La identificación del comercio (merchant) y FIXED\_HASH, es generada al momento de [crear una cuenta](https://registro.payvalida.com) en nuestra plataforma y se envía por correo electrónico.
{% endhint %}

{% hint style="warning" %}
Los diferentes estados en las que la orden puede estar son: APROBADA, RECHAZADA, PENDIENTE o FALLIDA
{% endhint %}

{% hint style="info" %}
Si la transacción de PSE se encuentra en estado APROBADA, la orden de compra en Payvalida automáticamente pasa a APROBADA también.
{% endhint %}