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

# El objeto Campos

Explora el objeto Fields para crear formularios de pago. Esta referencia detalla las funciones fields.create(), field.mount() y el manejo de eventos.

Después de crear un campo con `localpayment.create()`, puedes utilizar los siguientes métodos en el objeto devuelto.

| Método | Descripción | Ejemplo |
| - | - | - |
| `mount(selector)` | Monta el iframe del campo en el contenedor DOM especificado. | `panField.mount('#card-number-container');` |
| `unmount()` | Elimina el iframe del campo del DOM. | `panField.unmount();` |
| `clear()` | Borra el valor actual del campo. | `panField.clear();` |
| `focus()` | Centra la atención en el campo. | `panField.focus();` |
| `blur()` | Elimina la atención del campo. | `panField.blur();` |
| `on(event, callback)` | Registra una función de devolución de llamada para un evento específico en este campo. | `panField.on('change', (state) => { … });` |

### Tipos de campos

Los siguientes tipos de campo están disponibles para crear mediante el método `create()`.

| Tipo de campo | Parámetro de `create()` | Descripción | Ejemplo de salida |
| - | - | - | - |
| Número de tarjeta | `'pan'` | Introduce el número de cuenta principal (PAN). El sistema formatea y espacia el número automáticamente. | `4111 1111 1111 1111` |
| Código de seguridad | `'cvv'` | Introduce el código de verificación de la tarjeta (CVV/CVC). | `123` |
| Fecha de expiración | `'expiration'` | Introduce la fecha de caducidad de la tarjeta. Utiliza el formato MM-YYYY. | `12-2028` |

***

## Eventos

Escucha eventos en una instancia de campo mediante el método `.on()` para reaccionar a los cambios de estado.

### Evento `'change'`

Se activa cuando cambia el valor o el estado de validación del campo.

El callback recibe: `state` (Object)

* `state.isEmpty` (`Boolean`): `true` si el campo no tiene valor.
* `state.isValid` (`Boolean`): `true` si el valor actual es válido.
* `state.isFocused` (`Boolean`): `true` si el campo tiene actualmente el foco.
* `state.error` (`String` | `undefined`): Una cadena que describe el error de validación, si lo hay.

**Ejemplo:**

```javascript theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
panField.on('change', (state) => {
  if (state.isValid) {
    // Update UI to show valid state
    console.log('Card number is valid');
  } else if (state.error) {
    // Update UI to show error message
    console.error('Validation error:', state.error);
  }
});
```

### Evento `'tokenized'`

Se activa cuando el valor del campo ha sido tokenizado correctamente por el backend de Localpayment. Esto suele ocurrir después de introducir un valor válido y cuando el campo pierde el foco.

**Ejemplo:**

```javascript theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
panField.on('tokenized', (token) => {
  console.log('PAN tokenized with token:', token);
  // You can track that this field is ready for consolidation
});
```

### Evento `'error'`

Se activa cuando se produce un error irrecuperable, como un fallo de tokenización.

El callback recibe: `error` (Object)

* `error.error` (`String`): Un mensaje de error general.
* `error.metadata` (`Object` | `undefined`): Metadatos adicionales sobre el error.

**Ejemplo:**

```javascript theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
panField.on('error', (error) => {
  console.error('An error occurred:', error.error);
  if (error.metadata) {
    console.error('Error details:', error.metadata);
  }
});

```

***

## Manejo de errores

El SDK proporciona los errores a través del evento `error` y de promesas rechazadas. Los escenarios de error comunes incluyen:

* **Errores de red**: `createSession()` fallará si no se puede realizar una solicitud de red.
* **Credenciales no válidas**: `createSession()` fallará si `clientCode` o `apiKey` son incorrectos.
* **Errores de tokenización**: El evento \`error se activará si el valor de un campo no se puede tokenizar (por ejemplo, un número de tarjeta no válido que pasa la validación básica pero es rechazado por el procesador).
* **Caducidad de la sesión**: Las operaciones fallarán si la sesión ha caducado. Debes detectar esta situación y, por lo general, recrear la sesión.

**Ejemplo de manejo integral de errores:**

```javascript theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
// Handle field errors
panField.on('error', (error) => {
  showUserError(`Card number error: ${error.error}`);
});
// Handle session creation errors
try {
  await localpayment.createSession();
} catch (error) {
  console.error('Session creation failed. Please check your credentials.', error);
}
```


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