Listar links de pago

Links del merchant en el modo de tu API key, del más reciente al más antiguo, con sus resultados.

GEThttps://api.kuti.pe/v1/payment-links

payments_count = pagos confirmados; checkouts_count = personas que llenaron sus datos; views_count = visitas a la página; amount_collected = total recaudado.

Query

Campo

Descripción

status

stringopcional

ACTIVE o INACTIVE.

q

stringopcional

Busca en título y slug.

page

integeropcional

Página (1-based).Ej: 1

per_page

integer | allopcional

Elementos por página (1–100) o all.Ej: 25

Language

Credentials

Header

Authorization

Secret key de developer · HTTP directo; SDK oficial → /sdks

Fetch Request

$ # Node 18+ fetch · SDK oficial: npm i @kuti-pe/node

const response = await fetch("https://api.kuti.pe/v1/payment-links?status=ACTIVE&per_page=25", {
  method: "GET",
  headers: {
    "Authorization": "Bearer kuti_live_…"
  }
});

const data = await response.json();
console.log(data);

HTTP directo · este endpoint aún no está en el SDK v1 → /sdks

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "data": [
    {
      "id": "plink_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "merchant_id": "mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "livemode": true,
      "slug": "taller-de-excel",
      "url": "https://pay.kuti.pe/l/taller-de-excel",
      "title": "Taller de Excel — sábado 10am",
      "description": "Tablas dinámicas y gráficos. Incluye certificado.",
      "image_url": null,
      "template": "COURSE",
      "pricing": "FIXED",
      "currency": "PEN",
      "amount": "120.00",
      "min_amount": null,
      "max_amount": null,
      "suggested_amounts": [],
      "payment_method_types": [
        "INTEROPERABLE_QR",
        "BANK_TRANSFER"
      ],
      "category_id": null,
      "status": "ACTIVE",
      "expires_at": null,
      "customer_fields": [
        {
          "id": "cfd_01J8Z3K4M5N6P7Q8R9S0T1U2V4",
          "key": "codigo_alumno",
          "label": "Código de alumno",
          "type": "TEXT",
          "options": [],
          "required": true,
          "help_text": null
        }
      ],
      "button_label": "Inscribirme",
      "success_message": "¡Listo! Te esperamos el sábado a las 10am.",
      "success_button_label": "Unirme al grupo",
      "success_button_url": "https://chat.whatsapp.com/AbCdEf123",
      "payments_count": 14,
      "checkouts_count": 19,
      "views_count": 132,
      "amount_collected": "1680.00",
      "created_at": "2026-09-24T15:02:11.000Z",
      "updated_at": "2026-09-25T09:40:03.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 1,
    "total_pages": 1
  }
}