Local API

Cancelar pago o devolución

Interrumpe el pago o la devolución que el terminal está ejecutando en ese momento.

POST/device-bridge/payments/:ref/abort

Esta llamada va firmada: consulta Autenticación.

Interrumpe el cobro o la devolución que el terminal está ejecutando en ese momento, por ejemplo si el cliente se arrepiente mientras el terminal espera la tarjeta. :ref es el ref con el que iniciaste ese pago o esa devolución.

Solo es posible si el terminal lo permite: en ese caso, la respuesta 202 al iniciar la operación y las consultas de estado mientras sigue en processing incluyen abortable: true.

Cuerpo

JSON

{
    "counter": 3,
    "hmac": "<firma calculada>"
}

Nombre	Tipo	Descripción
`counter`	number	Consulta Autenticación.
`hmac`	string	Consulta Autenticación.

Respuesta

202 Accepted

JSON

{
    "ref": "abc123",
    "status": "abort_requested",
    "hmac": "<firma>"
}

El terminal ha pedido al lector de tarjetas que interrumpa la operación, pero esta respuesta no es el resultado. Sigue consultando el estado con el mismo ref hasta que deje de estar en processing: normalmente acabará en cancelled o declined. Si el cliente ya había pagado, puede acabar en completed.

400 Bad Request

JSON

{
    "ref": "abc123",
    "reason": "abort_not_supported"
}

Se devuelve si este modelo de terminal no permite interrumpir operaciones.

404 Not Found

JSON

{
    "ref": "abc123",
    "reason": "not_found"
}

Se devuelve si el terminal no conoce el ref.

409 Conflict

JSON

{
    "ref": "abc123",
    "reason": "not_in_progress"
}

Se devuelve si la operación de ese ref ya ha terminado o si no es la que el terminal está ejecutando ahora.

Otro valor posible de reason: abort_failed, si el lector de tarjetas no ha podido interrumpir la operación. En ese caso, sigue en curso: consulta su estado.