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).

Puedes contactar tu tienda en línea a la plataforma de PayU y el proceso de checkout será manejado en tu página web. Para integrar esta opción, debes tener una cuenta de PayU empresarial y habilidades de programación avanzadas.

Accede a múltiples métodos de pago (varía por país) incluyendo tarjetas de crédito, transferencias bancarias y pagos en efectivo.

API integration

Configuraciones iniciales

PayU te permite integrarte con la pasarela de pagos transaccional, las herramientas de pago disponibles y las consultas desarrollando un cliente HTTPS para enviar la información de la transacción a través de SSL. Es muy importante que los datos sensibles de la transacción como el número de la tarjeta de crédito, la fecha de expiración de la misma y demás, no sean almacenados. Recomendamos que sigas las mejores prácticas de PCI DSS (Payment Card Industry Data Security Standard).

la transmisión de las transacciones se asegurada a través de una conexión TLS (Transport Layer Security) de 256 bits desde el servidor de tu tienda hasta nuestra pasarela de pagos. El intercambio de mensajes se hace a través de cadenas JSON o XML y las operaciones se distinguen por un comando que se incluye en la petición. Observa los siguientes ejemplos JSON y XML:


POST /payments-api/4.0/service.cgi HTTP/1.1
Host: sandbox.api.payulatam.com
Content-Type: application/json; charset=utf-8
Accept: application/json
Content-Length: length
{
   "test": false,
   "language": "es",
   "command": "GET_PAYMENT_METHODS",
   "merchant": {
      "apiLogin": "xxxxxxxxxxxxx",
      "apiKey": "xxxxxxxxxxxxx"
   }
}

POST /payments-api/4.0/service.cgi HTTP/1.1
Host: sandbox.api.payulatam.com
Content-Type: application/json; charset=utf-8
Accept: application/xml
Content-Length: length
<request>
   <language>es</language>
   <command>GET_PAYMENT_METHODS</command>
   <merchant>
      <apiLogin>xxxxxxxxxxxxx</apiLogin>
      <apiKey>xxxxxxxxxxxxx</apiKey>
   </merchant>
   <isTest>false</isTest>
</request>

Puedes definir en lenguaje que deseas utilizar en la petición a través de las cabeceras HTTP Content-type y Accept. Puedes utilizar todas las combinaciones posibles:

CONTENT-TYPE ACCEPT
application/xml application/xml
application/json application/json
application/xml application/json
application/json application/xml

Consideraciones

  • Debes tener una cuenta activa de PayU.
  • Debes instalar un certificado SSL válido en tu servidor y tu página web debe poder hacer conexiones SSL. Debido a esto, la máquina virtual debe contar con las extensiones de seguridad apropiadas.
  • Temporalmente NO utilices certificados de seguridad de curva elíptica o aquellos que cuenten con la suite de cifrado TLS_ECDHE_ECDSA_WITH_RC4_128_SHA en tus peticiones de pago.
  • Debes tener lenguajes de servidor o CGI tales como Java, C#, VB, PHP, etc.
  • Debes estar en capacidad de almacenar de forma segura tus credenciales de autenticación (API Key y API Login).
  • Los mensajes deben ser codificados utilizando UTF-8.
  • Las fechas deben utilizar el formato yyyy-MM-ddTHH:mm:ss, el formato de hora es 24 horas. Ejemplo: 2015-08-22T21:35:12.
  • En condiciones normales la conexión garantiza tiempos de respuesta de tres segundos en promedio. Si hay una situación anormal, el tiempo máximo de respuesta será de un minuto. Te recomendamos que configures los timeouts cuando te conectes a PayU.
  • Es importante validar la longitud y los números de tarjetas de crédito por franquicia junto con los códigos de seguridad.

Funcionalidades disponibles


Temas en esta sección

Guía de Seguridad y Cumplimiento PCI

La seguridad en las transacciones financieras es esencial para proteger tanto a las empresas como a los consumidores en el entorno digital. A continuación, exploramos las prácticas y estándares que ayudan a garantizar transacciones seguras y cumplir con estándares de seguridad internacionales. Estas medidas no solo fortalecen la confianza en la plataforma, sino que también protegen contra amenazas y mitigan riesgos económicos y reputacionales.

