Tokenización

[Aldo]

Hola Admin,

Voy a realizar pruebas sobre el modulo Tokenización mediante el API, podría darme las tablas de variables (donde se indica nombre, tipo y descripción) para saber que información colocar. o en su caso que es el campo "payerId".

De antemano muchas gracias.

Saludos!

[ADMIN]

Buenas tardes Aldo,

Te agradecemos hacer uso de nuestro foro para publicar tus dudas.

Con respecto al módulo de tokenización mediante el API te informamos lo siguiente relacionado con las variables:

- "payerId": (obligatorio) identificador del pagador dentro del comercio. Es decir, es un id que asigna directamente el comercio y escogen ustedes cómo especificarlo. El campo acepta caracteres, números y los simbolos: -._@. No acepta caracteres especiales.

- "name": (obligatorio) nombre del tarjeta habiente. Si van a realizar pruebas de pago aquí es donde deben poner APPROVED, REJECTED o PENDING con credenciales de prueba http://developers.payulatam.com/es/api/sandbox.html.

- "identificationNumber": (opcional) DNI del tarjeta habiente.

- "paymentMethod": (obligatorio) franquicia de la tarjeta de crédito.

- "number": (obligatorio) número de la tarjeta de crédito.

- "expirationDate": (obligatorio) fecha de expiración de la tarjeta. Debe tener el formato yyyy/MM.

Antes de enviar la petición de creación es necesario validar que el número de tarjeta sea válido (se recomienda utilizar el algoritmo de Luhn para esto) y adicional verificar que la franquicia seleccionada corresponda al número de tarjeta:

Las tarjetas VISA comienzan con el número 4 y tienen una longitud de 16 dígitos.
Las tarjetas MASTERCARD comienzan con el número 5 y tienen una longitud de 16 dígitos.
Las tarjetas AMEX comienzan con el número 3 y tienen una longitud de 15 digitos.
Las tarjetas DINERS comienzan con el  número 3 y tienen una longitud de 14 dígitos.
Para otras franquicias solo validar con el algoritmo de Luhn. De igual forma, se debe verificar que la fecha de expiración sea mayor que la fecha actual.

Esperamos que la información haya sido de utilidad.

[Aldo]

Hola Admin,

Excelente información gracias a ello pude realizar mis pruebas, cabe mencionar que es el mismo procedimiento que al realizar un "Pago" solo que en ves de incluir los datos de la tarjeta se coloca el token. 

Me acaba de surgir una duda, en el portal/ API / Probando estados, se mencionan que se pueden ingresar 3 diferentes estados para realizar pruebas: APPROVED (aprobada), REJECTED (rechazada) o PENDING (pendiente), Sin embargo en Tablas de variables se indican más DECLINED, ERROR, EXPIRED Y SUBMITTED (esta soóo aplica para la API de reportes).

¿Cuales los los estados de transacciones para el API Tokenización?

¿Que pasa si una transacción queda pendiente?

¿Cual seria el proceso para no duplicar el pago? 

¿Se pueden revisar el estatus de las transacciones que se quedan como pendientes?

Muchas gracias por el apoyo Admin.

Saludos!

[ADMIN]

Buenos días Aldo,

Como tu lo dices, el procedimiento para realizar un pago utilizando tokenización es el mismo procedimiento de pagos regulares con tarjeta de crédito, la diferencia radica en enviar el identificador del token en vez de enviar la información de la tarjeta.

Con respecto a los estados, el API Tokenización maneja los mismos estados que el API Pagos: APPROVED (aprobada), DECLINED (declinada), ERROR, EXPIRED, PENDING (pendiente) y REJECTED (rechazada). Sin embargo, para realizar pruebas sobre los pagos únicamente utilizamos los valores APPROVED, REJECTED (corresponde a declinada) y PENDING.

Si una transacción queda pendiente, se realizará una validación manual por medio de nuestros agentes para verificar la validez de la transacción (por ejemplo, evitar transacciones fraudulentas). Si nuestros agentes observan que no hay inconvenientes, la transacción es enviada a las redes bancarias para su procesamiento; de lo contrario la transacción será declinada. Una vez se obtenga respuesta, nuestro sistema actualizará el estado de la transacción a aprobada o rechazada. Es posible utilizar nuestro API de Consulta http://developers.payulatam.com/es/api/queries.html para consultar posteriormente el estado de las transacciones. Con respecto a los métodos de consulta, recomendamos utilizar la consulta por medio del referenceCode, debido a que es un valor escogido por ustedes del cual siempre tendrán conocimiento.

Para no duplicar el pago, se recomiendo deshabilitar el botón de pago una vez el pagador hace clic sobre el mismo. Si una transacción queda pendiente, se debe informar al pagador de este estado y no permitir realizar el reintento hasta no obtener un estado final de la transacción (aprobada o rechazada), y adicional utilizar nuestro API de consulta para verificar el estado. Cuando la transacción pasa a ser aprobada o rechazada se le enviará automáticamente por parte de nuestro sistema un correo con la información. De igual forma, cuando por medio del API obtengas que la transacción fue declinada, será posible permitirle al pagador realizar el pago nuevamente.

[Aldo]

Hola Admin,

Muchísimas gracias por sus respuestas todas me han sido de gran utilidad ya pude realizar varias pruebas utilizando ASP .Net y C#. Solo restaría evaluar que opción tomar (Pagos Recurrentes o Tokenización) para ya aplicarlo a producción.

De nuevo, muchas gracias.

Saludos!