Integración Tradicional

Transcripción

1 Manual de Integración Tradicional 1

2 Tabla de Contenido 1. Flujo de una Transacción Prerrequisitos de una Integración Tradicional con PAYU Cómo Conectarse con PAYU Consideraciones sobre Variables Pruebas de Pagos Páginas de Respuesta y Confirmación Configuración Página de Respuesta Página de Confirmación Transacciones en Producción Anexos Convenciones Variables que se Envían a la Pasarela Código de Divisas Admitidas Idiomas Admitidos (lng) Estados de la Transacción (estado_lap) Código de Respuesta (codigo_respuesta_pol) Código de Respuesta (codigo_respuesta_lap) Variables que se Envían a la Página de Respuesta Variables que se Envían a la Página de Confirmación Glosario

3 1 Flujo de una Transacción 3

4 1. Flujo de una Transacción PAYU ofrece una completa plataforma para realizar transacciones a través de Internet en una forma ágil, segura, confiable y plenamente funcional. A través de nuestra plataforma sus usuarios y clientes podrán encontrar un entorno amigable y muy intuitivo que garantiza una completa experiencia de comercio electrónico. A continuación mostraremos una aproximación al diagrama de flujo de una transacción: Empieza en su sitio Web, continúa en nuestra plataforma y una vez finalizada, retorna nuevamente a su sistema en donde se debe suministrar al pagador información sobre la transacción. 4

5 5

6 En este capítulo se revisará el funcionamiento general que debe existir entre el Comercio (Su Sitio Web) y nuestra pasarela de pagos. >> Cómo Funciona? 1. El proceso empieza cuando el comprador entra a su página WEB y selecciona los productos o servicios que desea adquirir. Su sistema debe totalizar el valor de la compra y conectarse con nuestro sistema a través de la Página de envío enviando por método POST una trama de datos. 2. Nuestro sistema valida esta trama, luego le permite al cliente escoger el medio de pago con el que desea realizar la transacción dependiendo de las opciones disponibles para el país y el comercio. 6

7 3. La entidad financiera procesa la transacción y retorna una respuesta al sistema de PAYU. 7

8 4. Nuestro sistema devuelve al comprador a una Página de respuesta dentro de PAYU donde visualizará el resultado de la transacción En caso de que la transacción sea rechazada o fallida el sistema permitirá reintentar el pago, lo cual devolverá al pagador a seleccionar el medio de pago deseado En el momento que finaliza una transacción, es decir en el momento que se aprueba o rechaza, se envía la información de la transacción por método POST a la Página de Confirmación en la cual el comercio podrá actualizar las bases de datos de su sistema. 5. En caso de usar como medio de pago la tarjeta de crédito; PAYU cuenta con un Módulo Antifraude que utiliza las últimas técnicas de inteligencia artificial para evaluar las transacciones. Por ello, dependiendo del factor de riesgo asociado a una transacción, puede enviar una transacción a un proceso de 8

9 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 estado de la transacción enviado a la Página de respuesta será en validación y el envío de los datos a la Página de confirmación no será inmediato, hasta se resuelva como aprobada o rechazada. MANUAL DE 9

10 2 Prerrequisitos de una Integración Tradicional con PAYU 10

11 2. Prerrequisitos de una Integración Tradicional con PAYU Se recomienda que usted implemente algún tipo de base de datos para que su sistema tenga registro de sus transacciones, pero esto no es necesario ni obligatorio, ya que en el módulo administrativo secure podrá encontrar el detalle de todas las transacciones. En cualquier tipo de integración que desee realizar, lo primero que debe hacer es obtener una cuenta con PAYU; de esta forma obtendrá un usuario único (merchantid) que lo identificará en el sistema y una Api Key que le permitirá realizar transacciones. Dicha Api Key es un elemento fundamental para el procesamiento como veremos más adelante. Para conocerla, ingrese a su módulo administrativo seleccione la pestaña configuración y allí, información técnica, tal y como muestra la siguiente imagen: Obtenemos una serie de datos, algunos con carácter editable, relativos a su 11

12 configuración en nuestros sistema, el primero de ellos denominado Api Key es la llave para cifrar la comunicación con PAYU. Si desea ampliar la información sobre el uso, manejo y funcionalidades del módulo administrativo secure, por favor consulte toda la documentación que específicamente ha creado PAYU para usted. 12

