Tokenizar (encriptar) la información la tarjeta

Necesitas tokenizar la información sensible de la tarjeta en el frontend de tu sitio por motivos de seguridad.

Paso 1

Añade la librería de ConektaJS a tu sitio.

  • Para fines prácticos usamos jQuery en este tutorial.
  • Nuestra librería de frontend ConektaJS sólo tokeniza las tarjetas.

Si estás construyendo una app, en lugar de ConektaJS usarás los SDKs de Android, iOS o Xamarin.

Objetos que regresa ConektaJS

  • Objeto token: es el objeto que regresamos en caso de éxito.
  • Objeto error: es el objeto que regresamos en caso de que algo haya salido mal.

Paso 1.1

Añade tu script de tokenización

Definiciones

  • Conekta.setPublishableKey() añade tu llave pública para permitir la tokenización de tarjetas.
  • conektaSuccessResponseHandler regresa un objeto token cuando la petición fue exitosa.
  • conektaErrorResponseHandler regresa un objeto error cuando la petición tuvo algún detalle.
  • Conekta.token.create() envía la información a nuestro servidor.

El token sólo puede ser utilizado una vez y tiene un tiempo de expiración de una hora.

Paso 1.2

Añade el formulario de la tarjeta a tu sitio

ConektaJS recopila la información de la tarjeta usando data-attributes pero si lo deseas puedes crear un objeto token.

Cobra a tu cliente

Paso 2

Añade tu llave privada y versión del API.

Necesitas tu llave privada de pruebas. Puedes encontrarla dando clic aquí.

Paso 2.1

Crea un customer

Al crear un customer con la información de tu cliente en conjunto con el token que ConektaJS te proporcionó anteriormente tendrás la capacidad de reintentar el cargo y hacer cargos recurrentes siempre y cuando el usuario final esté consciente de ello.

Un customer puede tener muchos payment_sources pero sólo uno puede ser el default.

Los campos mostrados en el ejemplo son los mínimos requeridos, si deseas saber más sobre el objeto customer revisa nuestra REST API.

Paso 2.2

Crear una orden

Al crear un order se generará el cargo de a tu cliente. Si no deseas crear el cargo inmediato, puedes preparar la orden y después generar el cargo mandando la información del arreglo charges.

La información que debes enviar tiene que ser real ya que nuestro sistema de antifraude la necesita para revisar la veracidad de la transacción.

Los campos mostrados en el ejemplo son los mínimos requeridos, si deseas mejorar la veracidad de tus transacciones necesitas saber más sobre el objeto order, para ello, revisa nuestra REST API.

Paso 2.3

Procesar respuesta

Recibirás un objeto JSON con mucha información, puedes mostrar los campos que creas necesarios.

Conekta recomienda que notifiques a tu usuario vía email.

¡Listo! Recuerda cambiar tus llaves pública y privada después de realizar pruebas.

Existirán casos en los que el método de pago seleccionado no será suficiente, puedes configurar un reintento en caso de que lo veas necesario.

Reintento tarjeta

Reintento otro método

Nosotros recomendamos sugerir otro método de pago cuando los reintentos fallidos de tarjeta fueron más de 3.