Tilopay.getSinpeMovil()

SDK 2.1.1

SINPE Móvil no se cobra desde el formulario: el cliente hace la transferencia desde su propio banco. Este método arma los datos del método SINPE seleccionado que hay que mostrarle — teléfono destino, monto exacto y código de descripción.

Cuándo se usa#

Cuando tenés un método SINPE Móvil disponible y el cliente lo selecciona de la lista que devolvió Init().

Firma#

await Tilopay.getSinpeMovil()

No recibe parámetros.

Precondiciones:

  • El cliente tiene que haber seleccionado SINPE Móvil como método de pago.
  • typeDni y dni tienen que haberse enviado antes, por Init() o por updateOptions().

Llamada#

const params = await Tilopay.getSinpeMovil();

Respuesta#

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

Success cuando la operación salió bien; la descripción del error si no.

codestring#

El código que el cliente debe escribir en la descripción de la transferencia. Es lo que permite identificar el pago.

amountnumber#

El monto exacto que debe transferir.

numberstring#

El número de teléfono destino de la transferencia.

En caso de error#

Devuelve un objeto con la descripción del error y los demás campos vacíos:

{
  "message": "<descripción del error>",
  "code": "",
  "amount": "",
  "number": ""
}

SINPE Móvil: confirmación y plazo#

Cuando llega la transferencia, el SDK redirige a tu redirect; si enviaste webhook, Tilopay también lo notifica. El SDK no fija un plazo, pero Tilopay asocia transferencias con órdenes SINPE Móvil creadas en los últimos 25 minutos: el cliente debe transferir dentro de ese plazo. La sesión depende de la vigencia del token del SDK.

Qué hacer con estos datos#

  • Al elegir SINPE Móvil, ocultá los campos de tarjeta y mostrá un mensaje como: «Para pagar con SINPE Móvil, transferí al teléfono 8888 8888 el monto exacto ₡100,00 e indicá en la descripción TB095».
  • Opcionalmente, agregá un botón «Ya hice el SINPE Móvil» que, al tocarlo, muestre que se está esperando el depósito. Antes de habilitarlo, asegurate de tener correo, typeDni y dni.
  • Mientras la transferencia no llegue, startPayment() devuelve el error de SINPE en espera.

Última verificación: 2026-10-22

Ver como Markdown crudo