Saltar al contenido principal
Esta guía cubre el método fintoc para pesos chilenos (CLP). Es provider-agnostic: tu integración recibe una cuenta virtual de depósito y usa el contrato normal de payouts. No cambia el corredor existente CL/CLP/bank_transfer.
CLP no tiene unidad menor. Envía pesos enteros positivos, por ejemplo "150000"; "150000.50" responde 400 invalid_amount.

Slots de fondeo y Banking

El mismo corredor CL/CLP/fintoc admite ambos propósitos sin cambiar la forma de respuesta (purpose, label, balance derivado y movimientos):
  • purpose: "fondeo" (por defecto) convierte el abono CLP al saldo principal.
  • purpose: "banking" recibe, retiene y exhibe el saldo CLP derivado del instrumento. No origina payouts: los payouts CL siempre salen desde la cuenta root y no aplica un flag físico de sweep-exempt.
Las empresas pueden crear cuentas adicionales de fondeo o Banking con una idempotency key distinta por cuenta; Banking tiene tope de 50 instrumentos por empresa/corredor. Las personas pueden crear la segunda virtual Banking en este corredor. Repetir una key reproduce la cuenta original.

Recibir CLP en una cuenta virtual

1. Confirma el corredor

Usa method: "fintoc" para la cuenta virtual. El checkout hospedado existente también usa method: "fintoc" en POST /v1/payins, pero es otro flujo y devuelve payment_url.

2. Emite la cuenta

La emisión automática ocurre después de KYC/KYB aprobado. Una empresa puede hacer backfill para una cuenta faltante usando el mismo endpoint:
Respuesta 201:
Muestra al pagador exactamente el número, banco, nombre, RUT y tipo devueltos. No infieras un banco por su nombre ni reemplaces el RUT. El titular es la empresa dueña del CPF usado para la cuenta dedicada, no el pagador ni el usuario final.

3. Concilia el abono

CBPay relaciona el abono por el número de cuenta virtual. Acepta el webhook y usa polling como respaldo idempotente. Recibirás payin_credited al acreditar:

Enviar un payout CLP

bank_code acepta el código SBIF numérico del catálogo, por ejemplo "0012", o una billetera ruteada como "cl_mach". El número de cuenta debe tener solo dígitos y account_type debe ser checking (corriente) o sight (vista).
La respuesta 202 queda en processing. Consulta GET /v1/payouts/{payoutID} o usa payout_status_changed. partially_succeeded sigue en processing e informa lo liquidado y el remanente; crea un payout nuevo solo por el remanente después de revisarlo. reversed, returned, failed y rejected son resultados fallidos. Ante timeout no se reenvía: usa la misma idempotency key y concilia.

Estados y errores

Webhooks

Verifica la firma, deduplica por delivery ID, responde rápido y consulta el recurso. Los eventos relevantes son payin_credited y payout_status_changed.
No. El checkout devuelve payment_url; Business Accounts emite un número reutilizable y relaciona transferencias por ese número.
No hay centavos en CLP. Solo se aceptan fracciones compuestas por ceros, como "100.00".
No. Reutiliza la misma idempotency key y consulta la operación original.
Los números de cuenta CLP dedicados se emiten para la empresa dueña del CPF. El pagador o usuario final no es el titular. Muestra los campos de titular devueltos por CBPay sin reemplazarlos.
Consulta webhooks, errores e idempotencia.
Última modificación el 31 de octubre de 2026