13 3 Cómo Conectarse con PAYU 13

14 3. Cómo Conectarse con PAYU En este capítulo verá cómo realizar conexiones con la plataforma de PAYU. Luego de tener los datos del usuario, puede empezar a realizar conexiones con la plataforma de pagos, para ello deberá generar un formulario HTML que apunte a la siguiente URL que es nuestro servidor de producción: Cada vez que se realiza una conexión se deben enviar algunos datos por método POST al sistema de PAYU. Los datos mínimos de envío son: CAMPO TIPO TAMAÑO DESCRIPCIÓN merchantid N 12 Es el número identificador del comercio en el sistema de PAYU, este número lo encontrará en el correo de creación de la cuenta. referencecode A 50 Es la referencia de la venta o pedido. Deber ser único por cada transacción que se envía al sistema. description A 255 Es la descripción de la venta. amount N 14,2 Es el monto total de la transacción. Puede contener dos dígitos decimales. Ej ó tax N 14,2 Es el valor del IVA (Impuesto al Valor Agregado solo valido para Colombia) de la transacción, si se envía el IVA nulo el sistema aplicará el 16% automáticamente. Puede contener dos dígitos decimales. Ej: En caso de no tener IVA debe enviarse en 0. taxreturnbase N 14,2 Es el valor base sobre el cual se calcula el IVA (solo valido para Colombia). En caso de que no tenga IVA debe enviarse en 0. 14

15 signature N 32 Es la firma digital creada para cada uno de las transacciones. accountid N 12 Identificador de la cuenta del usuario para cada país que tenga asociado el comercio, este campo es opcional, al enviarlo se despliegan solo los medios de pago pertenecientes a dicho país, si no se envía el usuario podrá escoger el país. currency A 3 La moneda respectiva en la que se realiza el pago. El proceso de conciliación se hace en pesos a la tasa representativa del día. Ver las divisas admitidas en el Anexo IV. buyer A 255 Campo que contiene el correo electrónico del comprador para notificarle el resultado de la transacción por correo electrónico. Se recomienda hacer una validación si se toma este dato en un formulario. Sin embargo la pasarela maneja otras variables adicionales, útiles para su modelo de negocio. Para conocer estos campos adicionales y el manejo de las mismas por favor diríjase al Anexo I. >> Consideraciones sobre las Variables La variable referencecode es única por cada transacción. Normalmente es una forma de que usted identifique las peticiones que se envían a la pasarela de pagos. El tax es un impuesto al valor agregado que pueden utilizar algunos países y la taxreturnbase es el valor base sobre el cual se calcula el IVA. En caso que su producto no aplique este impuesto simplemente ambas variables tomaran el valor 0 (tax=0, taxreturnbase =0). Por el contario, si algunos elementos tienen el impuesto y para otros no se aplica, tendrá que realizar el siguiente cálculo para saber cómo enviar los valores a la plataforma de pagos. 15

16 Producto taxreturnbase tax amount A 100,000 16,000 (16%) 116,000 B 200,000 20,000 (10%) 220,000 C 0 0 (0%) 150,000 Total 300,000 36, ,000 Nota: El monto de tax + taxreturnbase no puede ser mayor que el Valor Total Otro de los datos que debe enviar es signature. Es una forma única de validar los pagos realizados a través de la plataforma, garantizando su autenticidad. Consiste en una cadena de caracteres a la cual se le aplica algoritmo MD5 (SHA) para encriptarla. La cadena está compuesta de la siguiente forma: ApiKey~merchantId~referenceCode~amount~currency". La Api Key es un campo único por cada comercio afiliado a PAYU. Para conocer el valor de la suya, por favor siga el siguiente vínculo. Ilustraremos de mejor manera este concepto con un ejemplo. Para ello usaremos los siguientes datos de prueba: merchantid: Api Key: 6u39nqhq8ftd0hlvnjfs66eh8c referencecode: TestPayU amount: 3 currency: USD accountid: buyer test@test.com 16

17 La firma la conformarían los siguientes elementos "6u39nqhq8ftd0hlvnjfs66eh8c ~500238~TestPayU~3~USD La cual tras aplicársele algoritmo md5 quedaría así fc18e2703dda1f89fbcab2b02 En el ejemplo mencionado usamos Dólares Americanos. Para conocer más sobre las divisas admitidas por favor dirigirse al Anexo

