Anulaciones

Este servicio permite anular pagos realizados a través de tarjeta de crédito/débito; al anular un pago el monto total es devuelto al usuario en su tarjeta.

Para utilizar este servicio tanto en producción como en el entorno de pruebas (sandbox), debes ponerte en contacto con [e-mail] para solicitar su activación.

Producción: https://api.payvalida.com/v4/merchant/transaction/cancel

Sandbox: https://api-test.payvalida.com/v4/merchant/transaction/cancel

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

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)

Request

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

Response

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

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.

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

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 [e-mail].