> 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/cancelar-transaccion.md).

# Informar Cancelación (Opcional)

Reverso automático por parte de la Red Comercial.

Toda transacción valida puede ser cancelada (automáticamente) por parte de la Red Comercial dentro de un tiempo límite. Esta cancelación puede deberse a problemas en la comunicación u operativos en el punto de recaudo. Cuando esto suceda Payvalida realizará la solicitud al comercio para informar esta situación.

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

## Informar Cancelación

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

#### Request Body

| Name               | Type    | Description                                                                                                     |
| ------------------ | ------- | --------------------------------------------------------------------------------------------------------------- |
| netname            | string  | Nombre de la red de recaudo. Alfanumérico Max 100 caracteres.                                                   |
| checksum           | string  | Cadena de comprobación, calculada con SHA512(netname + transaction + FIXED\_HASH). Alfanumérico 128 caracteres. |
| timestamp          | integer | Fecha y hora en formato Unix segundos. Max 10 caracteres.                                                       |
| transaction        | string  | ID único de transacción de pago para la red de recaudo. Alfanumérico Max 50 caracteres.                         |
| payment\_reference | string  | Referencia del pago, recibida previamente en el método de consulta. Numérico Max 16 caracteres.                 |
| payment\_order     | string  | Orden única del comercio, recibida previamente en el método de consulta. Alfanumérico Max 100 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.transaction: Informativo, confirmación transacción enviada por la Red Comercial. Alfanumérico Max 15 caracteres.timestamp: Fecha en formato Unix segundos. Numérico max 10 caracteres.authorization\_code: Código de autorización de la cancelación por parte del comercio, 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": {
        "transaction":"8387727272822",
        "timestamp":1619649378,
        "authorization_code":"928877YUU",
        "checksum": "a5a43bfb7e2t6971062303f0a70722c8b6a2d5973a1c1e9f90ee74a9651e79410e4c04c384cffe406077d426070e070a1149e136bb035288b7c6ad0f957eff49"
    }
        
}
```

{% endtab %}
{% endtabs %}

![](https://3602949285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_NcbQ6S0j_cdIZdbfx%2Fuploads%2FPd1rPSfkiptxnuJj5meU%2Fimage.png?alt=media\&token=16ac41f0-92a2-44c1-b887-fafd269bed47)
