ndcgfhj

1

PayuLatam / PBX 57(1) 756 3126 / Dirección Calle 93 b # 17-25 Oficina 301, Bogotá D.C.

www.payulatam.com / Email: [email protected]

MANUAL DE

INTEGRACIÓN TRADICIONAL

V 0.3

Manual de

Integración Tradicional

V 1.0

2



MANUAL DE


V 0.3

Control de Cambios

Date Responsible Version Description

Noviembre/10/2012 Diego Zarate R1 1. Primera Versión

Abril/12/2013 Angela Acosta R2 1. Actualizaciones

2. Modificaciones Varias

3



MANUAL DE


V 0.3

Tabla de

Contenido

1. Flujo de una Transacción . . . . . . . . . . . . . . . . . . . . . . . 4

2. Prerrequisitos de una Integración Tradicional con PAYU . . . 11

3. Cómo Conectarse con PAYU . . . . . . . . . . . . . . . . . . . . . . 14

3.1 Consideraciones sobre Variables . . . . . . . . . . . . . 15

4. Pruebas de Pagos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

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

5.1 Configuración . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

5.2 Página de Respuesta . . . . . . . . . . . . . . . . . . . . . . 27

5.3 Página de Confirmación . . . . . . . . . . . . . . . . . . . . 28

6. Transacciones en Producción . . . . . . . . . . . . . . . . . . . . . 30

7. Anexos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

7.1 Convenciones . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

7.2 Variables que se Envían a la Pasarela . . . . . . . . . . . 32

7.3 Código de Divisas Admitidas . . . . . . . . . . . . . . . . . 36

7.4 Idiomas Admitidos (lng) . . . . . . . . . . . . . . . . . . . . 37

7.5 Estados de la Transacción (estado_lap) . . . . . . . . . . 37

7.6 Código de Respuesta (codigo_respuesta_pol) . . . . . . . 38

7.7 Código de Respuesta (codigo_respuesta_lap) . . . . . . . 40

7.8 Variables que se Envían a la Página de Respuesta . . . . 42

7.9 Variables que se Envían a la Página de Confirmación . . 46

8. Glosario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

4



MANUAL DE


V 0.3

Flujo de una

1 Transacción

5



MANUAL DE


V 0.3

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.

6



MANUAL DE


V 0.3

7



MANUAL DE


V 0.3

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.

8



MANUAL DE


V 0.3

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

PAYU.

9



MANUAL DE


V 0.3

4. Nuestro sistema devuelve al comprador a una “Página de respuesta” dentro de

PAYU donde visualizará el resultado de la transacción.

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

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

10



MANUAL DE


V 0.3

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.

11



MANUAL DE


V 0.3

Prerrequisitos de una Integración

2 Tradicional con PAYU

12



MANUAL DE


V 0.3

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 https://secure.payulatam.com

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 ApiKey que le permitirá

realizar transacciones. Dicha ApiKey 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

https://secure.payulatam.com/

13



MANUAL DE


V 0.3

configuración en nuestros sistema, el primero de ellos denominado ApiKey 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.

14



MANUAL DE


V 0.3

Cómo Conectarse

3 con PAYU

15



MANUAL DE


V 0.3

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:

https://gateway.payulatam.com/ppp-web-gateway

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. 10000.00 ó 10000.

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: 16000.00. 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.

16



MANUAL DE


V 0.3

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.

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, al enviarla se despliegan solo

los medios de pago pertenecientes a dicho país. Campo

Opcional

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.

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

17



MANUAL DE


V 0.3

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 ApiKey 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: 500238

ApiKey: 6u39nqhq8ftd0hlvnjfs66eh8c

referenceCode: TestPayU

amount: 3

currency: USD

accountId: 500537

buyerEmail: [email protected]

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 486,000

Nota: El monto de tax + taxReturnBase no puede ser mayor que el Valor Total


18



MANUAL DE


V 0.3

La firma la conformarían los siguientes elementos

"6u39nqhq8ftd0hlvnjfs66eh8c ~500238~TestPayU~3~USD”

La cual tras aplicársele algoritmo md5 quedaría así

“4025327fc18e2703dda1f89fbcab2b02”

En el ejemplo mencionado usamos Dólares Americanos. Para conocer más sobre las

divisas admitidas por favor dirigirse al Anexo 7.2.

19



MANUAL DE


V 0.3

Pruebas de Pagos

4

20



MANUAL DE


V 0.3

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: 500238

ApiKey: 6u39nqhq8ftd0hlvnjfs66eh8c

referenceCode: TestPayU

accountId: 500537

description = Test PAYU

amount: 3

tax: 0

taxReturnBase: 0

currency: USD

signature: 4025327fc18e2703dda1f89fbcab2b02

test: 1

buyerEmail: [email protected]

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.

Envíe estas variables en un formulario a la dirección:

https://stg.gatewaylap.pagosonline.net/ppp-web-gateway

Y obtendrá acceso a la pasarela de pagos, que debe verse similar a la siguiente:

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.

https://stg.gatewaylap.pagosonline.net/ppp-web-gateway

21



MANUAL DE


V 0.3

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

22



MANUAL DE


V 0.3

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:

23



MANUAL DE


V 0.3

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.

24



MANUAL DE


V 0.3

25



MANUAL DE


V 0.3

-

26



MANUAL DE


V 0.3

Páginas de Respuesta

y Confirmación.

5

27



MANUAL DE


V 0.3

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 http://), ó si lo prefiere se puede configurar,

