Campos del formulario

SDK 2.1.1

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 contenedor payFormTilopay es obligatorio. Todos los campos tlpy_* (y el div de Apple Pay) deben estar dentro de un div con la clase payFormTilopay: el SDK busca ese contenedor para escuchar los campos. El contenedor responseTilopay va fuera de ese div.

Campos#

tlpy_payment_methodtext | selectrequerido#

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

tlpy_saved_cardsselect#

Contiene el id de la tarjeta guardada obtenida de Tilopay. Debe existir en el DOM; puede estar oculto si el método de pago no lo usa.

tlpy_cc_numbertext#

Número de tarjeta. Debe existir en el DOM; puede estar oculto si el método de pago no lo usa.

tlpy_cc_expiration_datetext#

Fecha de expiración en formato mes/año, por ejemplo 12/30. Debe existir en el DOM; puede estar oculto si el método de pago no lo usa.

tlpy_cvvtext#

Código de seguridad. Debe existir en el DOM; puede estar oculto si el método de pago no lo usa. Cuando el cliente usa una tarjeta guardada, hay que habilitar este campo para que digite el CVV.

tlpy_apple_pay_button_divdiv#

Para Apple Pay: el SDK dibuja ahí el botón de Apple Pay. Va dentro de payFormTilopay.

tlpy_apple_pay_cancelhidden#

Opcional, para Apple Pay. Su valor cambia a "cancelled" y dispara change cuando el comprador cierra la hoja de Apple Pay.

responseTilopaydivrequerido#

Contenedor requerido, fuera de payFormTilopay. 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#

El div con la clase payFormTilopay, los id de los inputs y responseTilopay son obligatorios; los demás div son libres.

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

  <!-- Solo si usás Apple Pay -->
  <div id="tlpy_apple_pay_button_div"></div>
  <input type="hidden" id="tlpy_apple_pay_cancel" />
</div>

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

Última verificación: 2026-10-21

Ver como Markdown crudo