Transfer Out

Transfer Out te permite enviar fondos directamente a la cuenta bancaria de un destinatario (ACH) en Chile 🇨🇱: pagos a proveedores, payouts de marketplace, comisiones o cualquier flujo de dispersión.

Cómo funciona

Obtén la lista de bancos

Llama a GET /payouts/transfer/v1/bankList (o al endpoint v2) para obtener la lista de bancos de destino disponibles. Muestra esta lista para que el comercio o el operador de back-office pueda elegir el banco del destinatario.

Solicita un token de Transfer Out

Llama a POST /payouts/transfer/v1/tokens con los datos bancarios del destinatario y el monto de la dispersión. Devuelve un token.

{
  "documentType": "RUT",
  "documentNumber": "12345678-9",
  "accountType": "CC",
  "accountNumber": "00123456789",
  "bankId": "001",
  "totalAmount": 50000,
  "currency": "CLP",
  "name": "Catalina Fuentes",
  "mail": "user@example.com",
  "paymentDescription": "Pago proveedor"
}

Referencia de campos:

Campo	Obligatorio	Notas
`documentType`	Opcional	`RUT`: el único valor aceptado en Chile
`documentNumber`	Opcional	Número de documento del destinatario
`accountType`	✅	Consulta la tabla de tipos de cuenta más abajo
`accountNumber`	✅	Número de cuenta bancaria del destinatario
`bankId`	Opcional	Identificador del banco tomado de la lista de bancos
`totalAmount`	✅	Monto de la dispersión en CLP (entero)
`currency`	✅	`CLP`
`name`	Opcional	Nombre completo del destinatario. En Chile no se permiten caracteres especiales.
`mail`	Opcional	Correo electrónico del destinatario
`paymentDescription`	Opcional	Descripción de la transferencia. En Chile no se permiten caracteres especiales.

⚠️ Sin caracteres especiales: Chile no permite caracteres especiales en paymentDescription ni en name. Usa solo letras y números ASCII estándar.

Inicia la dispersión

Llama a POST /payouts/transfer/v1/init con el token y el monto. Una respuesta exitosa devuelve un ticketNumber y un transactionReference.

{
  "token": "AbCDef123456Z7Ghi8901234jkLMNopQ",
  "amount": {
    "subtotalIva": 0,
    "subtotalIva0": 50000,
    "iva": 0
  },
  "webhooks": [
    {
      "events": ["approvedTransaction", "declinedTransaction"],
      "urls": ["https://yoursite.com/kushki/payout-notify"]
    }
  ],
  "fullResponse": "v2"
}

Respuesta:

{
  "ticketNumber": "319228478889680318",
  "transactionReference": "6f16659e-b711-4995-a9ae-161aecbd6521",
  "status": "INITIALIZED"
}

Consulta el estado de la dispersión

Llama a GET /payouts/transfer/v1/transaction/{ticketNumber} para consultar el estado actual de la dispersión. La transferencia puede tardar en procesarse según el banco del destinatario.

{
  "ticketNumber": "319228478889680318",
  "transactionStatus": "APPROVAL",
  "totalAmount": 50000,
  "currency": "CLP",
  "bankId": "001",
  "documentType": "RUT",
  "documentNumber": "12345678-9"
}

Moneda

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

Tipos de cuenta

Valor	Descripción
`CC`	Cuenta Corriente
`CA`	Cuenta de Ahorro
`CV`	Cuenta Vista / RUT (Banco Estado)

ℹ️ CV — Banco Estado: envía el RUT del destinatario sin el dígito verificador. Para cualquier otro banco, envía el número de cuenta bancaria estándar.

Tipos de documento

Valor	Descripción
`RUT`	Rol Único Tributario 🇨🇱: el único tipo de documento aceptado en Chile

Valores de estado de la transacción

Estado	Descripción
`INITIALIZED`	Transferencia creada: en proceso con el banco
`APPROVAL`	Fondos dispersados correctamente
`PROCESSING`	El banco está procesando la transferencia
`DECLINED`	Transferencia rechazada por el banco del destinatario

Consulta tu saldo para dispersiones

Antes de iniciar dispersiones, verifica que tengas saldo suficiente en tu wallet de dispersiones de Kushki:

GET /wallet/v1/merchant/balance

{
  "currentBalance": 500000,
  "currency": "CLP",
  "balanceDate": 1748520000000
}

balanceDate es un timestamp Unix (en milisegundos).

Saldo insuficiente

Las operaciones de Transfer Out se financian con el saldo de tu wallet de Kushki. Asegúrate de que tu saldo cubra la dispersión antes de llamar al endpoint del token.

Webhooks

Incluye un array webhooks en la solicitud de init para recibir notificaciones de la dispersión en tiempo real:

{
  "webhooks": [
    {
      "events": ["approvedTransaction", "declinedTransaction"],
      "urls": ["https://yoursite.com/kushki/payout-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 de destino disponibles para dispersiones.

Obtener lista de bancos V2

Lista de bancos ampliada con metadata adicional.

Solicitar un token de Transfer Out

Tokeniza los datos bancarios del destinatario y el monto de la dispersión.

Iniciar transacción

Inicia la dispersión por transferencia bancaria. Devuelve un ticketNumber para el seguimiento.

Consultar estado

Consulta el estado actual de una dispersión por ticketNumber.

Saldo del comercio

Consulta el saldo actual de tu wallet de dispersiones en CLP.

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

Cómo funciona#

Moneda#

Tipos de cuenta#

Tipos de documento#

Valores de estado de la transacción#

Consulta tu saldo para dispersiones#

Webhooks#

Autenticación#

Uso de la API#

Endpoints disponibles#

Cómo funciona

Moneda

Tipos de cuenta

Tipos de documento

Valores de estado de la transacción

Consulta tu saldo para dispersiones

Webhooks

Autenticación

Uso de la API

Endpoints disponibles