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.
Slots de fondeo y Banking
El mismo corredorCL/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.
Recibir CLP en una cuenta virtual
1. Confirma el corredor
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:201:
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áspayin_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).
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 sonpayin_credited y
payout_status_changed.
¿Es igual al checkout fintoc?
¿Es igual al checkout fintoc?
No. El checkout devuelve
payment_url; Business Accounts emite un número
reutilizable y relaciona transferencias por ese número.¿Puedo usar decimales?
¿Puedo usar decimales?
No hay centavos en CLP. Solo se aceptan fracciones compuestas por ceros,
como
"100.00".¿Debo reintentar un timeout?
¿Debo reintentar un timeout?
No. Reutiliza la misma idempotency key y consulta la operación original.
¿Por qué yo no soy el titular de la cuenta dedicada?
¿Por qué yo no soy el titular de la cuenta dedicada?
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.