API de Pagos - Argentina

La API de Pagos para Argentina permite integrar de manera eficiente las capacidades de procesamiento de pagos de PayU con tu plataforma de compras en línea. A través de esta API, los comercios pueden ofrecer a sus clientes una amplia variedad de métodos de pago, incluyendo efectivo, tarjetas de crédito y tarjetas de débito.

API de Pagos - Brasil

La API de Pagos para Brasil permite integrar de manera eficiente las capacidades de procesamiento de pagos de PayU con tu plataforma de compras en línea. A través de esta API, los comercios pueden ofrecer a sus clientes una amplia variedad de métodos de pago, incluyendo aplicaciones móviles, transferencia electrónica, efectivo, tranferencia bancaria y tarjetas de crédito.

API de Pagos - Chile

La API de Pagos para Chile permite integrar de manera eficiente las capacidades de procesamiento de pagos de PayU con tu plataforma de compras en línea. A través de esta API, los comercios pueden ofrecer a sus clientes una amplia variedad de métodos de pago, incluyendo efectivo, tarjetas de crédito, débito o prepagadas, y tarjetas débito o prepagadas a través de WebPay Plus.

API de Pagos - Colombia

La API de Pagos para Colombia permite integrar de manera eficiente las capacidades de procesamiento de pagos de PayU con tu plataforma de compras en línea. A través de esta API, los comercios pueden ofrecer a sus clientes una amplia variedad de métodos de pago, incluyendo tarjetas de crédito, tarjetas de débito, billeteras digitales, efectivo y transferencias bancarias.

API de Pagos - México

La API de Pagos para México permite integrar de manera eficiente las capacidades de procesamiento de pagos de PayU con tu plataforma de compras en línea. A través de esta API, los comercios pueden ofrecer a sus clientes una amplia variedad de métodos de pago, incluyendo efectivo, tarjetas de crédito, tarjetas de débito, transferencia bancaria y referencia bancaria.

API de Pagos - Panamá

La API de Pagos para Panamá permite integrar de manera eficiente las capacidades de procesamiento de pagos de PayU para tarjetas de crédito con tu plataforma de compras en línea.

API de Pagos - Perú

La API de Pagos para Perú permite integrar de manera eficiente las capacidades de procesamiento de pagos de PayU con tu plataforma de compras en línea. A través de esta API, los comercios pueden ofrecer a sus clientes una amplia variedad de métodos de pago, incluyendo aplicaciones móviles, efectivo, tarjetas de crédito y tarjetas de débito.

API de Consultas

El API de Consultas te permite validar el estado de las órdenes generadas junto con sus transacciones.

API de Tokenización

El API de Tokenización te permite almacenar de forma segura, la información de las tarjetas de crédito de tus clientes a través de la creación de un token. Este token tee permite realizar pagos regulares o implementar la funcionalidad de pago a un clic, siguiendo lo estándares de seguridad de PCI DSS (Payment Card Industry Data Security Standard) para manejar los datos de las tarjetas de crédito.

API de Promociones para Argentina y México

Te permite consultar las promociones vigentes junto con sus costos asociados, características e información adicional relevante para tus clientes. El API de API de Promociones aplica únicamente para Argentina y México (MSI - Meses Sin Intereses).

API de Reembolsos y Anulaciones

Esta funcionalidad te permite solicitar la cancelación o el reembolso de transacciones autorizadas o cobradas. Puedes crear la solicitud utilizando los métodos de reembolso (Refund) o de cancelación (Void) de acuerdo con el estado de la transacción.

API de Payouts

Esta funcionalidad te permite crear múltiples y seguros pagos a beneficiarios (usuarios, comercios, proveedores, clientes, etc.) utilizando los fondos que tienes en tu cuenta PayU.

Token Simulator

Esta herramienta interactiva permite a los desarrolladores probar y ajustar su integración de Google Pay.

Actualmente, Google Pay solo está disponible para la API de Pagos de Brasil.

Última modificación 8 de noviembre de 2024: Documentation updates (cb34649dc)