DESCANSO REST

Descripción general#

Portal Carat oferece servicios para cancelar (revertir) un pago.

Por razones de seguridad, este flujo requiere un paso de autenticidad, donde Portal Carat realiza un POST en la URL de autenticidad registrada de la tienda con los datos necesarios para continuar el flujo y realizar el contracargo real.

Y para saber más sobre estas nomenclaturas (Bin, Software Express, Carat, e-Sitef) Leer más

Descripción del flujo:

  • 1 . El comerciante inicia una cancelación pasando el esitef_usn de la transacción deseada (campo devuelto por Portal Carat después de aprobar el pago). En caso de éxito, Portal Carat devolverá el código y mensaje correspondientes.
    • 1.1 . Durante la llamada de creación de contracargo, Pagamento Online hará una POST la URL de autenticidad registrada en la tienda con el NIT de la transacción de cancelación. La tienda debe responder a este POST con un código HTTP 200 (OK). Si no se devuelve este código, Portal Carat interpretará esta operación como una falla e invalidará el NIT.
  • 2. La tienda virtual continúa el flujo llamando al servicio de cancelación, pasando el NIT obtenido en el POST de autenticidad y datos adicionales que pueden ser necesarios según el comprador en cuestión (como el número de tarjeta, en caso de pagos vía SiTef). Si no ocurre ningún problema, Portal Carat devolverá un mensaje de éxito y los datos de la operación de anulación.

Consulta de cancelaciones#

La información de la transacción de cancelación se puede consultar a través del mismo servicio que utiliza la interfaz de pago REST. Más información