Cash In

Cash In te permite aceptar pagos en efectivo en Chile 🇨🇱. El cliente recibe un PIN (y, opcionalmente, un comprobante en PDF) que presenta en un punto de recaudo de Payvalida (una red de tiendas, farmacias y locales de conveniencia aliados) para completar el pago de forma presencial.

El cliente no necesita cuenta bancaria ni tarjeta.

Cómo funciona

Solicita un token de Cash In

Llama a POST /cash/v1/tokens con la identificación del cliente y el monto del pago. Devuelve un token de un solo uso.

{
  "name": "Catalina",
  "lastName": "Fuentes",
  "identification": "12345678-9",
  "documentType": "RUT",
  "email": "user@example.com",
  "totalAmount": 10000,
  "currency": "CLP",
  "description": "Pago en efectivo"
}

Referencia de campos:

Campo	Obligatorio	Notas
`name`	✅	Nombre del cliente
`lastName`	✅	Apellido del cliente
`identification`	✅	Número de documento del cliente
`documentType`	✅	`CC`, `PP` o `RUT`
`email`	Opcional	Correo del cliente para las notificaciones
`totalAmount`	✅	Monto en CLP (entero)
`currency`	✅	`CLP`: este paso del token solo acepta CLP (consulta Moneda)
`description`	Opcional	Descripción que aparece en el comprobante

Inicia la transacción

Llama a POST /cash/v1/charges/init con el token y el monto. La respuesta entrega un pin que el cliente usa en el punto de recaudo, además de un pdfUrl con el comprobante para imprimir.

{
  "token": "AbCDef123456Z7Ghi8901234jkLMNopQ",
  "amount": {
    "subtotalIva": 0,
    "subtotalIva0": 10000,
    "iva": 0,
    "ice": 0,
    "currency": "CLP"
  },
  "expirationDate": "2026-06-30 23:59:59",
  "webhooks": [
    {
      "events": ["approvedTransaction", "declinedTransaction"],
      "urls": ["https://yoursite.com/kushki/cash-notify"]
    }
  ],
  "fullResponse": "v2"
}

Respuesta:

{
  "pin": "8346680862",
  "pdfUrl": "https://api-uat.kushkipagos.com/cash/v1/charges/2358346676119533/receipt",
  "ticketNumber": "2358346676119533",
  "transactionReference": "c0311aac-eb0c-4312-838d-9de50218532e"
}

⚠️ Expiración del pin: el campo expirationDate fija el plazo para que el cliente pague. Después de esa fecha, el PIN ya no es válido en el punto de recaudo.

El cliente paga en un punto de recaudo

Comparte el pin con el cliente (y, si quieres, el enlace al comprobante pdfUrl). El cliente visita cualquier local aliado de Payvalida y presenta el PIN para completar el pago en efectivo.

Consulta el estado de la transacción

Llama a GET /cash/v1/status/{ticketNumber} para verificar el resultado del pago.

{
  "ticketNumber": "2347529752172881",
  "status": "approvedTransaction",
  "totalAmount": 10000,
  "currency": "CLP",
  "name": "Catalina",
  "lastName": "Fuentes",
  "documentType": "RUT",
  "identification": "12345678-9",
  "processorName": "Payvalida Processor",
  "pin": "7929926379"
}

Moneda

Moneda	Código	Notas
Peso chileno	`CLP`	Solo montos enteros: sin decimales
Unidad de Fomento	`UF`	Unidad de cuenta indexada: se acepta en `amount.currency` en el paso de Init Transaction. El paso del token (`POST /cash/v1/tokens`) solo acepta `CLP`.

Tipos de documento

Valor	Descripción
`CC`	Cédula de Identidad 🇨🇱
`PP`	Pasaporte 🇨🇱
`RUT`	Rol Único Tributario 🇨🇱

Valores de estado de la transacción

Estado	Descripción
`approvedTransaction`	Pago confirmado en el punto de recaudo
`initializedTransaction`	PIN emitido: el cliente aún no ha pagado
`declinedTransaction`	Pago declinado
`expiredTransaction`	El PIN expiró antes de que el cliente pagara

Webhooks

Incluye un array webhooks en la solicitud de init para recibir notificaciones de pago en tiempo real:

{
  "webhooks": [
    {
      "events": ["approvedTransaction", "declinedTransaction"],
      "urls": ["https://yoursite.com/kushki/cash-notify"]
    }
  ]
}

Kushki envía una notificación cuando el cliente completa el pago en efectivo en el punto de recaudo.

Valores de prueba en Sandbox

Usa los siguientes valores de identification al tokenizar en el ambiente UAT:

identification	Resultado
Cualquier valor válido	Transacción exitosa
`9999999999`	Estado `initializedTransaction` (pago pendiente)
`1000000000`	Transacción declinada

Autenticación

Uso de la API

🟢 Producción

🧪 Sandbox (UAT)

https://api.kushkipagos.com/

Endpoints disponibles

Solicitar un token de Cash In

Tokeniza la identificación del cliente y el monto del pago. Devuelve un token de un solo uso.

Iniciar transacción

Inicia el pago en efectivo. Devuelve el PIN para el cliente y la URL del comprobante en PDF.

Consultar estado

Verifica si el cliente completó el pago en efectivo en un punto de recaudo.

¿Tienes una sugerencia sobre esta documentación? Escríbenos.

Cómo funciona#

Moneda#

Tipos de documento#

Valores de estado de la transacción#

Webhooks#

Kushki envía una notificación cuando el cliente completa el pago en efectivo en el punto de recaudo.#

Valores de prueba en Sandbox#

Autenticación#

Uso de la API#

Endpoints disponibles#