Ir al contenido

Listar cobros

Lista los payment intents (cobros) del merchant autenticado. Del más reciente al más antiguo.

GEThttps://api.kuti.pe/v1/payment-intents
status: REQUIRES_PAYMENT_METHOD, PENDING, PROCESSING, SUCCEEDED, FAILED, CANCELLED, EXPIRED. El modo (test/live) lo define tu API key.

Query

status
stringopcional
Filtra por estado del cobro.
q
stringopcional
Busca por cliente: nombre, documento, correo o teléfono.
customer_id
stringopcional
Solo cobros de este cliente (cus_…).
created_from
stringopcional
Desde (UTC ISO-8601), inclusive.Ej: 2026-09-01T00:00:00Z
created_to
stringopcional
Hasta (UTC ISO-8601), inclusive.Ej: 2026-09-30T23:59:59Z
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 · ejemplos con librerías estándar (aún sin SDK)

cURL Request
curl -s 'https://api.kuti.pe/v1/payment-intents?page=1&per_page=25&status=PENDING' \
  -H 'Authorization: Bearer kuti_live_…'
Librería estándar · sin SDK propio
Response

Elige un ejemplo de respuesta:

application/json
200OK
{
  "success": true,
  "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": "PENDING",
      "payment_method_types": [
        "INTEROPERABLE_QR"
      ],
      "checkout_url": "https://pay.kuti.pe/c/A3F9K2P7QM",
      "description": "Pedido #1042",
      "created_at": "2026-09-04T10:48:59.556906Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 1,
    "total_pages": 1,
    "has_more": false
  }
}