Tilopay.getSinpeMovil()
SDK 2.1.1SINPE 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.
typeDniydnitienen que haberse enviado antes, porInit()o porupdateOptions().
Llamada#
const params = await Tilopay.getSinpeMovil();Respuesta#
{
"message": "Success",
"code": "863",
"amount": 10,
"number": "70599200"
}Success cuando la operación salió bien; la descripción del error si no.
El código que el cliente debe escribir en la descripción de la transferencia. Es lo que permite identificar el pago.
El monto exacto que debe transferir.
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,
typeDniydni. - Mientras la transferencia no llegue,
startPayment()devuelve el error de SINPE en espera.
Última verificación: 2026-10-22