Reanudar suscripción

Vuelve a cobrar desde el próximo periodo.

POSThttps://api.kuti.pe/v1/subscriptions/{id}/resume

Si quedó un periodo sin pagar de antes, vuelve como PAST_DUE. Emite subscription.resumed.

Path

Campo

Descripción

id

stringrequerido

Id de la suscripción en el path (sub_…).Ej: sub_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.subscriptions.resume("sub_01J8Z3K4M5N6P7Q8R9S0T1U2V3");
console.log(result.status);

SDK oficial · guía en /sdks

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "data": {
    "id": "sub_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "merchant_id": "mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "livemode": false,
    "customer": {
      "id": "cus_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "name": "María López",
      "email": "maria@example.pe",
      "phone": "+51987654567"
    },
    "description": "Plan Pro",
    "billing_mode": "fixed",
    "amount": {
      "amount": "99.00",
      "currency": "PEN"
    },
    "setup_url": null,
    "items": [
      {
        "description": "Plan Pro",
        "unit_amount": "99.00",
        "quantity": 1,
        "amount": "99.00"
      }
    ],
    "frequency": "MONTHLY",
    "interval": 1,
    "day_of_month": 5,
    "last_day_of_month": false,
    "day_of_week": null,
    "start_date": "2026-10-05",
    "end_date": null,
    "charge_time": "09:00",
    "next_charge_at": "2026-11-05T14:00:00.000Z",
    "status": "ACTIVE",
    "payment_method": {
      "id": "pm_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "type": "YAPE",
      "phone_last4": "4567",
      "status": "ACTIVE"
    },
    "retry_policy": {
      "interval_days": [
        1,
        3,
        5
      ],
      "on_exhausted": "past_due"
    },
    "latest_cycle": {
      "id": "subc_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "billing_period": "2026-10",
      "due_date": "2026-10-05",
      "amount": {
        "amount": "99.00",
        "currency": "PEN"
      },
      "status": "PAID",
      "attempts": 1,
      "last_failure_code": null,
      "next_attempt_at": null,
      "payment_intent_id": "pi_01J8Z3K4M5N6P7Q8R9S0T1U2V5",
      "checkout_url": null,
      "paid_at": "2026-10-05T14:00:03.000Z"
    },
    "external_reference": "cliente-4821",
    "metadata": {},
    "cancelled_at": null,
    "created_at": "2026-10-05T14:00:00.000Z",
    "updated_at": "2026-10-05T14:00:03.000Z"
  }
}