18 4 Pruebas de Pagos 18

19 4. Pruebas de Pagos Una vez tenga claro los datos que deben enviarse a la pasarela de pagos para el procesamiento de las operaciones, efectué una prueba de pago con diferentes medios de pago, de esa manera podrá tener claridad de cada parte del proceso. Como parte de la prueba use los mismos parámetros de la prueba anterior, así: merchantid: Api Key: 6u39nqhq8ftd0hlvnjfs66eh8c referencecode: TestPayU accountid: description = Test PAYU amount: 3 tax: 0 taxreturnbase: 0 currency: USD signature: fc18e2703dda1f89fbcab2b02 test: 1 buyer test@test.com Pueden incluirse campos adicionales, pero para efectos de procesar una transacción los anteriores son suficientes. El campo test=1 lo incluye para indicarle al sistema que es una transacción de prueba. Nota: El hacer uso del campo prueba habilita las transacciones de prueba sin embargo para procesarlas en modo prueba también es necesario apuntar al servidor de pruebas. Envíe estas variables en un formulario a la dirección: Y obtendrá acceso a la pasarela de pagos, que debe verse similar a la siguiente: 19

20 >> Los elementos que encontrará en la pasarela de pago son los siguientes: 1. En primer lugar podrá visualizar la sección de los datos del pago, allí encontrará la información sobre la referencia, el valor y la descripción, igualmente el usuario puede escoger el idioma en que se visualizará la pasarela, entre ingles, español y portugués. 20

21 2. Después visualizará la sección de medios de Pago, esta dependerá específicamente del país escogido. En la imagen están los medios de Pago disponibles para Colombia. En la lista desplegable podrá seleccionar los países para los cuales estén habilitados los medios de pago. Para este ejemplo, seleccione el país Panamá y el Medio de Pago tarjetas de crédito, haciendo clic en el botón Pagar, inmediatamente el pagador final será orientado a completar el pago con el medio elegido. En este caso se trata de pago con tarjeta de crédito. 3. Por favor tener en cuenta que debe escoger la franquicia que aplique para realizar el pago correspondiente, para la prueba escogeremos VISA. En este caso debe llenar y diligenciar todos los datos necesarios como número de tarjeta, cuotas, entre otras como se muestra a continuación: 21

22 4. Ingrese los datos como se muestra en la imagen, que no corresponden a una tarjeta de crédito real. Una vez se envía la información a la red se obtiene la respuesta, en este caso de no finalización exitosa del movimiento. 5. La plataforma le comunicará al usuario el resultado y le da la oportunidad de intentarlo nuevamente con otro medio de pago. 6. Para finalizar, le será enviado un correo al comprador informándole el estado de su transacción. 22

23 23

24 - 24

25 5 Páginas de Respuesta y Confirmación. 25

