> For the complete documentation index, see [llms.txt](https://docs.payvalida.com/api-cashin-multiproducto/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/api-cashin-multiproducto/api-cashin-dinamico/validar-de-la-transaccion.md).

# Confirmar Transacción

Petición realizada por Payvalida para aprobar la transacción que se ejecuta en el punto de recaudo.

{% hint style="warning" %}
La respuesta debe ser entregada en máximo 14 segundos.
{% endhint %}

## Confirmar Transacción

<mark style="color:green;">`POST`</mark> `https://[URL definida por el comercio]`

#### Request Body

| Name               | Type    | Description                                                                                                                                                                                       |
| ------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| request\_type      | integer | Valor del 1 al 9 el cual puede ser habilitado como criterio de búsqueda en la Red VIA Baloto dependiendo del caso de uso del comercio. Numérico 1 caracter.                                       |
| reference          | string  | Referencia principal para la consulta de referencias de pago. Numérico Max 16 caracteres.                                                                                                         |
| reference\_aux     | string  | Referencia auxiliar la cual puede ser habilitada como criterio de búsqueda en la Red Via Baloto dependiendo del caso de uso del comercio. Numérico Max 16 caracteres.                             |
| payment\_reference | string  | Referencia que se va a pagar, la cual fue recibida dentro del listado de opciones posibles a pagar en el método de consulta. String Max 16 caracteres, numéricos.                                 |
| amount             | number  | Valor del pago. Numérico Max 20 caracteres.                                                                                                                                                       |
| payment\_order     | string  | Orden única en el comercio, recibida previamente dentro del listado de opciones posibles a pagar en el método de consulta. Alfanumérico Max 100 caracteres.                                       |
| netname            | string  | Nombre de identificación única de la Red de Recaudo. Alfanumérico Max 100 caracteres.                                                                                                             |
| checksum           | string  | Cadena de comprobación, calculada con SHA512(netname + reference + payment\_reference + amount + transaction + FIXED\_HASH). Alfanumérico 128 caracteres.                                         |
| timestamp          | integer | La fecha y hora en formato Unix (segundos). Max 10 caracteres.                                                                                                                                    |
| transaction        | string  | ID único de transacción de pago registrada por la red de recaudo. Alfanumérico Max 50 caracteres.                                                                                                 |
| teller             | string  | Código de la tienda/punto en dónde se realiza la transacción (IP o punto de venta). Alfanumérico Max 50 caracteres.                                                                               |
| terminal\_code     | string  | Código de la terminal en dónde se realiza la transacción. Alfanumérico Max 50 caracteres (depende de la Red de Recaudo)                                                                           |
| geographic\_code   | string  | Código de la localidad en dónde se realiza la transacción, depende de la red/país que lo invoque. Para Colombia podría ser el código DANE. Alfanumérico Max 20 caracteres.                        |
| key\_value         | string  | Para incluir posible configuración o condición especial que se deba tener en cuenta en la transacción. posibilidad de incluir cadena con estructura llave-valor. Alfanumérico Max 500 caracteres. |
| money              | string  | Código de moneda de la transacción. Colombia "1". Alfanumérico Max 3 caracteres.                                                                                                                  |

{% tabs %}
{% tab title="200 code:  "0000" cuando la respuesta sea exitosa. String numérico 4 caracteres. text: Descripción del error, "OK" cuando la respuesta sea exitosa. Alfanumérico Max 30 caracteres.amount: Valor aceptado. Numérico Max 20 caracteres.payment\_order: Informativo, confirmación de la orden del comercio, igual a la retornada en la consulta. Alfanumérico Max 100 caracteres.transaction\_cost: Informativo, confirmación del costo de la orden. Numérico Max 20 caracteres.description: Informativo, descripción genérica del resultado de la operación. Alfanumérico Max 30 caracteres. No debe contener caracateres especiales.timestamp: Fecha y hora en formato Unix segundos. Numérico 10 caracteres.authorization\_code: Código de autorización del comercio, código de aprobación entregado por el comercios. Alfanumérico Max 15 caracteres, sin caracteres especiales.checksum: Cadena de comprobación, calculada con SHA512( timestamp + authorization\_code + FIXED\_HASH ). Solo se calcula cuando el http status = 200. Alfanumérico 128 caracteres." %}

```
{
    "code":"0000",
    "text": "OK",
    "data": {
        "amount":5000,
        "payment_order":"orden_unica_92828992",
        "transaction_cost":0,
        "description":"Descripcion de la transaccion",
        "timestamp":1619649378,
        "authorization_code":"872YTGHS89",
        "checksum": "a5a43bfb7e2t6971062303f0a70722c8b6a2d5973a1c1e9f90ee74a9651e79410e4c04c384cffe406077d426070e070a1149e136bb035288b7c6ad0f957eff49"
}
```

{% endtab %}
{% endtabs %}