Tilopay.updateOptions()
SDK 2.1.1Updates values already sent in Tilopay.Init() that changed
during checkout — typically when the customer edits their data, or when they select SINPE Móvil
or Yappy and information that did not apply before must be added.
It is a partial update. Send only the fields you want to update; there is no need to resend everything.
No field is required in the call#
No parameter is required in updateOptions(). What matters is that, before closing the
payment, the data the payment method needs (for example typeDni and dni for SINPE Móvil, or
phoneYappy for Yappy) was sent in Init() or in updateOptions().
Signature#
await Tilopay.updateOptions({ /* only the fields that change */ })Call#
const update = await Tilopay.updateOptions({
typeDni: 1,
dni: "0707770777",
billToFirstName: "Ana",
billToLastName: "Rojas",
});Parameters#
URL where Tilopay notifies the outcome of SINPE Móvil and Yappy payments.
You can update typeDni, dni, the billTo* fields (except billToEmail), the shipTo*
fields, capture, redirect, subscription and phoneYappy.
Customer identification type. Needed for SINPE Móvil. See identification types.
Customer identification number. Needed for SINPE Móvil. Accepted with and without hyphens.
Customer first name.
Customer last name.
Customer address line 1.
Customer address line 2.
City.
State or province.
Postal code.
Country, ISO 3166-1 alpha-2.
Customer phone.
Shipping recipient first name.
Shipping recipient last name.
Shipping address line 1.
Shipping address line 2.
Shipping city.
Shipping state or province.
Shipping postal code.
Shipping country, ISO 3166-1 alpha-2.
Shipping phone.
0 authorizes; 1 authorizes and captures.
URL where the final purchase response is expected.
1 if the customer wants to save their card in Tilopay; 0 if not.
Yappy phone. Needed when the customer pays with Yappy.
billToEmail cannot be updated. Once Init() returned the customer's cards, the email
cannot be changed through this method.
Identification types#
Applies to the typeDni parameter, both here and in Tilopay.Init(). In the masks, # is a
numeric character and & is alphanumeric. Lengths do not count hyphens.
| Code | Type | Format | Length |
|---|---|---|---|
| 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 |
Response#
{
"message": "Success"
}Success when the update succeeded; the error description otherwise.
Last verified: 2026-10-22