26 5. Páginas de Respuesta y Confirmación 5.1 Configuración En esta sección se examinarán los conceptos de página de Respuesta y página de Confirmación, fundamentales en el proceso de retroalimentación sobre las transacciones efectuadas. Lo primero que debe hacer es configurar estos sitios Web dentro de PAYU, una forma para hacer esto es: en la pestaña configuración, hacer clic sobre configuración cuentas del módulo administrativo. Estas variables deben ser la URL completa de la página de confirmación y respuesta (incluyendo ó si lo prefiere se puede configurar, enviando una variable adicional en el código por el que se conectan a nuestra plataforma. 26

27 Los nombres de las variables son: confirmationurl responseurl Este sería el código que debe colocar en el formulario de envío, (recuerde personalizar sus datos en las letras rojas). <input name="confirmationurl" type="hidden" value=" <input name="responseurl" type="hidden" value=" shop.com/response.php"> Así una vez finalice la transacción, la pasarela realizará los llamados a las url configuradas. Los valores de la transacción con los que se calcula la firma tanto para la página de confirmación y respuesta son con un decimal, para modificar estos valores se puede utilizar el siguiente código: New_value=number_format($Oldvalue, 1, '.', ''); La firma enviada a la página de respuesta se envía en el campo signature y el sistema la genera de la siguiente manera: Api_Key~merchantId~referenceCode~$TX_VALUE~currency~transactionState La firma enviada a la página de confirmación se envía en el campo sign y el sistema la genera de la siguiente manera: Api_Key~merchant_id~reference_sale~$value~currency~state_pol 5.2 Página de respuesta Al finalizar una transacción nuestro sistema enviará al pagador a la página de respuesta. A esta página nuestro sistema le envía información a través del método GET, de esta forma se le da información al pagador sobre el estado de una transacción. 27

28 5.3 Página de Confirmación La página de confirmación le permite actualizar las bases de datos de su sistema; por esto, no debe incluir código HTML ya que nunca será visible al comprador. Cuando una transacción finaliza, es decir cuando se aprueba, se rechaza o cuando es cancelada, nuestra plataforma envía las variables por medio del método POST. En la página de confirmación, usted debe realizar la captura de los de los datos que se desee guardar en la base de datos. Esta captura dependerá del lenguaje de programación utilizado. 28

29 6 Transacciones en Producción en Producción 29

30 6. Transacciones en Producción Luego de que realice todas las pruebas del sistema y verifique que todo está funcionando correctamente, se puede realizar el cambio al servidor de producción. Para realizar esto, es necesario que este seguro que todos los datos de su cuenta estén en el código, es decir, que su API KEY y su usuario Id sean los correctos. Primero debe eliminar o cambiar la variable prueba en la página de envío de la siguiente manera. <input name="test" type="hidden" value="1"> ó <input name="test" type="hidden" value="0"> Para revisar las transacciones realizadas en su sitio Web, debe ingresar al módulo administrativo y dirigirse a la pestaña Reportes. Allí podrá consultar las operaciones efectuadas y generar reportes según sus necesidades. 30

31 7 Anexos 31

32 7. Anexos 7.1 Convenciones TIPO DE DATO N DESCRIPCIÓN Numérico D Decimal (#.00) AN L F Alfa numérico Lógico (true, false) Fecha (YYYY-MM-DD HH:mm:ss) 7.2 Variables que se envían a la Pasarela CAMPO TIPO TAMAÑO DESCRIPCIÓN amount D 14 merchantid N 12 referencecode A 50 accountid N 12 Es el monto total de la transacción. Puede contener dos dígitos decimales. Ej ó Es el número identificador de su comercio en el sistema de PAYU, este número lo encontrará en el correo de creación de la cuenta. Campo Obligatorio Es la referencia de la venta o pedido. Deber ser único por cada transacción que se envía al sistema. Campo Obligatorio Identificador de la cuenta del usuario para cada país que tenga asociado el comercio, al enviarla se despliegan solo los medios de pago pertenecientes a dicho país. Campo Obligatorio 32

33 description A 255 tax N 14,2 taxreturnbase N 14,2 Es la descripción de la venta. Campo Obligatorio Es el valor del IVA de la transacción, si se envía el IVA nulo el sistema aplicará el 16% automáticamente. Puede contener dos dígitos decimales. Ej: En caso de no tener IVA debe enviarse en 0. Campo Obligatorio Es el valor base sobre el cual se calcula el IVA. En caso de que no tenga IVA debe enviarse en 0. Campo Obligatorio signature N 32 Es la firma digital creada para cada uno de las transacciones. Campo Obligatorio currency N 3 La moneda respectiva en la que se realiza el pago. El proceso de conciliación se hace en pesos a la tasa representativa del día. Ver las divisas admitidas en el Anexo 7.2 Campo Obligatorio adicionalvaluefirstp ay N 14,2 Valor Adicional Primer Pago test N 2 Variable para poder utilizar tarjetas de crédito de pruebas. buyer A 255 Campo que contiene el correo electrónico del comprador para notificarle el resultado de la transacción por correo electrónico. Se recomienda hacer una validación si se toma este dato en un formulario. adicionalvalue N 14,2 Valor Adicional no Comisionable lng A 3 Idioma en el que se desea mostrar la pasarela de pagos. Ver los lenguajes admitidos en el anexo7.3 33

34 extra1 A 255 Campo adicional para enviar información sobre la compra. Ej. Descripción de la compra en caso de querer visualizarla en la página de respuesta extra2 A 255 Campo adicional para enviar información sobre la compra. Ej. Códigos internos de los productos. responseurl A 255 La url de la página de respuesta. confirmationurl A 255 La url de la página de confirmación. payerfullname A 50 El nombre del comprador. Este valor se tomará para llenar el formulario de tarjetas crédito. payerdocument A 25 El número de identificación del comprador. Este valor se tomará para llenar el formulario de tarjetas crédito. mobilephone A 50 El número celular del comprador. Este valor se tomará para llenar el formulario de tarjetas crédito y será el teléfono de contacto. billingaddress A 255 La dirección de correspondencia shippingaddress A 255 La dirección de entrega de la mercancía. telephone A 50 El teléfono de residencia del comprador. officetelephone A 50 El teléfono diurno del comprador. 34

35 discount D - Valor del descuento sobre la venta algorithmsignature A 255 Algoritmo de cifrado de la firma digital (signature) extra3 A 255 Campo adicional para enviar información sobre la compra. Ej. Códigos internos de los productos. template AN 255 Plantilla para la página de pagos. airline A 4 Código de la aerolínea. billingcity AN 50 Ciudad asociada a la dirección de facturación. shippingcity A 50 La Ciudad de entrega de la mercancía. zipcode AN 20 Código postal. billingcountry AN 50 País asociado a la dirección de facturación. shippingcountry A 50 El país de entrega de la mercancía. buyerfullname AN 150 Nombre completo del comprador paymentmethods A - Tipos medios de pago administrativefee D - Valor de la tarifa administrativa 35

36 taxadministrativefee D - Valor del impuesto de la tarifa administrativa taxadministrativefee ReturnBase D - Valor base de la tarifa administrativa para la devolución del impuesto. payer AN 255 Correo electrónico del pagador payerphone AN 20 Numero telefónico del pagador payerofficephone AN 20 Numero telefónico del lugar de trabajo del pagador payermobilephone AN 20 Numero teléfono móvil del pagador 7.3 Código de Divisas Admitidas (moneda) CODIGO ISO 4217 COP MXN USD PEN MONEDA Pesos Colombianos Pesos Mexicanos U.S. Dólar Soles Peruanos 36

37 7.4 Idiomas Admitidos (lng) CÓDIGO ISO 639 IDIOMA EN ES Inglés Español 7.5 Estados de la Transacción (estado_pol) 7.4 Estado s de la Transa cción (estad o_lap) NOMBRE 102 VERIFIED CÓDIGO DESCRIPCION 2 NEW Estado inicial de la transacción. 101 FX_CONVERTED Retornado por el conversor de monedas, indicando la modificación realizada. Indica que la transacción fue evaluada por nuestro módulo antifraude. 103 SUBMITTED Movimiento fue enviado para su procesamiento al proveedor de pago. 4 APPROVED La transacción fue aprobada por la entidad financiera. 6 DECLINED Transacción Declinada o Abandonada. 104 ERROR Se presentó un error con el medio de pago externo. 7 PENDING Operación pendiente de finalización. 5 EXPIRED Transacción expiró, por superar el tiempo límite de respuesta. 37

38 7.6 Código de Respuesta (codigo_respuesta_pol) CÓDIGO DESCRIPCION 1 Transacción Aprobada 4 Transacción rechazada por la entidad 5 Transacción declinada por la entidad financiera 6 Fondos insuficientes 7 Tarjeta inválida 8 Es necesario contactar a la entidad 9 Tarjeta vencida 10 Tarjeta restringida 12 Fecha de expiración o campo seg. Inválidos 13 Repita transacción 14 Transacción inválida 15 Transacción enviada a Validación Manual 17 Monto excede máximo permitido por entidad 22 Tarjeta no autorizada para realizar compras por internet 23 Transacción Rechazada por el Modulo Antifraude 50 Transacción Expirada, antes de ser enviada a la red del medio de pago 38

39 51 Ocurrió un error en el procesamiento por parte de la Red del Medio de Pago 52 El medio de Pago no se encuentra Activo. No se envía la solicitud a la red del mismo 53 Banco no disponible 54 El proveedor del Medio de Pago notifica que no fue aceptada la transacción 55 Error convirtiendo el monto de la transacción 56 Error convirtiendo montos del deposito 9994 Transacción pendiente por confirmar 9995 Certificado digital no encontrado 9997 Error de mensajería con la entidad financiera Ajustado Automáticamente Ajuste Automático y Reversión Exitosa Ajuste Automático y Reversión Fallida Ajuste automático no soportado Error en el Ajuste Error en el ajuste y reversión 39

40 7.7 Código de Respuesta (codigo_respuesta_lap) ESTADO DESCRIPCIÓN APPROVED La transacción fue aprobada DECLINED La transacción fue rechazada ERROR Ocurrió un error procesando la transacción PENDING La transacción quedó pendiente ENTITY_DECLINED La transacción fue declinada por el banco ANTIFRAUD_REJECTED La transacción fue rechazada por el sistema anti-fraude PENDING_TRANSACTION_REVIEW La transacción fue detenida y debe ser revisada, esto puede ocurrir por filtros de seguridad INTERNAL_PAYMENT_PROVIDER_E RROR Ocurrió un error en el sistema intentando procesar el pago INACTIVE_PAYMENT_PROVIDER El proveedor de pagos no se encontraba activo DIGITAL_CERTIFICATE_NOT_FOUN D La red financiera reportó un error en la autenticación PAYMENT_NETWORK_REJECTED La red financiera rechazó la transacción INVALID_EXPIRATION_DATE_OR_SE CURITY_CODE El código de seguridad o la fecha de expiración estaba inválido INSUFFICIENT_FUNDS La cuenta no tenía fondos suficientes CREDIT_CARD_NOT_AUTHORIZED_ FOR_INTERNET_TRANSACTIONS La tarjeta de crédito no estaba autorizada para transacciones por Internet 40

41 INVALID_TRANSACTION La red financiera reportó que la transacción fue inválida INVALID_CARD La tarjeta es inválida EXPIRED_CARD La tarjeta ya expiró RESTRICTED_CARD La tarjeta presenta una restricción CONTACT_THE_ENTITY Debe contactar al banco REPEAT_TRANSACTION Se debe repetir la transacción ENTITY_MESSAGING_ERROR La red financiera reportó un error de comunicaciones con el banco PENDING_TRANSACTION_CONFIRM ATION La transacción está pendiente de ser confirmada BANK_UNREACHABLE El banco no se encontraba disponible EXCEEDED_AMOUNT La transacción excede un monto establecido por el banco NOT_ACCEPTED_TRANSACTION La transacción no fue aceptada por el banco por algún motivo ERROR_CONVERTING_TRANSACTIO N_AMOUNTS Ocurrió un error convirtiendo los montos a la moneda de pago 41

42 7. 8 Variables que se Envían a la Página de Respuesta CAMPO TIPO TAM. DESCRIPCIÓN merchantid N 12 Es el número identificador del comercio en el sistema de PAYU, este número lo encontrará en el correo de creación de la cuenta. transactionstate N 2 Indica el estado de la transacción en el sistema. risk D - El riesgo asociado a la transacción. Toma un valor entre 0 y 1. A mayor riesgo mayor valor. Viene en formato ###.00 polresponsecode AN 64 El código de respuesta de PAYU referencecode A 50 Es la referencia de la venta o pedido. Deber ser único por cada transacción que se envía al sistema. reference_pol AN 255 La referencia o número de la transacción generado en PAYU signature AN 255 Es la firma digital creada para cada uno de las transacciones. polpaymentmethod A 255 El identificador interno del medio de pago utilizado polpaymentmethodtype N 2 El tipo de medio de pago utilizado para el pago installmentsnumber N 2 Número de cuotas en las cuales se difirió el pago con tarjeta crédito. TX_VALUE N 14,2 Es el monto total de la transacción. Puede contener dos dígitos decimales. Ej ó

43 TX_TAX N 14,2 Es el valor del IVA de la transacción, si se envía el IVA nulo el sistema aplicará el 16% automáticamente. Puede contener dos dígitos decimales. Ej: En caso de no tener IVA debe enviarse en 0. buyer AN 255 Campo que contiene el correo electrónico del comprador para notificarle el resultado de la transacción por correo electrónico. Se recomienda hacer una validación si se toma este dato en un formulario. processingdate F - La fecha en que se realizó la transacción. currency A 3 La moneda respectiva en la que se realiza el pago. El proceso de conciliación se hace en pesos a la tasa representativa del día. Ver las divisas admitidas en el Anexo cus AN 255 El cus, código único de seguimiento, es la referencia del pago dentro del Banco, aplica solo para pagos con PSE psebank AN 255 El nombre del banco, aplica solo para pagos con PSE. lng A 2 Idioma en el que se desea mostrar la pasarela de pagos. Ver los lenguajes admitidos en el anexo. description A 255 Es la descripción de la venta lapresponsecode AN 64 Ver Anexo 7.6 lappaymentmethod A 255 Medio de pago con el cual se hizo el pago por ejemplo VISA lappaymentmethodtype A 255 Tipo de medio de pago con el que se realiza por ejemplo CREDIT_CARD laptransactionstate A 32 Ver Anexo

44 message A 255 Descripción del estado de la transacción extra1 A 255 Campo adicional para enviar información sobre la compra. Ej. Descripción de la compra en caso de querer visualizarla en la página de respuesta extra2 A 255 Campo adicional para enviar información sobre la compra. Ej. Códigos internos de los productos. extra3 A 255 Campo adicional para enviar información sobre la compra. Ej. Códigos internos de los productos. authorizationcode AN 12 Código de autorización de la venta. merchant_address AN 255 Dirección del comercio merchant_name AN 255 Nombre del comercio. merchant_url AN 255 URL del sitio web del comercio. orderlanguage A 2 Lenguaje de la orden (ISO-639-1) psecycle N - Identificador generado por PSE. psereference1 AN 255 Referencia no. 1 para pagos con PSE. psereference2 AN 255 Referencia no. 2 para pagos con PSE. psereference3 AN 255 Referencia no. 3 para pagos con PSE. telephone AN 20 Numero telefónico del comercio. transactionid AN 36 Identificador de la transacción. 44

45 trazabilitycode AN 64 Código de seguimiento de la venta en el sitio del comercio TX_ADMINISTRATIVE_FEE D - Valor de la tarifa administrativa TX_TAX_ADMINISTRATIVE_FEE D - Valor del impuesto de la tarifa administrativa TX_TAX_ADMINISTRATIVE_FEE _RETURN_BASE D - Valor base de la tarifa administrativa para la devolución de impuestos action_code_description * AN 255 Descripción del código de respuesta de VISANET cc_holder * AN 150 Nombre del tarjeta habiente cc_number * AN Numero de la tarjeta de crédito. PAN processing_date_time * F - Fecha y hora del procesamiento de la venta request_number * AN 9 Numero de la orden + identificador de la transacción. Nota: * Estas variables solo aplican para VISANET Perú 45

46 7. 9 Variables que se Envían a la Página de Confirmación CAMPO TIPO TAM. DESCRIPCIÓN merchant_id N 12 Es el número identificador del comercio en el sistema de PAYU, este número lo encontrará en el correo de creación de la cuenta. state_pol A 32 Indica el estado de la transacción en el sistema. risk D - El riesgo asociado a la transacción. Toma un valor entre 0 y 1. A mayor riesgo mayor valor. Viene en formato ###.00 response_code_pol AN 255 El código de respuesta de PAYU reference_sale AN 255 Es la referencia de la venta o pedido. Deber ser único por cada transacción que se envía al sistema. reference_pol AN 255 La referencia o número de la transacción generado en PAYU sign AN 255 Es la firma digital creada para cada uno de las transacciones. extra1 A 255 Campo adicional para enviar información sobre la compra. Ej. Descripción de la compra en caso de querer visualizarla en la página de respuesta extra2 A 255 Campo adicional para enviar información sobre la compra. Ej. Códigos internos de los productos. payment_method N - El identificador interno del medio de pago utilizado 46

47 payment_method_type N - El tipo de medio de pago utilizado para el pago installments_number N - Número de cuotas en las cuales se difirió el pago con tarjeta crédito. value N 14,2 Es el monto total de la transacción. Puede contener dos dígitos decimales. Ej ó tax N 14,2 Es el valor del IVA de la transacción, si se envía el IVA nulo el sistema aplicará el 16% automáticamente. Puede contener dos dígitos decimales. Ej: En caso de no tener IVA debe enviarse en 0. additional_value N 14,2 Valor Adicional no Comisionable transaction_date F - La fecha en que se realizó la transacción. currency A 3 La moneda respectiva en la que se realiza el pago. El proceso de conciliación se hace en pesos a la tasa representativa del día. Ver las divisas admitidas en el Anexo _buyer A 255 Campo que contiene el correo electrónico del comprador para notificarle el resultado de la transacción por correo electrónico. Se recomienda hacer una validación si se toma este dato en un formulario. cus AN 64 El cus, código único de seguimiento, es la referencia del pago dentro del Banco, aplica solo para pagos con PSE pse_bank AN 255 El nombre del banco, aplica solo para pagos con PSE. test L - Variable para poder identificar si la operación fue una prueba. description A 255 Es la descripción de la venta 47

48 billing_address A 255 La dirección de facturación shipping_address AN 50 La dirección de entrega de la mercancía. phone AN 20 El teléfono de residencia del comprador. office_phone AN 20 El teléfono diurno del comprador. account_number_ach AN 36 Identificador de la transacción. account_type_ach AN 36 Identificador de la transacción. administrative_fee D - Valor de la tarifa administrativa administrative_fee_base D - Valor base de la tarifa administrativa administrative_fee_tax D - Valor del impuesto de la tarifa administrativa airline_code A 4 Código de la aerolínea attempts N - Numero de intentos del envío de la confirmación. authorization_code AN 12 Código de autorización de la venta bank_id A 255 Identificador del banco billing_city A 255 La ciudad de facturación billing_country A 255 El país de facturación commision_pol D - Valor de la comisión commision_pol_currency A 3 Moneda de la comisión customer_number N - Numero de cliente 48

49 date F - Fecha de la operación. error_code_bank AN 255 Código de error del banco error_message_bank AN 255 Mensaje de error del banco exchange_rate D - Valor de la tasa de cambio. ip AN 39 Dirección ip desde donde se realizo la transacción. nickname_buyer AN 150 Nombre corto del comprador. nickname_seller AN 150 Nombre corto del vendedor. payment_method_id N - Identificador del medio de pago payment_request_stateñ A 32 Estado de la solicitud de pago. psereference1 AN 255 Referencia no. 1 para pagos con PSE. psereference2 AN 255 Referencia no. 2 para pagos con PSE. psereference3 AN 255 Referencia no. 3 para pagos con PSE. response_message_pol AN 255 El mensaje de respuesta de PAYU shipping_city AN 50 La ciudad de entrega de la mercancía. shipping_country A 2 El país de entrega de la mercancía. transaction_bank_id AN 255 Identificador de la transacción en el sistema del banco transaction_id AN 36 Identificador de la transacción. 49

50 8 Glosario 50

51 Método POST: es un método por el que envía la información un formulario, la principal característica de este método es que envía los datos codificados en el flujo de datos HTTP y los datos no serán visibles para el usuario. Método GET: es un método por el que envía la información un formulario, la principal característica de este método es que envía los datos utilizando la url, por esto los datos serán visibles para el usuario. Secure: es el módulo administrativo que ofrece PAYU en él se pueden consultar las transacciones y obtener la información necesario para realizar la integración para acceder a él se debe ir a merchantid: es el identificador único de cada comercio en PAYU para poder obtener un UsuarioID es necesario adquirir una cuenta en PAYU. API KEY: es un valor alfanumérico que se utiliza para codificar la comunicación entre PAYU y su sitio web, se puede obtener en el módulo administrativo secure ( Servidor de Producción: es el servidor donde se procesan todas las transacciones reales en PAYU para tener una aplicación apuntando al servidor de producción deben apuntar a: Servidor de pruebas: es el servidor que usted debe utilizar durante el proceso de desarrollo de la integración, para poder simular los diferentes estados de las transacciones, para tener una aplicación apuntando al servidor de pruebas deben apuntar a: Página Respuesta: es la página a la cual será direccionado el comprador una vez finaliza la transacción en PAYU, en esta página usted debe mostrar el estado de la transacción, esta página puede ser configurada en el módulo administrativo secure o debe enviarla en la variable responseurl. Página Confirmación: es la página a la cual PAYU enviará la confirmación del pago una vez la transacción llega a un estado final, esta página no debe contener código html ya que es para uso de su sistema y no del comprador, esta página puede ser configurada en el módulo administrativo secure o debe enviarla en la variable confirmationurl. 51