Tilopay.getSinpeMovil()

SDK v2

SINPE Móvil is not charged from the form: the customer makes the transfer from their own bank. This method returns the data you must show them — destination phone, exact amount and description code.

When to use it#

When the merchant has a SINPE Móvil method available and the customer selects it from the list returned by Init().

It is not just a getter. Besides returning the data, this method triggers the SINPE listener with the Tilopay backend. Calling it is part of the collection flow, not a presentation detail.

Signature#

await Tilopay.getSinpeMovil()

It takes no parameters.

Preconditions:

  • The customer must have selected SINPE Móvil as the payment method.
  • typeDni and dni must have been sent earlier, via Init() or updateOptions().

Call#

const params = await Tilopay.getSinpeMovil();

Response#

{
  "message": "Success",
  "code": "863",
  "amount": 10,
  "number": "70599200"
}
messagestring#

Success when the operation succeeded.

codestring#

The code the customer must write in the transfer description. It is what identifies the payment.

amountnumber#

The exact amount they must transfer.

numberstring#

The destination phone number for the transfer.

On error#

On error it returns nothing. Do not expect an object with empty fields: treat the absence of a response as the error case.

What to do with this data#

When SINPE Móvil is selected, hide the card fields and show the customer this data: destination phone, exact amount and the code for the description.

No pay button is needed: the collection is processed when the transfer arrives.

Last verified: 2026-08-28 · Owner: equipo-integraciones

View as raw Markdown