Tilopay.updateOptions()

SDK 2.1.1

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 una actualización parcial. Se envían solo los campos que se quieren actualizar; no hay que reenviar todo.

Ningún campo es obligatorio en la llamada#

Ningún parámetro es obligatorio en updateOptions(). Lo que sí importa es que, antes de cerrar el pago, los datos que el método de pago necesita (por ejemplo typeDni y dni para SINPE Móvil, o phoneYappy para Yappy) se hayan enviado en Init() o en updateOptions().

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#

webhookstring#

URL a la que Tilopay notifica el resultado de pagos con SINPE Móvil y Yappy.

Se pueden actualizar typeDni, dni, los campos billTo* (excepto billToEmail), los campos shipTo*, capture, redirect, subscription y phoneYappy.

typeDniinteger#

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

dnistring#

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

billToFirstNamestring#

Nombre del cliente.

billToLastNamestring#

Apellidos del cliente.

billToAddressstring#

Dirección 1 del cliente.

billToAddress2string#

Dirección 2 del cliente.

billToCitystring#

Ciudad.

billToStatestring#

Provincia o estado.

billToZipPostCodestring#

Código postal.

billToCountrystring#

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

billToTelephonestring#

Teléfono del cliente.

shipToFirstNamestring#

Nombre de quien recibe el envío.

shipToLastNamestring#

Apellidos de quien recibe el envío.

shipToAddressstring#

Dirección 1 de envío.

shipToAddress2string#

Dirección 2 de envío.

shipToCitystring#

Ciudad de envío.

shipToStatestring#

Provincia o estado de envío.

shipToZipPostCodestring#

Código postal de envío.

shipToCountrystring#

País de envío, ISO 3166-1 alpha-2.

shipToTelephonestring#

Teléfono de envío.

captureinteger#

0 autoriza; 1 autoriza y captura.

redirectstring (URL)#

URL donde se espera la respuesta final de la compra.

subscriptioninteger#

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

phoneYappystring#

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

billToEmail no se puede actualizar. 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-10-22

Ver como Markdown crudo