Ir al contenido

Movimientos del saldo

Ledger del negocio: cada cobro, reembolso, payout o contracargo que afecta el saldo, con desglose de comisión.

GEThttps://api.kuti.pe/v1/balance-transactions
type: PAYMENT, REFUND, PAYOUT, ADJUSTMENT, CHARGEBACK. status: PENDING, AVAILABLE, IN_PAYOUT, PAID. Filtra por payout_id para ver lo incluido en un depósito.

Query

type
stringopcional
PAYMENT | REFUND | PAYOUT | ADJUSTMENT | CHARGEBACK.
payout_id
stringopcional
Solo movimientos de ese payout (pyt_…).Ej: pyt_01J8Z3K4M5N6P7Q8R9S0T1U2V3
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/balance-transactions?page=1&per_page=25&type=PAYMENT' \
  -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": "btxn_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "type": "PAYMENT",
      "status": "AVAILABLE",
      "currency": "PEN",
      "payment_method": "INTEROPERABLE_QR",
      "source_type": "PAYMENT",
      "source_id": "pay_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
      "gross": {
        "amount": "50.00",
        "currency": "PEN"
      },
      "fee": {
        "amount": "-1.77",
        "currency": "PEN"
      },
      "fee_tax": {
        "amount": "-0.27",
        "currency": "PEN"
      },
      "net": {
        "amount": "48.23",
        "currency": "PEN"
      },
      "available_on": "2026-09-06T00:00:00Z",
      "available_confirmed": true,
      "created_at": "2026-09-04T10:48:59.556906Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 1,
    "total_pages": 1,
    "has_more": false
  }
}