MANUAL DE
INTEGRACIÓN
PARA
ECOMMERCE
EN MODO API
TU PAGO SAS
WWW.TUPAGO.COM.CO
WWW.TUPAGO.MX
Especificaciones técnicas para integración
e-commerce
El acceso a la API desde el mbiente del comercio se realiza
mendiante un request usado POST enviando en el body los
parámetros en JSON a la url indicada a continuación:
https://www.tupago.net.co/cuentaVirtual/api/
Se validan todos los parámetros del JSON que son requeridos.
Existe una validación de la dirección IP del servidor desde donde se
hace el request, solo las IP que se asignan en por TU PAGO SAS son
aceptadas.
Ejemplo del request en JSON:
{
"descripcion": "Descripcion de la compra",
"codigoReferencia": "Codigo de Referencia interno para uso del
comercio",
"monto": "Monto de la compra, sin impuestos",
"impuesto": "Monto del impuesto de la compra",
"purchaseHash": "Cadena de validacion del request",
"apiKey": "API Key asignado al comercio",
"nombreComprador": "Nombre y Apellidos del comprador",
"identificacionComprador": "Identificacion del comprador",
"telefono1Comprador": "Telefono fijo del comprador",
"telefono2Comprador": "Telefono movil del comprador",
"emailComprador": "Email del comprador",
"direccionComprador": "Direccion del comprador",
"ciudadComprador": "Ciudad del comprador",
"tarjetaNumero": "Numero de Tarjeta",
"tarjetaNombre": "Nombre del Tarjetahabiente",
"tarjetaCvv": "Cvv de la Tarjeta",
"tarjetaVencimiento": "Fecha de Vencimiento (MM-YYYY) de la
Tarjeta",
}
El parametro monto, es el monto total de la compra sin
impuestos, para el monto del impuesto esta el parametro
impuesto.
El parametro purchaseHash se debe calcular de la siguiente
forma:
sha256(ApiKey + Site IP + codigoReferencia + monto)
y es validado del lado del servidor.
Todas las respuestas del servidor son status HTTP y un
mensaje en string, descriptivo.
.
MANUAL DE INTEGRACIÓN
Guía de integración estándar para pagos desde tu sitio web.
Para poder aceptar pagos con tarjetas de crédito a través de TU
PAGO debes conectar tu página de Internet (servidor) con
nuestro sistema transaccional. A este proceso lo denominamos
"integración".
Una vez finalizado, podrás recibir pagos desde cualquier parte del
mundo, en diferentes monedas e idiomas (según autorización
previa de TU PAGO) , utilizando nuestro módulo antifraude,
servicio de tokenización, confirmación, notificación vía SMS al
tarjetahabiente y la última tecnología para garantizar la seguridad
y confiabilidad de las transacciones mediante nuestros analistas
de monitoreo y control transaccional.
La guía de integración estándar para Pagos desde tu sitio Web
proporciona información sobre la mayoría de las funciones de TU
PAGO así como explicaciones de cómo utilizarlas para cubrir tus
necesidades de pago en Internet.
Utiliza la Guía de integración estándar para:
• Configurar de manera rápida y sencilla la funcionalidad del
comercio electrónico con TU PAGO.
• Conocer técnicas y herramientas más avanzadas para sacar el
máximo partido a los servicios provistos por TU PAGO
• Conocer que información debe enviar a, y recibir de TU PAGO
DESCRIPCION DEL PROCESO
El comprador entra a la página del comercio y selecciona los
productos y/o servicios que desea adquirir.
1. El comercio totaliza el valor de la compra y genera una trama
que es enviada a la nube transaccional de TU PAGO por medio
de una petición POST.
2. El sistema transaccional valida la trama, captura la
información en caso de tratarse de una tarjeta de crédito y
envía los datos a la entidad bancaria.
3. La entidad bancaria procesa la transacción y retorna una
respuesta a la nube transaccional de TU PAGO
El sistema envía al comprador de nuevo la información a la
página del comercio.
Nota: TU PAGO cuenta con un módulo antifraude que utiliza las
últimas técnicas de inteligencia artificial para evaluar las
transacciones, dependiendo de las opciones de configuración
del comercio y del factor de riesgo asociado a una transacción,
puede enviar la transacción a un proceso de validación manual,
retardando el envío de la información a la entidad bancaria
mientras se corrobora la autenticidad de la transacción. Cuando
esto sucede el sistema envía al comprador a la página de
respuesta, indicando que la transacción se encuentra en
proceso de validación.
Importante: El proceso de integración estándar está enfocado a
los pymes y personales, si usted posee una cuenta empresarial
o corporativa y/o está utilizando convenios propios PUEDE SER
NECESARIO realizar ajustes adicionales para la certificación. En
caso de ser necesario pfavor consulte con su asesor comercial
o directamente con el área de soporte técnico en TU PAGO.
.
