Cancelar pago

API v0.1.0

En esta página

Cancela un intent en estado created. Solo modo backend (requiere sk_). No se puede cancelar desde el navegador.

Endpoint

POST/v1/payments/{intent_id}/cancel

Body vacío. Solo header Authorization:

bash

curl -X POST https://rutiva-api.onrender.com/v1/payments/$INTENT_ID/cancel \
  -H "Authorization: Bearer sk_live_xxxx"

Respuesta 200

json

{
  "id": "8d3a4b5c-2e74-41f6-a091-f7036f8d6a8c",
  "external_id": "pi_L9limdfjZ6SHJjpkXueO1w",
  "status": "canceled",
  "canceled_at": "2026-05-13T15:16:00"
}

Errores

HTTP	detail	Causa
400	`invalid_state:<estado>`	Solo se cancela en created. Si ya succeeded/failed/canceled → 400.
401	`invalid_api_key`	sk_ falta o inválida.
404	`payment_intent_not_found`	No existe o no pertenece al merchant autenticado.

Webhook emitido

Cancelar dispara el evento payment_intent.canceled a tus endpoints suscritos.