> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ETPAY (Chile)

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:

* [Credenciales de API](https://docs.localpayment.com/es/docs/api-keys-and-environments.md) válidas (token de acceso).
* Consulta los [límites y las normas de las transacciones bancarias](https://docs.localpayment.com/es/docs/chile.md#payins-banking-transaction-limits-and-rules).

> [!WARNING]
>
> **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](https://docs.localpayment.com/es/reference/payins.md) 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:

| Objeto | Descripción | Requerido |
| - | - | - |
| `paymentMethod.type` | Debe ser `BankTransfer`. | ✅ |
| `paymentMethod.code` | Usa `2528` para ETPAY de Chile. | ✅ |
| `sender` | Información del remitente para fines de cumplimiento. | ✅ |
| `merchant` | Datos del comerciante/negocio. | ✅ |
| `paymentMethod` | Configuración del método de pago. | ✅ |
| `amount` | Importe de la transacción. | ✅ |
| `currency` | Código de moneda de la transacción. | ✅ |
| `country` | Debe ser `CHL`. | ✅ |

Consulta todos los [parámetros disponibles](https://docs.localpayment.com/es/reference/payins.md) en la solicitud.

### Ejemplo de solicitud

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

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request POST \
     --url https://api.stage.localpayment.com/api/payin/ \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer <your_access_token>' \
     --header 'content-type: application/json' \
     --data '
{
  "paymentMethod": {
    "type": "BankTransfer",
    "code": "2528",
    "flow": "REDIRECT"
  },
  "currency": "CLP",
  "merchant": {
    "type": "INDIVIDUAL",
    "document": {
      "type": "RUT",
      "id": "{{id}}"
    },
    "name": "John",
    "lastname": "Doe",
    "email": "merchant@mail.com"
  },
  "payer": {
    "type": "INDIVIDUAL",
    "document": {
      "type": "RUT",
      "id": "{{id}}"
    },
    "phone": {
      "areaCode": "57",
      "countryCode": "57",
      "number": "12345678"
    },
    "address": {
      "country": "CHL",
      "number": "",
      "state": "RM",
      "city": "RM",
      "street": "Street",
      "comment": ""
    },
    "bank": {
      "account": {
        "type": "c",
        "number": "{{bankAccountNumber}}"
      },
      "name": "Banco Estado",
      "code": "012"
    },
    "name": "John",
    "lastname": "Doe",
    "email": "john.doe@example.com"
  },
  "externalId": "c8b360f1-895e-483d-b734-e3ea17eb2b63",
  "country": "CHL",
  "amount": 100,
  "accountNumber": "{{AccountNumber}}",
  "conceptCode": "0038",
  "comment": "Payer"
}
'
```

***

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

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "transactionType": "PayIn",
  "externalId": "7e6c8cd9-55ea-4f94-8f05-f0e13fb24e78",
  "internalId": "6b9dfc0b-1fa0-44b4-a4ff-fd46007ae9a2",
  "paymentMethod": {
    "type": "BankTransfer",
    "code": "2528",
    "flow": "REDIRECT"
  },
  "country": "CHL",
  "currency": "CLP",
  "amount": 100,
  "accountNumber": "{{AccountNumber}}",
  "confirmed": {
    "currency": "CLP",
    "amount": 1,
    "fxQuote": 0
  },
  "payment": {
    "currency": "CLP",
    "fxQuote": 0,
    "financingFee": 0,
    "amount": 1
  },
  "localTaxes": [],
  "withHoldings": [],
  "fees": {
    "description": "Fee",
    "currency": "CLP",
    "fxSource": 1,
    "fxQuote": 1,
    "amount": 0,
    "account": "{{Account}}"
  },
  "status": {
    "code": "100",
    "description": "INPROGRESS",
    "detail": "The payin is pending the confirmation"
  },
  "merchant": {
    "type": "INDIVIDUAL",
    "name": "John",
    "lastname": "Doe",
    "document": {
      "type": "{{Type}}",
      "id": "{{documentId}}"
    },
    "email": "merchant@mail.com"
  },
  "payer": {
    "bank": {
      "name": "Banco Estado",
      "code": "012",
      "account": {
        "type": "c",
        "number": "{{Number}}"
      }
    },
    "type": "INDIVIDUAL",
    "name": "John",
    "lastname": "Doe",
    "document": {
      "type": "RUT",
      "id": "{{documentId}}"
    },
    "email": "john.doe@example.com",
    "phone": {
      "countryCode": "57",
      "areaCode": "57",
      "number": "3196741234"
    },
    "address": {
      "street": "Calle 123",
      "number": "0012",
      "city": "RM",
      "state": "RM",
      "country": "CHL",
      "comment": ""
    }
  },
  "intermediaries": [],
  "wireInstructions": {
    "referenceCode": "FDEG-HVCF-JUWX"
  },
  "date": {
    "creationDate": "2024-12-01T15:44:55.058+00:00",
    "processedDate": "2024-12-01T15:45:01.4368519",
    "expirationDate": "2024-12-08T15:44:55.4677488"
  },
  "redirectUrl": "https://web-checkout.stage.localpayment.com/redirect/aHR0cHM6Ly9wbXQtc2FuZGJveC5ldHBheS5jb20vc2Vzc2lvbi9mT09OZkdvcEVuM1F4RUs4aUZKcWVEdGpadDU5T3ExcjhOamNUM213aFNFbjN0S2sxSzNLcXVtUjk5dTFKTFVS",
  "errors": []
}
```

### Campos de respuesta clave

| Parámetro | Descripción | Caso de uso |
| - | - | - |
| `redirectUrl` | URL para redirigir al cliente al flujo de pago de ETPAY. | Dirige al cliente a la autenticación bancaria y al procesamiento del pago. |
| `wireInstructions.referenceCode` | Código de referencia de pago único. | Mostrar al cliente para el seguimiento del pago. |
| `externalId` | Tu número de referencia original. | Conciliación interna y cotejo de pedidos. |
| `status.code` | Estado actual de la transacción (`100` = `INPROGRESS`) | Determinar los siguientes pasos en el flujo de pagos. |
| `date.creationDate` | Cuando se creó la transacción. | Análisis y seguimiento del rendimiento. |

#### Respuesta de error

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

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "externalId": "ce0aaa1a-4532-43b9-930a-26e780aba99b",
  "status": {
    "code": "812",
    "description": "REJECTED"
  },
  "errors": [
    {
      "code": "812",
      "detail": "External Id already used - duplication"
    }
  ]
}
```

***

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

> [card] [Webhooks (recomendado)](https://docs.localpayment.com/es/docs/webhooks.md)
>
> Recibe notificaciones en tiempo real cuando cambie el estado de la transacción. Más eficiente para entornos de producción.

> [card] [Endpoint de la API de estado](https://docs.localpayment.com/es/reference/get-transaction-status.md)
>
> Consulta el estado de las transacciones mediante programación. Útil para sondear o recuperar notificaciones de webhook perdidas.

> [card] [Vista del Business Portal](https://docs.localpayment.com/es/docs/dashboard-overview.md)
>
> 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.

| Código | Estado | Descripción |
| :- | :- | :- |
| `103` | `APPROVED` | El payin se confirmó, pero aún no se ha abonado. |
| `200` | `Completed` | El payin se ha completado. |
| `811` | `Rejected` | El monto solicitado es mayor o menor que los valores máximos/mínimos permitidos. |

> [!NOTE]
>
> **Referencia completa**
>
> Consulta todos los códigos de estado en nuestra [documentación sobre el estado de las transacciones](https://docs.localpayment.com/es/reference/transaction-status-error-codes).

***

## Probando tu integración

### Entorno de pruebas

Utiliza el entorno de prueba para realizar las pruebas:

```
https://api.stage.localpayment.com/api/payin/
```

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

> [card] [Reembolsar la transacción](https://docs.localpayment.com/es/docs/refund-apm-payment.md)
>
> Si es necesario, puedes reembolsar el pago al cliente. Consulta la documentación para obtener más detalles.

> [card] [Revisar los detalles de la transacción](https://docs.localpayment.com/es/reference/get-transaction-status.md)
>
> Puedes recuperar información sobre las transacciones utilizando la API de Localpayment para obtener información detallada.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.