API y SDK

¿Cómo integrar el SDK V2 Tilopay para tokenizar tarjetas?

Utiliza nuestro SDK para tokenizar y guardar tarjetas de forma segura para luego realizar cobros según sea necesario.

Paso 1: Importar la librería requerida:

Aquí puede establecer el diseño, colores y estilos que desee acorde a su plataforma. Se requiere de la librería Jquery y sdk de Tilopay:

https://app.tilopay.com/sdk/v2/sdk_tpay.min.js

¿Cómo integrar el SDK V2 Tilopay para tokenizar tarjetas?

Paso 2: llamar a await Tilopay.InitTokenize()

Llama a la función await Tilopay.InitTokenize(). Da inicio al proceso de tokenización con Tilopay, por medio de él se realiza la autenticación y se reciben los métodos de pago disponibles para guardar la tarjeta en Tilopay. Los parámetros que recibe son los siguientes:

  • token: Campo obligatorio, tipo string. Token obtenido del método, GetTokenSdk de la Api Tiliopay.

  • currency: Campo obligatorio, tipo string, longitud de 3 caracteres. Códigos de divisa ISO 4217, por ejemplo, CRC, USD. Moneda de la compra.

  • language: Campo obligatorio, tipo string, longitud de 2 caracteres. Códigos ISO 639-1, ejemplo: en, es. Moneda de la compra.

  • billToEmail: Campo obligatorio, tipo string. Correo electrónico del cliente.

  • orderNumber: Campo obligatorio, de tipo string, puede ser alfanumérico, de valor único, no se puede repetir por comercio. Número de orden, por ejemplo: 1001, TPY-1001, xbkshHwqrKjs98.

  • billToFirstName: Campo obligatorio, tipo string. Nombre del cliente.

  • billToLastName: Campo obligatorio, tipo string. Apellidos del cliente.

  • billToAddress: Campo obligatorio, tipo string. Dirección 1 del cliente.

  • billToAddress2: Campo opcional, tipo string. Dirección 2 del cliente.

  • billToCity: Campo recomendado, tipo string. Ciudad del cliente.

  • billToState: Campo recomendado, tipo string. Estado del cliente.

  • billToZipPostCode: Campo recomendado, tipo string. Código postal del cliente.

  • billToCountry: Campo recomendado, tipo string. País del cliente, ISO 3166-1 dos caracteres, ejemplo: CR, FR, PA.

  • billToTelephone: Campo recomendado, tipo string. Teléfono del cliente.

  • token_version: Campo obligatorio, tipo string. Enviar como valor "v2."

  • redirect: Campo obligatorio, tipo string. Url (callback) donde se espera la respuesta final de la compra.

Esta función await Tilopay.InitTokenize() procesará un cobro al tarjetahabiente por $1 o su equivalente en la moneda a procesar, con el fin de validar la tarjeta y proceder a guardarla. Este monto será reversado inmediatamente, siendo devuelto al usuario en unos minutos.

Para utilizar el guardado de tarjetas, se reemplaza el método Init por InitTokenize, y se concluye de igual manera con el método startPayment, cuando reciba la respuesta almacene el token obtenido y asócielo al correo electrónico del usuario para su uso posterior

Ejemplo de llamado a la función await Tilopay.InitTokenize()

¿Cómo integrar el SDK V2 Tilopay para tokenizar tarjetas?

Ejemplo de respuesta a la función await Tilopay.InitTokenize()

¿Cómo integrar el SDK V2 Tilopay para tokenizar tarjetas?

¿Necesitas ayuda con esta guía?

Nuestro equipo puede acompañarte en la integración.

Soporte Técnico