Tilopay.getSinpeMovil()

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

When to use it#

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

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

On error#

It returns an object with the error description and the other fields empty:

{
  "message": "<error description>",
  "code": "",
  "amount": "",
  "number": ""
}

SINPE Móvil: confirmation and timing#

When the transfer arrives, the SDK redirects to your redirect; Tilopay also notifies webhook if provided. The SDK does not set a deadline, but Tilopay matches transfers with SINPE Móvil orders created within the last 25 minutes: customers must transfer within that window. The session depends on the SDK token lifetime.

What to do with this data#

• When SINPE Móvil is selected, hide the card fields and show a message such as: "To pay with SINPE Móvil, transfer the exact amount ₡100.00 to phone 8888 8888 and write TB095 in the description".
• Optionally, add an "I already made the SINPE Móvil transfer" button that, when tapped, shows that the deposit is being awaited. Before enabling it, make sure you have the email, typeDni and dni.
• Until the transfer arrives, startPayment() returns the pending-SINPE error.