Saltar al contenido principal
Localpayment permite a los comerciantes procesar pagos seguros por transferencia bancaria a través de ETPAY, la principal pasarela de pago de Chile, que facilita las transferencias bancarias directas y la autenticación con las principales instituciones financieras chilenas. Esta guía describe el proceso para iniciar pagos basados en ETPAY a través de la API de Localpayment, detallando los parámetros requeridos, la gestión de las respuestas y la interpretación de los códigos de estado para una integración fluida con la infraestructura bancaria de Chile.

Antes de comenzar

Asegúrate de tener:
Solo se admiten pagos de personas físicas (Home Banking Personas)Este método de pago solo acepta pagos desde cuentas bancarias personales. Si payer.type se envía como COMPANY, la transacción será rechazada.

Paso 1. Crear pago con ETPAY

Para iniciar un pago ETPAY en Chile, envía una solicitud POST al endpoint Crear Payin con parámetros específicos de ETPAY.

Parámetros clave de la solicitud

La solicitud requiere varios objetos clave específicos para los pagos ETPAY de Chile: Consulta todos los parámetros disponibles en la solicitud.

Ejemplo de solicitud

A continuación se muestra un ejemplo que utiliza curl:
curl

Paso 2. Gestionar la respuesta

Respuesta exitosa

La creación exitosa de un pago con ETPAY incluye la URL de redireccionamiento y los detalles de la transacción:

Campos de respuesta clave

Respuesta de error

Cuando falla la creación del pago con ETPAY para Chile, recibirás información de error específica:

Paso 3. Gestionar el flujo de pagos de ETPAY

  1. Iniciación del pago: Redirigir al cliente a la URL de pago de ETPAY.
  2. Selección de banco: El cliente selecciona su banco chileno entre las instituciones admitidas.
  3. Autenticación bancaria: El cliente inicia sesión en su entorno de banca en línea.
  4. Autorización de pago: El cliente confirma el pago a través de su interfaz bancaria.
  5. Confirmación en tiempo real: Localpayment recibe la notificación de pago.
  6. Actualización de estado: Tu sistema recibe un webhook con la confirmación del pago.

Paso 4. Seguimiento del estado de la transacción

Supervisa el progreso de los pagos de ETPAY mediante estos métodos:

Webhooks (recomendado)

Recibe notificaciones en tiempo real cuando cambie el estado de la transacción. Más eficiente para entornos de producción.

Endpoint de la API de estado

Consulta el estado de las transacciones mediante programación. Útil para sondear o recuperar notificaciones de webhook perdidas.

Vista del Business Portal

Interfaz visual para el seguimiento de transacciones. Ideal para la supervisión manual y el análisis detallado de las transacciones.

Códigos de estado comunes

La API de Localpayment proporciona varios códigos de estado para indicar el progreso y el resultado del pago en la respuesta.
Referencia completaConsulta todos los códigos de estado en nuestra documentación sobre el estado de las transacciones.

Probando tu integración

Entorno de pruebas

Utiliza el entorno de prueba para realizar las pruebas:

Escenarios de prueba para Chile

Verifica que tu integración gestione estos escenarios:
  1. Pago exitoso: Flujo de pago completo de ETPAY con simulación bancaria.
  2. Autenticación bancaria: Prueba diferentes flujos de autenticación bancaria.
  3. Caducidad del pago: Gestionar la caducidad del enlace de pago de forma adecuada.
  4. Fallo de autenticación: Prueba de escenarios de inicio de sesión bancario fallidos.
  5. Rechazo bancario: Simula el rechazo de un pago por parte del banco.
  6. Actualizaciones de estado: Gestión de webhooks y sondeo de estado.

Próximos pasos

Tras implementar los pagos con ETPAY, ten en cuenta estas funcionalidades adicionales:

Reembolsar la transacción

Si es necesario, puedes reembolsar el pago al cliente. Consulta la documentación para obtener más detalles.

Revisar los detalles de la transacción

Puedes recuperar información sobre las transacciones utilizando la API de Localpayment para obtener información detallada.

Última modificación el 10 de noviembre de 2026