Desvincular medio guardado

El medio deja de poder cobrarse de inmediato y se da de baja la afiliación.

DELETEhttps://api.kuti.pe/v1/customers/{id}/payment-methods/{payment_method_id}

Es idempotente: desvincular uno ya desvinculado devuelve el mismo recurso. Para volver a cobrarle así, tu cliente tiene que afiliar su Yape de nuevo. Emite payment_method.detached.

Path

Campo

Descripción

id

stringrequerido

Id del cliente en el path (cus_…).Ej: cus_01J8Z3K4M5N6P7Q8R9S0T1U2V3

payment_method_id

stringrequerido

Id del medio guardado en el path (pm_…).Ej: pm_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 result = await kuti.customers.detachPaymentMethod("cus_01J8Z3K4M5N6P7Q8R9S0T1U2V3", "pm_01J8Z3K4M5N6P7Q8R9S0T1U2V3");
console.log(result);

SDK oficial · guía en /sdks

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "data": {
    "id": "pm_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "merchant_id": "mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "customer_id": "cus_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "livemode": false,
    "type": "YAPE",
    "display": {
      "phone_last4": "4567"
    },
    "status": "DETACHED",
    "status_reason": "MERCHANT_REQUEST",
    "created_from_payment_intent_id": "pi_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "last_used_at": "2026-10-05T14:02:11.000Z",
    "created_at": "2026-10-01T15:20:41.000Z",
    "updated_at": "2026-10-20T16:11:09.000Z"
  }
}