# Operación única

## Consultar operación única

<mark style="color:blue;">`GET`</mark> `https://api.payvalida.com/cashout/v1/operation/{merchant}/{operation}`

`URL Sandbox: https://api-test.payvalida.com/cashout/v1/operation/`**`{merchant}/{operation}`**\
\
Permite obtener información de una operación de cashout, indicando los datos relevantes de la misma

#### Path Parameters

| Name                                        | Type   | Description                                                            |
| ------------------------------------------- | ------ | ---------------------------------------------------------------------- |
| merchant<mark style="color:red;">\*</mark>  | string | Comercio que realiza la operación (30 caracteres)                      |
| operation<mark style="color:red;">\*</mark> | string | Identificador de la operación generada por el comercio (40 caracteres) |

#### Query Parameters

| Name                                       | Type   | Description                                                                                                  |
| ------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------ |
| checksum<mark style="color:red;">\*</mark> | string | Cadena de comprobación, calculada con SHA512(merchant + operation + document + FIXED\_HASH) (512 caracteres) |
| document<mark style="color:red;">\*</mark> | number | Número de documento de identidad o referencia asociada a la operación (20 caracteres)                        |
| aditional\_info                            | string | Opcional para obtener información  adicional según el valor enviado                                          |

{% tabs %}
{% tab title="200 " %}

```
{  
   "code":"0000",
   "text":"OK",
   "data":{
      "amount":"45000.0",
      "transactionCost":"2000.0",
      "currency":"COP",
      "description":"Retiro dividendos",
      "document":"986157352",
      "sms":"false",
      "cellphone":"3015555555",
      "operation":"15249",
      "expire":"01122019",
      "update":"01122019",
      "status":"APROBADA"
   }
}
```

{% endtab %}
{% endtabs %}

**code:** es el código del resultado, "0000" indica resultado sin error, otro valor indica el código del error.

**text:** es el mensaje referente al código (code) enviado.

**data:** contiene los datos de la transacción (vacío si hay error).

* **amount:** monto de la operación
* **transactionCost:** es el costo que asume el usuario por realizar la operación.
* **currency:** moneda de la operación.
* **description:** descripción de la operación.
* **document:** número de documento de identidad del usuario.
* **sms:** si se solicita el envío del OTP por SMS al usuario final.
* **cellphone:** número de celular para envío del OTP.
* **operation:** identificador de la operación generado por el comercio.
* **expire:** fecha de expiración de la operación.
* **update:** fecha de actualización de la operación.
* **status:** estado de la operación.
* **additional\_info:** objeto con información adicional

### Opciones  para additional\_info

* **DANE\_CODE:** Obtiene el código dane almacenado en la base de datos o código de localización dentro de *dane\_code*
* **LOCATION\_CODE**: Obtiene el código de localización almacenado del campo location\_code

## Estados posibles

* Aprobada: se procesó el cashout satisfactoriamente.
* Vencida: el cashout no procesó antes de la fecha de expiración.
* Cancelada: la operación fue cancelada por el comercio.
* Anulada: la operación fue anulada por Payvalida.
* Pendiente: la operación se encuentra a la espera de completar el cashout.