Anular cobro

Cancela un payment intent. Pasa a status CANCELLED.

POSThttps://api.kuti.pe/v1/payment-intents/{id}/cancel

Si el cobro ya está pagado, procesando o en un estado que no admite anulación, responde 409.

Path

Campo

Descripción

id

stringrequerido

Id del cobro en el path (pi_…).Ej: pi_01J8Z3K4M5N6P7Q8R9S0T1U2V3

Language

Credentials

Header

Authorization

Secret key de developer · ejemplos con SDK oficial

API Request

$ npm install @kuti-pe/node

import { KutiClient } from "@kuti-pe/node";

const kuti = new KutiClient({ secretKey: process.env.KUTI_SECRET_KEY! });

const intent = await kuti.paymentIntents.cancel("pi_01J8Z3K4M5N6P7Q8R9S0T1U2V3");
console.log(intent.status);

SDK oficial · guía en /sdks

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "message": "Payment intent cancelled",
  "data": {
    "id": "pi_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "merchant_id": "mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "livemode": true,
    "customer": {
      "id": "cus_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "type": "INDIVIDUAL",
      "first_name": "María",
      "last_name": "López",
      "name": "María López"
    },
    "amount": {
      "amount": "50.00",
      "currency": "PEN"
    },
    "status": "CANCELLED",
    "payment_method_types": [
      "INTEROPERABLE_QR"
    ],
    "description": "Pedido #1042",
    "created_at": "2026-09-04T10:48:59.556906Z"
  }
}