Transfer In

Transfer In te permite aceptar pagos con transferencia bancaria en Chile 🇨🇱. El cliente es redirigido al portal de su banco para autorizar el pago y Kushki te notifica el resultado por webhook o consultando el estado.

Cómo funciona

(Opcional) Obtén la lista de bancos

Llama a GET /transfer/v1/bankList para obtener la lista de bancos disponibles. En Chile este paso es opcional: solo lo necesitas si quieres mostrarle al cliente un selector de banco antes de iniciar la transferencia.

Solicita un token de Transfer In

Llama a POST /transfer/v1/tokens con el monto, la callback URL y la identificación del cliente. Devuelve un token de un solo uso.

{
  "amount": {
    "subtotalIva": 0,
    "subtotalIva0": 10000,
    "iva": 0
  },
  "callbackUrl": "https://yoursite.com/transfer/return",
  "documentType": "RUT",
  "documentNumber": "12345678-9",
  "email": "user@example.com",
  "currency": "CLP"
}

Campo	Obligatorio	Notas
`amount`	✅	Solo montos enteros en CLP
`callbackUrl`	✅	URL a la que se redirige al cliente después del pago
`documentType`	✅	`CC`, `PP` o `RUT`
`documentNumber`	✅	Número de documento del cliente
`email`	✅	Correo del cliente para las notificaciones de la transacción
`currency`	✅	`CLP`
`userType`	Opcional	`"0"` = Persona natural, `"1"` = Persona jurídica
`bankId`	Opcional	Preselecciona un banco para el cliente
`paymentDescription`	Opcional	Descripción que aparece en el estado de cuenta bancario del cliente

Inicia la transacción

Llama a POST /transfer/v1/init con el token y el monto. La respuesta trae un redirectUrl: envía ahí al cliente para que complete el pago en el portal de su banco.

{
  "token": "AbCDef123456Z7Ghi8901234jkLMNopQ",
  "amount": {
    "subtotalIva": 0,
    "subtotalIva0": 10000,
    "iva": 0
  },
  "fullResponse": "v2"
}

Respuesta:

{
  "redirectUrl": "https://bank.cl/authorize/...",
  "transactionReference": "6f16659e-b711-4995-a9ae-161aecbd6521"
}

El cliente completa la transferencia

El cliente inicia sesión en el portal de su banco, revisa y confirma la transferencia. Al terminar, el banco lo redirige de vuelta a tu callbackUrl.

Consulta el estado de la transacción

Llama a GET /transfer/v1/status/{token} para obtener el resultado final de la transacción. Usa el token del paso 2 como path parameter.

{
  "status": "approvedTransaction",
  "ticketNumber": "319228478889680318",
  "documentType": "RUT",
  "documentNumber": "12345678-9"
}

Moneda

Moneda	Código	Notas
Peso chileno	`CLP`	Solo montos enteros: sin decimales

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
`initializedTransaction`	Transacción creada: el cliente fue redirigido al banco
`approvedTransaction`	Transferencia completada y confirmada
`declinedTransaction`	La transferencia fue rechazada

Webhooks

Incluye un objeto webhooks en tu solicitud de init para recibir notificaciones en tiempo real cuando cambie el estado de la transferencia:

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

Autenticación

Uso de la API

🟢 Producción

🧪 Sandbox (UAT)

https://api.kushkipagos.com/

Endpoints disponibles

Obtener lista de bancos

Obtén los bancos disponibles para Transfer In. Opcional en Chile.

Solicitar un token de Transfer In

Tokeniza la solicitud de transferencia con el monto, la moneda y la identificación del cliente.

Iniciar transacción

Inicializa la transferencia. Devuelve la URL de redirección al banco y el transaction reference.

Consultar estado

Consulta el resultado final de la transferencia con el token del paso de solicitud del token.

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

Cómo funciona#

Moneda#

Tipos de documento#

Valores de estado de la transacción#

Webhooks#

Autenticación#

Uso de la API#

Endpoints disponibles#