# Consulta

Permite obtener información de una operación de Cashout

{% hint style="info" %}
Método: **POST**
{% endhint %}

{% hint style="success" %}
**Producción:** <https://api.payvalida.com/cashout/v1/order/{netname}>

**Sandbox (pruebas):** <https://api-test.payvalida.com/cashout/v1/order/{netname}>
{% endhint %}

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

<table><thead><tr><th>Nombre</th><th width="150">Requerido</th><th>Descripción</th><th>Tipo</th><th>Longitud</th></tr></thead><tbody><tr><td>otp</td><td>Si</td><td>Pin de operación u OTP</td><td>Alfanumérico</td><td>30</td></tr><tr><td>netcode</td><td>Si</td><td>Código de la red</td><td>Numérico</td><td>20</td></tr><tr><td>document</td><td>Si</td><td>Número de documento de identidad o referencia asociada a la transacción</td><td>Alfanumérico</td><td>20</td></tr><tr><td>checksum</td><td>Si</td><td>Cadena de comprobación, calculada con SHA512(name + pin + document + FIXED_HASH)</td><td>Alfanumérico</td><td>512</td></tr><tr><td>customparam01</td><td>No</td><td>Parámetro customizable (tipo cuenta)</td><td>Alfanumérico</td><td>50</td></tr><tr><td>customparam02</td><td>No</td><td>Parámetro customizable (valor)</td><td>Alfanumérico</td><td>50</td></tr><tr><td>customparam03</td><td>No</td><td>Parámetro customizable</td><td>Alfanumérico</td><td>50</td></tr></tbody></table>
{% endtab %}

{% tab title="Request (Ejemplo)" %}

> curl --request POST '<https://api-test.payvalida.com/cashout/v1/order/VIA'\\>
> &#x20;           \--data-raw '{
>
> &#x20;                       "otp": "1234056",
>
> &#x20;                       "netcode": 180,
>
> &#x20;                       "document": "1020304051",
>
> &#x20;                       "checksum": "SHA512FIXEDHASH"
>
> &#x20;           }'
> {% endtab %}

{% tab title="Response" %}

| Nombre               | Descripción                                                                                                  | Tipo         |
| -------------------- | ------------------------------------------------------------------------------------------------------------ | ------------ |
| code                 | Indica el código del resultado, “0000” indica resultado sin error, otro valor indica el código del error     | Alfanumérico |
| text                 | Contiene el mensaje referente al code enviado.                                                               | Alfanumérico |
| data                 | Contiene los datos de la transacción (para resultados sin error)                                             | Objeto       |
| data-amount          | Monto de la transacción                                                                                      | Alfanumérico |
| data-transactionCost | Indica el costo que asume el usuario por realizar la transacción                                             | Alfanumérico |
| data-currency        | Moneda en la que está registrada la orden de cashout\*                                                       | Alfanumérico |
| data-document        | Descripción de la transacción                                                                                | Alfanumérico |
| data-otp             | Confirmación del otp enviado                                                                                 | Alfanumérico |
| data-operation       | Identificador de la operación, necesario para el registro de una transacción                                 | Alfanumérico |
| data-customparam01   | Parámetro customizable enviado por la red                                                                    | Alfanumérico |
| data-customparam02   | Parámetro customizable enviado por la red                                                                    | Alfanumérico |
| data-customparam03   | Parámetro customizable enviado por la red                                                                    | Alfanumérico |
| data-checksum        | Cadena de comprobación, calculada con SHA512(otp + document + amount + currency + idoperation + FIXED\_HASH) | Alfanumérico |

{% endtab %}

{% tab title="Response (Ejemplo)" %}

> {
>
> &#x20;           "code": "0000",
>
> &#x20;           "text": "OK",
>
> &#x20;           "data": {
>
> &#x20;                       "amount": "31529.0",
>
> &#x20;                       "transactionCost": "991",
>
> &#x20;                       "currency": "COP",
>
> &#x20;                       "description": "Test Cashout",
>
> &#x20;                       "document": "10410754367",
>
> &#x20;                       "otp": "3659",
>
> &#x20;                       "operation": "312",
>
> &#x20;                       "checksum": "SHA512FIXEDHASH"
>
> &#x20;           }
>
> }
> {% endtab %}
> {% endtabs %}

{% hint style="info" %}
\*Las monedas actualmente aceptadas en Payválida son:

* COP (Peso colombiano)
* PEN (Sol peruano)
* USD (Dolar americano)
* CRC (Colón costarricense)
* GTQ (Quetzal guatemalteco)
  {% endhint %}