Retiros en Chile (CLP)
Envía pesos chilenos a una cuenta corriente o cuenta vista por transferencia bancaria: la petición, el beneficiario chileno, montos en pesos enteros, errores de validación y estados.
Los retiros en Chile envían pesos chilenos (CLP) desde tu saldo a una cuenta bancaria chilena
—una cuenta corriente (checking) o una cuenta vista (sight)— por transferencia
bancaria. El titular de la cuenta se identifica con su RUT.
El ciclo es el mismo que en Retiros: solo cambia el beneficiario. En lugar de una CLABE y un código de Banxico, envías el número de cuenta, su tipo, el id de institución del banco y el RUT del titular.
Tonder elige el riel. Tonder resuelve la institución que ejecuta la transferencia a partir de la configuración de tu cuenta. No necesitas conocerla ni construir lógica sobre ella.
| Aspecto | Chile |
|---|---|
| Método | Transferencia bancaria |
transfer_method | CLP_TRANSFER |
| Moneda | CLP |
| Destino | Cuenta corriente o cuenta vista |
| Identificación del titular | RUT |
Montos
CLP no tiene parte decimal. Envía amount como un número entero de pesos, como número o como
texto: 50000 o "50000" equivale a CLP 50.000. Un monto con decimales, como 50000.50, se
rechaza con 400.
Crear un retiro
Envía el retiro a POST /api/v1/process/ con operation_type: "withdrawal",
transfer_method: "CLP_TRANSFER", currency: "CLP" y un beneficiary chileno:
curl -X POST "https://stage.tonder.io/api/v1/process/" \
-H "Authorization: Token YOUR_TEST_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Request-Id: 3f2b8c1e-6d4a-4e7b-9a10-5c8d2e7f4b61" \
-d '{
"operation_type": "withdrawal",
"transfer_method": "CLP_TRANSFER",
"currency": "CLP",
"amount": "50000",
"country": "CL",
"description": "Pago a Juan Perez",
"client_reference": "payout-001",
"beneficiary": {
"account": "1530078100",
"account_type": "checking",
"institution": "cl_banco_de_chile",
"name": "Juan Perez",
"tax_id": "12.345.678-5",
"email": "juan.perez@email.com"
},
"metadata": { "external_id": "payout-001" }
}'curl -X POST "https://app.tonder.io/api/v1/process/" \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Request-Id: 3f2b8c1e-6d4a-4e7b-9a10-5c8d2e7f4b61" \
-d '{
"operation_type": "withdrawal",
"transfer_method": "CLP_TRANSFER",
"currency": "CLP",
"amount": "50000",
"country": "CL",
"description": "Pago a Juan Perez",
"client_reference": "payout-001",
"beneficiary": {
"account": "1530078100",
"account_type": "checking",
"institution": "cl_banco_de_chile",
"name": "Juan Perez",
"tax_id": "12.345.678-5",
"email": "juan.perez@email.com"
},
"metadata": { "external_id": "payout-001" }
}'| Campo | Obligatorio | Descripción |
|---|---|---|
operation_type | sí | "withdrawal" |
transfer_method | sí | "CLP_TRANSFER", el único método en Chile |
currency | sí | "CLP" |
amount | sí | Un número entero de pesos, como número o como texto |
country | no | "CL" (ISO alfa-2). Si se omite, toma el país de tu negocio |
description | no | Descripción libre del retiro |
beneficiary | sí | El beneficiario chileno (abajo) |
client_reference | no | Tu referencia interna. Funciona como en Retiros |
metadata | no | Tus propios datos, como external_id. Se guardan y se devuelven tal cual |
Beneficiario
| Campo | Obligatorio | Descripción |
|---|---|---|
beneficiary.account | sí | El número de la cuenta bancaria chilena, solo dígitos |
beneficiary.account_type | sí | "checking" (cuenta corriente) o "sight" (cuenta vista) |
beneficiary.institution | sí | El id de institución del banco, como cl_banco_de_chile |
beneficiary.name | sí | El nombre completo del titular de la cuenta |
beneficiary.tax_id | sí | El RUT del titular, como 12.345.678-5 |
beneficiary.email | no | El correo del beneficiario |
account_typesolo aceptacheckingysight.institutiones el id de institución del banco, no su nombre ni un código bancario. La lista completa está en Referencia bancaria › Chile.tax_idrecibe el RUT con puntos y dígito verificador, como12.345.678-5. Tonder lo valida, incluido el dígito verificador.
Errores de validación
La petición se rechaza con 400, antes de cualquier aprobación, cuando:
| Caso | Ejemplo |
|---|---|
currency no es "CLP" | "currency": "USD" |
amount tiene parte decimal | "amount": "50000.50" |
Falta beneficiary.account | — |
beneficiary.account_type no es checking ni sight | "account_type": "savings" |
Falta beneficiary.institution | — |
Falta beneficiary.name | — |
Falta beneficiary.tax_id o no es un RUT válido | "tax_id": "12.345.678-0" |
Estados
Un retiro en Chile queda en Pending al crearse. Cuando se aprueba —tú o una regla de aprobación
automática— se envía la transferencia, y el estado final refleja el resultado:
| Estado | Significado | Webhook |
|---|---|---|
Pending | Creado. Espera la aprobación | withdrawal_Pending |
Success | La transferencia se completó | withdrawal_Success |
Failed | La transferencia fue rechazada, falló o fue devuelta. El retiro lleva decline_code y decline_reason, por ejemplo GS01 · General system error | withdrawal_Failed |
Una transferencia devuelta termina en Failed en Chile, no en Returned como en México.
Concilia cada retiro Failed como dinero que no llegó al beneficiario y lee decline_reason para
conocer la causa.
Después de crearlo
Todo lo que sigue a la petición funciona como en Retiros: la
respuesta con sus dos identificadores, id y withdrawal_id; la
aprobación; las
consultas; y los
webhooks. Los retiros en Chile se crean con el endpoint
unificado, POST /api/v1/process/.
No disponible en Chile
- Pagos a tarjeta de débito. Chile solo admite transferencia bancaria.
- Los campos de México: CLABE,
rfc, códigos de institución de Banxico,fee_modely el comprobante CEP. Chile usaaccount,account_type,institutiony el RUT.
Siguientes pasos
Retiros
Envía dinero a un beneficiario por SPEI o tarjeta de débito, apruébalo y síguelo hasta la liquidación: las dos vías de creación, los dos vocabularios de estados, los webhooks y los datos de prueba.
Resumen y cuándo usarlo
Combina SDK o Hosted para tarjetas con API Direct para APMs y retiros, sin alcance PCI.
