Tilopay.updateOptions()

SDK v2

Actualiza valores que ya se habían enviado en Tilopay.Init() y que cambiaron durante el checkout — típicamente cuando el cliente edita sus datos, o cuando selecciona SINPE Móvil o Yappy y hay que agregar información que antes no aplicaba.

Es un patch. Se envían solo los campos que se quieren actualizar; no hay que reenviar todo.

Qué significa "obligatorio" acá#

En la lista de abajo, "obligatorio" significa que el campo debe haberse enviado en Init() o en updateOptions(). Si no se envió en ninguno de los dos, el pago no puede avanzar. No significa que haya que reenviarlo en cada llamada.

Firma#

await Tilopay.updateOptions({ /* solo los campos que cambian */ })

Llamada#

const update = await Tilopay.updateOptions({
  typeDni: 1,
  dni: "0707770777",
  billToFirstName: "Ana",
  billToLastName: "Rojas",
});

Parámetros#

typeDniinteger#

Tipo de identificación del cliente. Obligatorio para SINPE Móvil. Ver tipos de identificación.

dnistring#

Número de identificación del cliente. Obligatorio para SINPE Móvil. Acepta con guiones y sin guiones.

billToFirstNamestringrequerido#

Nombre del cliente.

billToLastNamestringrequerido#

Apellidos del cliente.

billToAddressstringrequerido#

Dirección 1 del cliente.

billToAddress2string#

Dirección 2 del cliente. Opcional.

billToCitystring#

Ciudad del cliente. Recomendado.

billToStatestring#

Provincia o estado. Recomendado.

billToZipPostCodestring#

Código postal. Recomendado.

billToCountrystring#

País, ISO 3166-1 alpha-2. Recomendado.

billToTelephonestring#

Teléfono del cliente. Recomendado.

captureintegerrequerido#

0 autoriza; 1 autoriza y captura.

redirectstring (URL)requerido#

URL donde se espera la respuesta final de la compra.

subscriptionintegerrequerido#

1 si el cliente quiere guardar su tarjeta en Tilopay; 0 si no.

phoneYappystring#

Teléfono Yappy. Obligatorio cuando el cliente paga con Yappy.

billToEmail no se puede actualizar después de obtener las tarjetas guardadas. Una vez que Init() devolvió las tarjetas del cliente, el correo no se puede cambiar por este método.

Tipos de identificación#

Aplica al parámetro typeDni, tanto acá como en Tilopay.Init(). En las máscaras, # es un carácter numérico y & es alfanumérico. Las longitudes no cuentan los guiones.

Código	Tipo	Formato	Longitud
1	Cédula de identidad	`0#-####-####`	10
2	Cédula jurídica	`3-###-######`	10
3	Gobierno central	`2-###-######`	10
4	Institución autónoma	`4-###-######`	10
5	Extranjero no residente	`9&&&&&&&&&&&&&&&&&&&`	20
6	DIMEX	`1###########`	12
7	DIDI	`5###########`	12

Respuesta#

{
  "message": "Success"
}

messagestring#

Success cuando la actualización salió bien; la descripción del error en caso contrario.

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

Ver como Markdown crudo