API Direct (S2S)

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.

AspectoChile
MétodoTransferencia bancaria
transfer_methodCLP_TRANSFER
MonedaCLP
DestinoCuenta corriente o cuenta vista
Identificación del titularRUT

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" }
  }'
CampoObligatorioDescripción
operation_typesí"withdrawal"
transfer_methodsí"CLP_TRANSFER", el único método en Chile
currencysí"CLP"
amountsíUn número entero de pesos, como número o como texto
countryno"CL" (ISO alfa-2). Si se omite, toma el país de tu negocio
descriptionnoDescripción libre del retiro
beneficiarysíEl beneficiario chileno (abajo)
client_referencenoTu referencia interna. Funciona como en Retiros
metadatanoTus propios datos, como external_id. Se guardan y se devuelven tal cual

Beneficiario

CampoObligatorioDescripción
beneficiary.accountsíEl número de la cuenta bancaria chilena, solo dígitos
beneficiary.account_typesí"checking" (cuenta corriente) o "sight" (cuenta vista)
beneficiary.institutionsíEl id de institución del banco, como cl_banco_de_chile
beneficiary.namesíEl nombre completo del titular de la cuenta
beneficiary.tax_idsíEl RUT del titular, como 12.345.678-5
beneficiary.emailnoEl correo del beneficiario
  • account_type solo acepta checking y sight.
  • institution es el id de institución del banco, no su nombre ni un código bancario. La lista completa está en Referencia bancaria › Chile.
  • tax_id recibe el RUT con puntos y dígito verificador, como 12.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:

CasoEjemplo
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:

EstadoSignificadoWebhook
PendingCreado. Espera la aprobaciónwithdrawal_Pending
SuccessLa transferencia se completówithdrawal_Success
FailedLa transferencia fue rechazada, falló o fue devuelta. El retiro lleva decline_code y decline_reason, por ejemplo GS01 · General system errorwithdrawal_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_model y el comprobante CEP. Chile usa account, account_type, institution y el RUT.

Siguientes pasos

¿Te resultó útil esta página?

En esta página