# Anulaciones

<div align="left"><figure><img src="https://3635475909-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MIa0RFEe6TfbpnP9FlP-887967055%2Fuploads%2F3b5SdrTBapqT9IVnPAKE%2Fimage.png?alt=media&#x26;token=da247f69-7ed7-404f-aab4-0338ca202929" alt="" width="412"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Para utilizar este servicio tanto en producción como en el entorno de pruebas (sandbox), debes ponerte en contacto con <support@payvalida.com> para solicitar su activación.
{% endhint %}

{% hint style="success" %}
**Producción:** [**https://api.payvalida.com/v4/merchant/transaction/cancel**](https://api.payvalida.com/v4/merchant/transaction/cancel)
{% endhint %}

{% hint style="success" %}
**Sandbox:** [**https://api-test**](https://api-test.payvalida.com/api/v3/checkout/tc/cancel)**.**[**payvalida.com/v4/merchant/transaction/cancel**](https://api.payvalida.com/v4/merchant/transaction/cancel)
{% endhint %}

**Parámetros en formato JSON en el cuerpo de la petición POST**

{% tabs %}
{% tab title="Parámetros" %}

| Campo          | Requerido | Tipo         | Descripción                                                                                             |
| -------------- | --------- | ------------ | ------------------------------------------------------------------------------------------------------- |
| order\_number  | si        | Numérico     | Número de la orden, el mismo que es devuelto al comercio al momento de realizar la transacción (number) |
| merchant\_name | si        | Alfanumérico | Nombre identificador del comercio.                                                                      |
| checksum       | si        | Alfanumérico | Checksum formado de la siguiente manera: SHA512(merchant\_name + order\_number + fixed\_hash)           |
| {% endtab %}   |           |              |                                                                                                         |

{% tab title="Request" %}

```postman_json
{
  "order_number": 2402558,
  "merchant_name": "some_merchant",
  "checksum": "fd8656323d70da776fed8fcfb04f59f582fccba022fa2cd48f4056ed221fd01fea1831dfc0296093f26a27a227ea630b93c6532d93e3f38d27b89ae26e07b6fe"
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "CODE": "0000",
    "DESC": "transaction canceled successfully"
}
```

{% hint style="danger" %}
Se debe tener que cuenta que para confirmar que la transacción fue anulada correctamente, el api debe responder con los códigos 0000 o 0001, en caso contrario, hubo algún problema en el proceso.
{% endhint %}
{% endtab %}

{% tab title="Códigos respuesta" %}
Los siguientes códigos hacen referencia a que la anulación se realizó correctamente:

0000: transacción cancelada correctamente 0001: esta transacción ya se canceló anteriormente
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Los tiempos en los que se aceptan las anulaciones depende de la red procesadora y las franquicias, en caso de tener dudas con respecto a las anulaciones pueden escribir a <support@payvalida.com>.
{% endhint %}