Skip to main content
POST
POST /payment/{id}/cancel anula una autorización antes de que se capture, liberando de inmediato la retención sobre los fondos del titular de la tarjeta. Usa esto cuando un pedido se cancela o no se puede cumplir después de que se colocó la autorización. Si el pago ya ha sido capturado y liquidado, usa Refund en su lugar — no puedes cancelar un pago capturado.

​
Identificar el pago

{id} es el id de pago de Therius devuelto por POST /payment/authorization y POST /payment/purchase. orderCode y paymentCode son tus propios campos de referencia y no se aceptan aquí. Un id desconocido o no propio devuelve 404.

​
Ejemplo

​
Cancelar una autorización

Este endpoint solo funciona para pagos en el estado authorized. Si el pago ya ha sido capturado, esta llamada devolverá un error. Usa Refund para devolver fondos en un pago capturado, o Cancel or Refund si no conoces el estado actual.
Cuando cancelas una autorización, el saldo disponible del titular de la tarjeta se restaura de inmediato del lado de Therius. El tiempo reflejado en el estado de cuenta bancario del titular de la tarjeta varía según el emisor — normalmente es de instantáneo a unas pocas horas, pero puede tardar de 3 a 5 días hábiles para algunos emisores.

Autorizaciones

​
Authorization
string
header
requerido

Your secret API key: Bearer prv_production_xxx (production) or Bearer prv_sandbox_xxx (sandbox).

Encabezados

​
Idempotency-Key
string<uuid>

A UUID you generate per operation. Required in production. Retrying with the same key returns the original response.

Parámetros de ruta

​
id
string<uuid>
requerido

The Therius payment id returned by POST /payment/authorization or POST /payment/purchase.

Cuerpo

application/json
​
merchantCode
string
requerido

Your merchant account identifier. Validated against the Bearer key's merchant; required if the key maps to more than one merchant account.

​
reference
string

Optional internal reference for this cancellation.

Respuesta

200 - application/json

Cancellation result

Result of a capture, refund, cancel or cancel_or_refund.

​
id
string

The Therius payment id.

​
merchantCode
string
​
orderCode
string
​
paymentCode
string

Therius receipt ID.

​
amount
object
​
status
enum<string>

Outcome of the operation.

Opciones disponibles:
captured,
refunded,
cancelled,
failed