Campos del formulario

SDK v2

El SDK V2 no renderiza el formulario: toma control de los inputs que ya existen en tu página, buscándolos por id. Esos ids son un contrato — si cambiás uno, el SDK deja de encontrar el campo.

El contrato son los inputs, no los contenedores. Los div que envuelven a los campos podés nombrarlos como quieras: el SDK no los busca. La única excepción es responseTilopay, que sí es requerido.

Campos#

tlpy_payment_methodtext | selectrequerido#

Contiene el id del método de pago obtenido de Tilopay. Puede estar visible u oculto, a discreción del comercio.

tlpy_saved_cardsselectrequerido#

Contiene el id de la tarjeta guardada obtenida de Tilopay. Si el cliente no tiene tarjetas guardadas, ocultalo.

tlpy_cc_numbertextrequerido#

Número de tarjeta.

tlpy_cc_expiration_datetextrequerido#

Fecha de expiración en formato mes/año, por ejemplo 01/25.

tlpy_cvvtextrequerido#

Código de seguridad. Cuando el cliente usa una tarjeta guardada, hay que habilitar este campo para que digite el CVV.

responseTilopaydivrequerido#

Contenedor requerido, fuera del formulario. Es donde el SDK monta el flujo 3DS.

El teléfono de Yappy no viaja por el DOM#

El teléfono de Yappy no se toma de un campo del formulario: se envía en el parámetro phoneYappy de Init() o de updateOptions().

Estructura de ejemplo#

Los div de este ejemplo son libres; los id de los inputs y responseTilopay no.

<div class="payFormTilopay">
  <select id="tlpy_payment_method" name="tlpy_payment_method"></select>

  <div>
    <select id="tlpy_saved_cards" name="tlpy_saved_cards"></select>
    <input type="text" id="tlpy_cc_number" name="tlpy_cc_number" />
    <input type="text" id="tlpy_cc_expiration_date" name="tlpy_cc_expiration_date" />
    <input type="text" id="tlpy_cvv" name="tlpy_cvv" />
  </div>
</div>

<div id="responseTilopay"></div>

Última verificación: 2026-08-28 · Responsable: equipo-integraciones

Ver como Markdown crudo