Integraciones

De acuerdo con las necesidades de tu negocio, selecciona cómo quieres integrar tu tienda con los servicios y herramientas de PayU.

Implementa PayU con el modelo agregador o gateway, utilizando los acuerdos financieros de PayU o los tuyos. Selecciona la integración que mejor se acople a tus necesidades:

El WebCheckout de PayU Checkout es una integración que te permite cobrar a través del formulario web de PayU desde cualquier dispositivo de forma fácil, rápida y segura.

  • PayU administra el sistema de pagos
  • Integración más fácil e igual de segura
  • Como PayU maneja la plataforma de pagos, es más fácil obtener la certificación PCI DSS

A través de las integraciones API o SDK, puedes recibir pagos de forma segura desde cualquier lugar que desees, en tu propia página web o en tu aplicación móvil.

  • Diseña tu propio checkout y administra el sistema de pagos de tu sitio web.
  • Disfruta de servicios adicionales seguros como el servicio de Tokenización de tarjetas de crédito.

Cómo obtener las variables para la integración

Independiente de la integración que escojas, puedes requerir alguna de las siguientes variables en la invocación de los métodos.

API key y API Login

  1. Ingresa a PayU.com y haz clic en la opción de log in en a parte superior de la página. O si lo prefieres, puedes ingresar a https://merchants.payulatam.com/.

  2. Haz clic en Configuración y luego selecciona Configuración técnica.

PrintScreen

  1. En esta ventana, encontrarás tanto el API key como el API Login que permiten autenticar a tu comercio durante el proceso de integración.

PrintScreen

Firma de autenticación

La variable signature es utilizada para validar los pago realizados a través de la plataforma, asegurando su autenticidad. Esta variable es un valor tipo string encriptado utilizando el algoritmo MD5 o el SHA y tiene la siguiente estructura.

ApiKey~merchantId~referenceCode~tx_value~currency

Construyamos la variable signature utilizando los siguientes valores de prueba:

  • ApiKey: 4Vj8eK4rloUd272L48hsrarnUA
  • merchantId: 508029
  • referenceCode: TestPayU
  • tx_value: 3
  • currency: USD

La cadena es la concatenación de estos valores con el caracter virgulilla (~):

4Vj8eK4rloUd272L48hsrarnUA~508029~TestPayU~3~USD

Luego de aplicar el algoritmo MD5, el valor de la variable signature es:

ba9ffa71559580175585e45ce70b6c37

variable deviceSessionId

La variable deviceSessionId es un código con la información del dispositivo donde se genera la transacción y provee un identificador único para el mismo. Esta variable no permite identificar atacantes.

  1. Para hace integración API o SDK, necesitas incluir el siguiente script en tu formulario de pago:
<script type="text/javascript" src="https://maf.pagosonline.net/ws/fp/tags.js?id=${deviceSessionId}80200"></script>
<noscript>
   <iframe style="width: 100px; height: 100px; border: 0; position: absolute; top: -5000px;" src="https://maf.pagosonline.net/ws/fp/tags.js?id=${deviceSessionId}80200"></iframe>
</noscript>

  1. Es importante generar el deviceSessionId por cada transacción. Para generar el deviceSessionId obten el session_id de la cookie y concaténalo junto con la fecha y hora actual en milisegundos Then, encrypt the result using MD5.

Ejemplo en PHP

$deviceSessionId = md5(session_id().microtime())

Por ejemplo, si el $deviceSessionId es d66f949f19b33e88c202b579cfc549b3, el script es:

<script type="text/javascript" src="https://maf.pagosonline.net/ws/fp/tags.js?id=d66f949f19b33e88c202b579cfc549b380200"></script>
<noscript>
	<iframe style="width: 100px; height: 100px; border: 0; position: absolute; top: -5000px;" src="https://maf.pagosonline.net/ws/fp/tags.js?id=d66f949f19b33e88c202b579cfc549b380200"></iframe>
</noscript>

  1. Por último, debes enviar el $deviceSessionId en la variable correspondiente a tu integración:
  • Para API: transaction.deviceSessionId
  • Para SDK JAVA: PayU.PARAMETERS.DEVICE_SESSION_ID
  • Para SDK PHP: PayUParameters::DEVICE_SESSION_ID

Temas en esta sección

Integración WebCheckout

La Integración WebCheckout le permite a tus clientes seleccionar los ítems que desean comprar en tu tienda y realizar el pado en nuestra pasarela de pagos (WebCheckout).

Integración API

La integración API de PayU le permite a tu negocio procesar transacciones desde diferentes tipos de aplicaciones (web, mobile, IVR, etc).

Integración SDK

El SDK (Software Development Kit) de PayU provee una solución simple para integraciones complejas.

Última modificación 24 de junio de 2022: clon issue (d73e43fe5)