Saltar al contenido principal
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.

Tipos de campos

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

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:

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:

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:

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:

Última modificación el 10 de noviembre de 2026