enviando una variable adicional en el código por el que se conectan a

nuestra plataforma.

28



MANUAL DE


V 0.3

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="http://www.shop.com/confirmation.php">

<input name="responseUrl" type="hidden" value="

http://www. 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:

“ApiKey~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:

“ApiKey~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.

29



MANUAL DE


V 0.3

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.

30



MANUAL DE


V 0.3

Transacciones

en Producción

6 en Producción

31



MANUAL DE


V 0.3

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 ApiKey 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 https://secure.payulatam.com y dirigirse a la pestaña Reportes. Allí

podrá consultar las operaciones efectuadas y generar reportes según sus necesidades.


32



MANUAL DE


V 0.3

Anexos

7

33



MANUAL DE


V 0.3

7. Anexos

7.1 Convenciones

7.2 Variables que se envían a la Pasarela

CAMPO TIPO TAMAÑO DESCRIPCIÓN

amount D 14 Es el monto total de la transacción. Puede contener dos dígitos decimales. Ej. 10000.00 ó 10000.

merchantId N 12

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

referenceCode A 50 Es la referencia de la venta o pedido. Deber ser único por cada transacción que se envía al sistema. Campo Obligatorio

accountId N 12

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

Opcional

TIPO DE DATO DESCRIPCIÓN

N Numérico

D Decimal (#.00)

AN Alfa numérico

L Lógico (true, false)

F Fecha (YYYY-MM-DD HH:mm:ss)

34



MANUAL DE


V 0.3

description A 255 Es la descripción de la venta.

Campo Obligatorio

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: 16000.00. En caso de no tener IVA debe enviarse en 0. Campo Obligatorio

taxReturnBase N 14,2 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

adicionalValueFirstPay

N 14,2 Valor Adicional Primer Pago

test N 2 Variable para poder utilizar tarjetas de

crédito de pruebas.

buyerEmail 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

35



MANUAL DE


V 0.3

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


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.

36



MANUAL DE


V 0.3

discount D - Valor del descuento sobre la venta

algorithmSignature A 255 Algoritmo de cifrado de la firma digital

(signature)

extra3 A 255


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

37



MANUAL DE


V 0.3

taxAdministrativeFee D -

Valor del impuesto de la tarifa

administrativa

taxAdministrativeFeeReturnBase

D - Valor base de la tarifa administrativa para

la devolución del impuesto.

payerEmail 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 MONEDA

COP Pesos Colombianos

MXN Pesos Mexicanos

USD U.S. Dólar

PEN Soles Peruanos

38



MANUAL DE


V 0.3

7.4 Idiomas Admitidos (lng)

7.5 Estados de la Transacción (lapTransactionState)

7.4 Estados de la Transacción (estado_lap) CÓDIGO

NOMBRE DESCRIPCION

2 NEW Estado inicial de la transacción.

101 FX_CONVERTED Retornado por el conversor de monedas, indicando

la modificación realizada.

102 VERIFIED 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.

CÓDIGO ISO 639 IDIOMA

EN Inglés

ES Español

39



MANUAL DE


V 0.3

7.6 Código de Respuesta (lapResponseCode)

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

40



MANUAL DE


V 0.3

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

10000 Ajustado Automáticamente

10001 Ajuste Automático y Reversión Exitosa

10002 Ajuste Automático y Reversión Fallida

10003 Ajuste automático no soportado

10004 Error en el Ajuste

10005 Error en el ajuste y reversión

41



MANUAL DE


V 0.3

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_ERROR

Ocurrió un error en el sistema intentando procesar el pago

INACTIVE_PAYMENT_PROVIDER El proveedor de pagos no se encontraba activo

DIGITAL_CERTIFICATE_NOT_FOUND

La red financiera reportó un error en la autenticación

PAYMENT_NETWORK_REJECTED La red financiera rechazó la transacción

INVALID_EXPIRATION_DATE_OR_SECURITY_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

42



MANUAL DE


V 0.3

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_CONFIRMATION

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_TRANSACTION_AMOUNTS

Ocurrió un error convirtiendo los montos a la moneda de pago

43



MANUAL DE


V 0.3

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. 10000.00 ó 10000

44



MANUAL DE


V 0.3

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: 16000.00. En caso de no tener IVA debe enviarse en 0.

buyerEmail 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 7.5

45



MANUAL DE


V 0.3

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.


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.



telephone AN 20 Numero telefónico del comercio.

transactionId AN 36 Identificador de la transacción.

46



MANUAL DE


V 0.3

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ú

47



MANUAL DE


V 0.3

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


payment_method N - El identificador interno del medio de pago utilizado

48



MANUAL DE


V 0.3

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. 10000.00 ó 10000

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: 16000.00. 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

email_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

49



MANUAL DE


V 0.3

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

50



MANUAL DE


V 0.3

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.




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.

51



MANUAL DE


V 0.3

Glosario

8

52



MANUAL DE


V 0.3

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 https://secure.payulatam.com.

merchantId: es el identificador único de cada comercio en PAYU para poder

obtener un UsuarioID es necesario adquirir una cuenta en PAYU.

ApiKey: 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

(https://secure.payulatam.com).

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:

https://gateway.payulatam.com/ppp-web-gateway

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:

https://stg.gatewaylap.pagosonline.net/ppp-web-gateway/

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.



https://stg.gatewaylap.pagosonline.net/ppp-web-gateway/

ndcgfhj

Documents

Transcript of ndcgfhj