pasarelaintegral es

Gua de integracin

Espaaltima actualizacin: Mayo de 2014de Pasarela integral

mLaCoBoNono

NoPaexindees 1999 - 2014 PayPal, Inc. Todos los derechos reservados. PayPal es una marca comercial registrada de PayPal, Inc. El logotipo de PayPal es una arca comercial de PayPal, Inc. Las dems marcas comerciales que aparecen en este documento pertenecen a sus respectivos propietarios. informacin de este documento pertenece a PayPal, Inc. No se puede utilizar, reproducir o revelar sin el permiso por escrito de PayPal, Inc.Gua de integracin de Pasarela integral

Nmero de documento: 10117.en_US-201308pyright PayPal. Todos los derechos reservados. PayPal (Europe) S. r.l. et Cie., S.C.A., Socit en Commandite par Actions. Sede social: 22-24 ulevard Royal, L-2449, Luxemburgo, R.C.S. Luxemburgo B 118 349.ta para el consumidor: el servicio de pagos de PayPal se considera un servicio de valor almacenado regulado por las leyes de Singapur. Como tal, requiere la aprobacin de las autoridades monetarias de Singapur. Le recomendamos que lea los trminos y las condiciones detenidamente.

ta de exencin de responsabilidad:yPal, Inc. le proporciona a usted esta informacin TAL CUAL, con todos sus fallos. PayPal, Inc. no garantiza en modo alguno (ya sea de forma presa, implcita o legal) la informacin contenida en este documento. PayPal, Inc. no asume responsabilidad alguna por daos (ni directos ni directos), por errores u omisiones, o causados por el uso de este documento o de la informacin que contiene o consecuencia de la aplicacin o el uso l producto o del servicio descritos en este documento. PayPal, Inc. se reserva el derecho de realizar cambios a cualquier informacin contenida en te documento sin previo aviso.

ndice general

Captulo 4 Integracin de iFrame en su sitio web . . . . . . . . . . . 45

Integracin de iFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46IntegInteg3

racin manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46racin de API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Prlogo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Acerca de esta gua . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

A quin va dirigida esta gua? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Historial de revisiones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Sugerencias sobre la documentacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Captulo 1 Introduccin a Pasarela integral . . . . . . . . . . . . . . 11

Descripcin general . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Funciones y ventajas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Funcionamiento de Pasarela integral . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Proteccin del vendedor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Revisin del pago instantnea. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Procesamiento de transacciones con Pago exprs de PayPal . . . . . . . . . . . . . . . 15

Introduccin a la integracin con Pasarela integral . . . . . . . . . . . . . . . . . . . . . 16

Captulo 2 Integracin de su sitio web mediante HTML . . . . . . . . 17

Integracin sencilla de Pasarela integral. . . . . . . . . . . . . . . . . . . . . . . . . . . 17Ejemplo de integracin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Variables HTML para la configuracin de la pgina de pago . . . . . . . . . . . . . . . . 19

Captulo 3 Personalizacin de su pgina de pago de PayPal . . . . . . 23

Modificacin de la configuracin de la cuenta PayPal . . . . . . . . . . . . . . . . . . . . 24Configuracin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Personalizacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Flujo de pago optimizado para mviles . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Variables HTML para personalizar el aspecto de la pgina de pago . . . . . . . . . . . . 42

ndice general

4Captulo 5 Integracin de su sitio web mediante API . . . . . . . . . . 51

Uso de la API de administrador de botones con el flujo de pago de Pasarela integral . . . 52Utilizar la URL devuelta en la respuesta (recomendada) . . . . . . . . . . . . . . . . 52Uso de Form POST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Encriptacin de botones utilizando claves pblicas yprivadas . . . . . . . . . . . . . 55Ejemplo de inicio del proceso de pago en Pasarela integral . . . . . . . . . . . . . . 55

Operacin de API BMCreateButton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Solicitud de BMCreateButton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Respuesta de BMCreateButton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58Errores de BMCreateButton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Captulo 6 Prueba de la integracin en el entorno de pruebas . . . . . 59

Credenciales de la cuenta del entorno de pruebas . . . . . . . . . . . . . . . . . . . . . 59

Prueba de la integracin y la configuracin . . . . . . . . . . . . . . . . . . . . . . . . . 62Prueba de la integracin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62Prueba de la configuracin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Captulo 7 Procesamiento de pedidos . . . . . . . . . . . . . . . . . 65

Verificacin de la autenticidad y el estado de la transaccin . . . . . . . . . . . . . . . . 65Validar notificacin de pago instantnea (IPN) . . . . . . . . . . . . . . . . . . . . . 66Ejecutar una llamada de API GetTransactionDetails . . . . . . . . . . . . . . . . . . 66

Cumplimentacin del pedido . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Captulo 8 Proteccin de botones utilizando Pago estndar encriptado . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Encriptacin de clave pblica utilizada por Pago estndar encriptado . . . . . . . . . . . 68

Configuracin de certificados antes de utilizar Pago estndar encriptado. . . . . . . . . . 68Generacin de su clave privada utilizando OpenSSL . . . . . . . . . . . . . . . . . . 69Generacin de su certificado pblico utilizando OpenSSL . . . . . . . . . . . . . . . 69Carga de su certificado pblico en su cuenta PayPal . . . . . . . . . . . . . . . . . . 69Descarga del certificado pblico de PayPal del sitio web de PayPal . . . . . . . . . . 70Eliminacin del certificado pblico . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Uso de Pago estndar encriptado para proteger los botones de pago . . . . . . . . . 71Bloqueo de pagos estndar desprotegidos y no encriptados . . . . . . . . . . . . . . 72

Apndice A Operaciones de API opcionales . . . . . . . . . . . . . . . 73

API GetTransactionDetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

ndice generalSolicitud de GetTransactionDetails . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Respuesta de GetTransactionDetails . . . . . . . . . . . . . . . . . . . . . . . . . . 74

API RefundTransaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Solicitud de RefundTransaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Respuesta de RefundTransaction . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

API DoCapture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Solicitud de DoCapture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Respuesta de DoCapture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Apndice B Cambio de Pago estndar a Pasarela integral . . . . . . . 91

Ejemplo de comparacin de cdigo . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Apndice C Mensajes de error . . . . . . . . . . . . . . . . . . . . . . 95

Apndice D Cdigos de divisa . . . . . . . . . . . . . . . . . . . . . . 975

ndice general

6

P Prlogo

Espaa Pasarela integral

Reino Unido Solucin alojada Pago Pro7Acerca de esta guaEn la Gua de integracin de Pasarela integral se describe cmo realizar la integracin con Pasarela integral. Incluye informacin sobre: Funciones y ventajas de Pasarela integral. Proteccin del vendedor. Cambio de Pago estndar a Pasarela integral. Integracin de su sitio web con Pasarela integral. Personalizacin de su pgina de pago alojada. Prueba de la integracin en el entorno de pruebas. Verificacin del estado y la autenticidad de las transacciones antes de cumplimentar los

pedidos.

A quin va dirigida esta gua?Esta gua est pensada para vendedores que quieran realizar la integracin con Pasarela integral para aadir el procesamiento de transacciones a su sitio web. Pasarela integral no est disponible en los Estados Unidos. Solo est disponible en los pases que figuran en la tabla siguiente. El nombre del producto puede variar segn el pas.

Pas Nombre del producto

Australia Solucin alojada Pago Pro

Francia PayPal Intgral Evolution

Hong Kong Solucin alojada Pago Pro

Singapur Solucin alojada Pago Pro

Italia PayPal Pro

Japn Pago Plus

Historial de revisiones

8Para obtener ms informacin, vaya a https://developer.paypal.com/webapps/developer/docs/classic/products/website-payments-pro-hosted-solution/

Historial de revisionesHistorial de revisiones de Gua de integracin de Pasarela integral.

TABLA P.1 Historial de revisiones

Fecha Descripcin

Mayo de 2014 Se ha actualizado la URL de pagos seguros que se muestra en los ejemplos de toda la gua.Se ha eliminado el comando s-xclick de todos los ejemplos y tambin se han actualizado los ejemplos de Id. de botones alojados para usar HSSS en lugar de HSS.

Octubre de 2013 Se ha actualizado la lista de navegadores admitidos en Integracin de iFrame en su sitio web.

Agosto de 2013 Se han actualizado los captulos Prueba de la integracin en el entorno de pruebas y Mensajes de error.Se han actualizado los valores posibles del cdigo de idioma lc en la seccin Variables HTML para la configuracin de la pgina de pago. Se ha aadido una nota en la seccin Verificacin de la autenticidad y el estado de la transaccin de la configuracin de la cuenta PayPal que hace que se aada el Id. de transaccin a la URL de retorno.Se han actualizado el contenido y las URL.

Febrero de 2013 Se ha aadido una seccin en Flujo de pago optimizado para mviles.Se han actualizado los valores de la variable HTML template en la tabla Variables HTML para personalizar el aspecto de la pgina de pago.Se ha aadido informacin sobre las pginas de pago optimizadas mviles en el captulo Integracin de iFrame en su sitio web.

Octubre de 2012 Se han aadido las nuevas funciones de personalizacin de la pgina de pago al captulo Personalizacin de su pgina de pago de PayPal.

Agosto de 2012 Se ha actualizado la seccin A quin va dirigida esta gua?. Se ha actualizado el punto final en los ejemplos.

Julio de 2012 Se han eliminado las referencias a esta variable HTML obsoleta: shopping_url

Sugerencias sobre la documentacinSugerencias sobre la documentacinAydenos a mejorar esta gua enviando sus comentarios a:[email protected]

Junio de 2012 Se han actualizado los requisitos de los campos de direccin de facturacin en la seccin Variables HTML para la configuracin de la pgina de pago.

Se ha aadido una nota sobre limitaciones de caracteres a las siguientes secciones: Variables HTML para la configuracin de la pgina de pago, Variables HTML para personalizar el aspecto de la pgina de pago y Operacin de API BMCreateButton.

Se han corregido los ejemplos de HTML en el Captulo 2 y el Captulo 5.

Mayo de 2012 Se ha aadido IE9 a la lista de navegadores compatibles con iFrame.

TABLA P.1 Historial de revisiones

Fecha Descripcin9

Sugerencias sobre la documentacin

10

1 Introduccin a Pasarela integral

Proteccin del vendedor: este programa le protege contra devoluciones de cargo de transacciones con fondos ingresados con tarjeta de crdito o una cuenta PayPal. Si desea obten11

er ms informacin, consulte Proteccin del vendedor en la pgina 13.Descripcin generalPasarela integral de PayPal es una plataforma de pago que permite a los vendedores recibir pagos con fondos ingresados con tarjeta de crdito o una cuenta PayPal. Esta solucin la aloja PayPal. No tiene que capturar ni almacenar informacin de tarjetas de crdito en su sitio web, con lo que ganar puntos para alcanzar el cumplimiento PCI. Pasarela integral es la opcin para los vendedores que prefieren una solucin en la que PayPal gestione todos los datos financieros.Adems de Pasarela integral, PayPal recomienda que implemente el botn Pago exprs de PayPal en su sitio web. El botn aparece mucho antes en el flujo de pago y ofrece a los titulares existentes de cuentas PayPal la oportunidad de utilizar PayPal, con lo que se aumenta la proporcin de transacciones completadas.

Funciones y ventajasFunciones y ventajas de Pasarela integral: Cumplimiento de PCI: DSS de PCI (Payment Card Industry Data Security Standards,

estndares de seguridad de datos del sector de las tarjetas de crdito) es un estndar de seguridad global que se aplica a todas las empresas que recopilan, almacenan, procesan o transmiten informacin de titulares de tarjeta. Puede utilizar la pgina de pago alojada de PayPal como parte de la solucin de cumplimiento PCI para su empresa.

NOTA: La implementacin de Pasarela integral ayuda a conseguir el cumplimiento de las normas de PCI aunque no lo garantiza necesariamente.

Admite iFrame: PayPal ofrece un formulario compacto de pago que se puede integrar en un iFrame en su sitio web. El comprador completa el pago en su sitio web y usted puede mantener el aspecto y el estilo en el marco maestro que rodea el formulario compacto de pago. Los campos de tarjeta de crdito forman parte del formulario compacto de pago para que no tenga que reunir esta informacin por separado. Si desea obtener ms informacin, consulte Integracin de iFrame en su sitio web en la pgina 45.

Pagos por telfono: formulario de pago por Internet alojado por PayPal, que le permitir aceptar pedidos por telfono, por fax y por correo de las principales tarjetas de crdito.

Introduccin a Pasarela integralFuncionamiento de Pasarela integral

12 Pago exprs de PayPal: opcin de pago en dos pasos para titulares de cuentas PayPal. Si desea obtener ms informacin, consulte Procesamiento de transacciones con Pago exprs de PayPal en la pgina 15.

Admite las principales tarjetas de crdito y dbito: admite Visa, MasterCard y tarjeta Aurora (procesada por Cetelem).

Compatibilidad con dispositivos mviles: las pginas de pago de Pasarela integral estn optimizadas tanto para navegadores de escritorio como para navegadores mviles. Si desea obtener ms informacin, consulte Flujo de pago optimizado para mviles en la pgina 40.

Funcionamiento de Pasarela integral

En la figura anterior, el flujo de la parte superior es para pagar con la cuenta PayPal y el de la parte inferior es para pagar con tarjeta.Para integrar su sitio web con Pasarela integral:

1. Genere un botn en el flujo de pago de su sitio web mediante cdigo HTML o la solucin de API. El botn podra etiquetarse como Pagar o Comprar o algo parecido. Cuando el comprador hace clic en este botn, se le redirige a la pgina de pago alojada por PayPal.

2. En la pgina de pago, el comprador introduce la informacin de la tarjeta de dbito o crdito y hace clic en el botn Pagar ahora. No es necesario que tenga una cuenta PayPal, aunque tienen la opcin de utilizarla si la tienen.

Introduccin a Pasarela integralProteccin del vendedor3. Si la transaccin es correcta, el comprador ve la pgina de confirmacin de PayPal o se le redirige a la URL que usted haya especificado. Si la transaccin no es correcta, se muestra un mensaje de error y el comprador puede rectificar el error y reintentar la transaccin.

Puede especificar el contenido de la pgina de pago y configurar su apariencia para que refleje el aspecto y el estilo de su sitio web (incluido el logotipo).

Proteccin del vendedorSi PayPal es la nica forma de pago de su sitio web, las transacciones procesadas a travs de Pasarela integral cumplirn los requisitos para disfrutar de la proteccin del vendedor de PayPal. Cubre pagos realizados a travs del flujo de pago de su sitio web para artculos vendidos nacional e internacionalmente. Estos artculos se pueden comprar utilizando una tarjeta de crdito o a travs de la cuenta PayPal.Para beneficiarse de la proteccin del vendedor, el artculo comprado se debe enviar a la direccin que proporcion a PayPal.

Para ello, debe realizar las tareas siguientes: Enviar todos los detalles de la direccin de facturacin y de envo proporcionados por el

comprador en el Form POST. Defina la variable address_override como true y la variable

showShippingAddress como false (o anule su seleccin en la pgina Configuracin de su pgina de perfil).

IMPORTANTE: Se aplican condiciones. Para ver todas las condiciones, consulte las Pasarela integral Condiciones de uso e-Terminal de PayPal y de PayPal.

Revisin del pago instantnea

Para aprovechar la proteccin del vendedor, debe realizar la integracin con Revisin del pago instantnea. Revisin del pago es una funcin que identifica transacciones de alto riesgo y se las notifica a usted para que pueda retener los envos hasta que PayPal evale el riesgo. Se pone a disposicin para todos los vendedores, reduce las prdidas de los vendedores y hace que las transacciones cumplan los requisitos para disfrutar de la proteccin del vendedor.Cuando se inicia una transaccin, PayPal realiza una evaluacin adicional de riesgo de comprador. PayPal punta todas las transacciones (Authorization y Sale) instantneamente y marca las de alto riesgo como En revisin, cosa que se le notificar de inmediato. No debe enviar mercancas o, en caso de medios electrnicos, no debe permitir el acceso a su descarga mientras el pago est en revisin. Los agentes de proteccin contra el fraude de PayPal revisan la transaccin en un plazo de 24 horas y actualizan el pedido como Completado (liberado como seguro por Revisin del pago) o Cancelado (rechazado por Revisin del pago). En el caso de transacciones con riesgo, PayPal le recomienda que no enve los artculos hasta que se determine que la transaccin est Completada. Los pagos que se completan cumplen los requisitos para disfrutar de la proteccin del vendedor de PayPal.13

Introduccin a Pasarela integralProteccin del vendedor

14Puede determinar el estado del pago de las formas siguientes: Iniciando sesin en https://www.paypal.com y viendo la informacin de estado en el

historial de transacciones. Comprobando el correo electrnico enviado por PayPal Revisando el mensaje de notificacin de pago instantnea (IPN) Verificando el estado de una transaccin programticamente Para comprobar el estado

inicial de una transaccin, utilice cualquiera de las siguientes operaciones de API: DoExpressCheckoutPayment DoReferenceTransaction DoAuthorization DoReauthorization

Puede comprobar el estado subsiguiente de una transaccin programticamente llamando a la operacin de API GetTransactionDetails. Si desea obtener ms informacin, consulte API GetTransactionDetails en la pgina 73.

NOTA: Debe utilizar la versin 58.0 (o posterior) de la API para obtener la informacin de estado inicial proporcionada por DoExpressCheckoutPayment, DoReferenceTransaction, DoAuthorization o DoReauthorization.

Para utilizar la revisin del pago con las operaciones de pago de API DoExpressCheckoutPayment, DoReferenceTransaction, DoAuthorization y DoReauthorization, debe

1. Comprobar el estado del pago en la respuesta a la operacin de API; especficamente, comprobar si PaymentStatus se define como Pending.

2. Si PaymentStatus est definido como Pending, compruebe si PendingReason est definido como PaymentReview, ya que hay otros motivos por los que una transaccin puede pasar a estar pendiente. Por ejemplo, el PaymentStatus de una autorizacin no liquidada se define como Pending; sin embargo, su PendingReason se define como authorization, que no tiene que ver con la revisin del pago.

Si PaymentStatus se define como Pending y PendingReason se define como PaymentReview, no debe enviar las mercancas o, en el caso de medios electrnicos o, no debe permitir el acceso a su descarga. Como el estado del pago cambiar tras su revisin, debe comprobarlo peridicamente mediante la operacin GetTransactionDetails de la API, comprobando el correo electrnico de PayPal, revisando mensajes IPN o comprobando el historial de transacciones en https://www.paypal.com.

Introduccin a Pasarela integralProcesamiento de transacciones con Pago exprs de PayPalProcesamiento de transacciones con Pago exprs de PayPalPago exprs de PayPal es una solucin de pago de PayPal. Facilita a los compradores el pago y le permite a usted aceptar PayPal y mantener el control del comprador y del flujo global del proceso de pago. Permite a los compradores utilizar informacin de envo almacenada de forma segura en PayPal para realizar el proceso de pago, por lo que no tendrn que volver a introducirlo en su sitio web. El botn Pagar con PayPal se puede colocar en la pgina del producto y en la del carro de la compra, y es una gran herramienta para aumentar la tasa de conversin de pago.

Los pasos siguientes describen el funcionamiento de Pago exprs:

1. Tras seleccionar los productos que desea comprar en un sitio web, los compradores hacen clic en el botn Pagar con PayPal.

2. Se le redirige al sitio web de PayPal, donde inicia sesin con su identificacin y su contrasea de PayPal.

3. Tras iniciar sesin, revisa el resumen del pedido y hace clic en Continuar pago para autorizar la transaccin.

4. Se devuelve entonces al comprador a la pgina de confirmacin en su sitio web, donde podr verificar los detalles del pedido y enviar la transaccin.

Para ver informacin completa sobre Pago exprs de PayPal, consulte la Gua de integracin de Pago exprs.15

Introduccin a Pasarela integralIntroduccin a la integracin con Pasarela integral

16Introduccin a la integracin con Pasarela integralTras registrarse en Pasarela integral, siga estos pasos para integrar su sitio web con:

1. Conecte su sitio web con Pasarela integral: identifique un punto en el flujo de pago de su sitio web donde desee colocar un botn Pagar o similar en el que el comprador deber hacer clic para iniciar el pago. Puede hacerlo mediante HTML o API. Al hacer clic en este botn, se redirige el navegador del comprador a la pgina de pago de PayPal para el procesamiento de la transaccin. En funcin de cmo desee realizar la integracin, siga los pasos descritos en el Captulo 2, Integracin de su sitio web mediante HTML en la pgina 17 o Captulo 5, Integracin de su sitio web mediante API en la pgina 51.

2. Tambin puede personalizar el aspecto y el contenido de su pgina de pago alojada por PayPal enviando las variables HTML adecuadas o editando la configuracin de su cuenta PayPal. Consulte en el Captulo 3, Personalizacin de su pgina de pago de PayPal en la pgina 23.

3. Tambin puede probar la integracin en el entorno de pruebas de PayPal. Este paso se describe en el Captulo 6, Prueba de la integracin en el entorno de pruebas en la pgina 59.

2 Integracin de su sitio web 17mediante HTML

Este captulo ofrece instrucciones para una integracin sencilla que le permita comenzar a procesar transacciones con Pasarela integral.

NOTA: PayPal le recomienda implementar la integracin sencilla para familiarizarse con Pasarela integral antes de implementar una integracin ms personalizada.

Como parte de una integracin sencilla, tiene la configuracin predeterminada en su pgina de pago. Para personalizar el aspecto y el estilo de la pgina para que coincida con su sitio web, puede hacer una de estas cosas: Cambiar su configuracin en la seccin Perfil en PayPal.com, como se describe en

Modificacin de la configuracin de la cuenta PayPal en la pgina 24. Aadir las variables HTML adecuadas a la pgina de pago, como se describe se describe en

la Tabla 2.1, Variables HTML para la configuracin de la pgina de pago en la pgina 19 y la Tabla 3.2, Variables HTML para el aspecto y el estilo de su pgina de pago en la pgina 42.

IMPORTANTE: Las variables HTML anularn la configuracin que guarde en su pgina Perfil.

Integracin sencilla de Pasarela integralPara integrar su sitio web con Pasarela integral, identifique un punto en el flujo de pago de su sitio web donde desee colocar un botn en el que el comprador deber hacer clic para iniciar el pago. El botn debe etiquetarse como Continuar con el pago, Pagar o algo parecido y, al hacer clic en el botn, debera ejecutar un Form POST a PayPal. Al hacer clic en este botn, se redirige el navegador del comprador a la pgina de pago de PayPal, desde donde podr pagar con tarjeta de crdito o su cuenta PayPal. El Form POST contiene un conjunto de variables HTML que describen la transaccin. En el Form POST, debe especificar lo siguiente: subtotal: importe de la transaccin. business: Id. de vendedor seguro (que se encuentra en la pgina Perfil) o direccin de

correo electrnico asociada a su cuenta PayPal. paymentaction: indica si la transaccin es para un pago de una venta final o una

autorizacin para una venta final (que se capturar ms adelante).

Integracin de su sitio web mediante HTMLIntegracin sencilla de Pasarela integral

18La divisa predeterminada es USD. Adems, puede especificar las variables HTML incluidas en la Tabla 2.1, Variables HTML para la configuracin de la pgina de pago en la pgina 19 para personalizar la informacin obtenida en la pgina de pago o en la Tabla 3.2, Variables HTML para el aspecto y el estilo de su pgina de pago en la pgina 42 para personalizar el aspecto y el estilo de la pgina. Si el pago es correcto, el comprador ve la pgina de confirmacin de PayPal o es redirigido a la URL que usted especifique en su configuracin. Se anexa a la URL de retorno un Id. de transaccin en la cadena de consulta durante la redireccin desde la pgina de pago a su sitio web. Este Id. de transaccin se puede utilizar para recuperar el estado y verificar la autenticidad de la transaccin. Para ver informacin detallada sobre la verificacin de la autenticidad de la transaccin antes de cumplimentar el pedido, consulte el Captulo 7, Procesamiento de pedidos en la pgina 65.

Ejemplo de integracin

A continuacin se muestra un ejemplo de integracin sencilla de Pasarela integral:

1. Ejemplo de Form POST de Pasarela integral:

El texto en negrita es el valor de la variable correspondiente. Se recomienda que ponga los valores entre comillas. Para ver informacin detallada sobre estos valores, consulte Tabla 2.1, Variables HTML para la configuracin de la pgina de pago en la pgina 19.

2. Coloque el texto HTML en su sitio web en el punto en que los compradores procedern con el proceso de pago.

3. Abra la pgina de pago y pruebe el botn para asegurarse de que abre la pgina de pago de PayPal.

Tambin puede utilizar el entorno de pruebas de PayPal para probar la integracin. Para ver informacin completa sobre la prueba de su integracin en el entorno de pruebas de PayPal, consulte Captulo 6, Prueba de la integracin en el entorno de pruebas en la pgina 59.

Integracin de su sitio web mediante HTMLVariables HTML para la configuracin de la pgina de pagoVariables HTML para la configuracin de la pgina de pagoLa tabla siguiente muestra las variables HTML de Pasarela integral que puede utilizar para enviar informacin adicional de la transaccin junto con su solicitud web. Para ver una lista de variables HTML que puede utilizar para personalizar el aspecto de su pgina de pago, consulte Tabla 3.2, Variables HTML para el aspecto y el estilo de su pgina de pago en la pgina 42.

NOTA: Los valores que asigne no deben contener ninguno de estos caracteres especiales () {}\\";

NOTA: Algunos vendedores estn obligados a transferir la informacin de facturacin con cada transaccin. Se recomienda que pruebe su integracin primero, en particular si piensa usar iFrame, para saber si los campos de informacin de facturacin son obligatorios.

TABLA 2.1 Variables HTML para la configuracin de la pgina de pago

Variable Descripcin Obligatorio

address1 Nombre de la calle de la direccin de envo. (1 de 2 campos).

No

address2 Nombre de la calle de la direccin de envo. (2 de 2 campos).

No

address_override El pagador se muestra en la direccin transferida, pero no puede editarse. Esta variable se anula si hay errores en la direccin. Los valores admitidos son true/false. El valor predeterminado es false.

No

billing_address1 Nombre de la calle de la direccin de facturacin. (1 de 2 campos).

Condicional

billing_address2 Nombre de la calle de la direccin de facturacin. (2 de 2 campos).

No

billing_city Nombre de la ciudad de la direccin de facturacin. Condicionalbilling_country Cdigo de pas de la direccin de facturacin. Condicionalbilling_first_name Nombre de la persona a la que se va a facturar el artculo. Condicionalbilling_last_name Apellidos de la persona a la que se va a facturar el artculo. Condicionalbilling_state Estado o provincia de la direccin de facturacin. Condicionalbilling_zip Cdigo postal de la direccin de facturacin. Condicional

bn Identifica la fuente que cre el cdigo para el botn. Formato: ___

No19

Integracin de su sitio web mediante HTMLVariables HTML para la configuracin de la pgina de pago

20business Direccin de correo electrnico de su cuenta PayPal o su Id. de PayPal ID (Id. de vendedor seguro) asociada a su cuenta PayPal. Se recomienda que utilice su Id. de PayPal, que puede encontrar en la seccin superior de la pgina Perfil en PayPal.com.

S

buyer_email Direccin de correo electrnico del comprador. Nocancel_return El navegador se redirigir a esta URL si el comprador hace

clic en el vnculo "Volver al vendedor. Asegrese de introducir la URL completa, incluido http:// o https://.

No

cbt Define el texto para el vnculo Volver al vendedor en la pgina de confirmacin de PayPal. Para cuentas Business, el botn de retorno muestra el nombre de su empresa en lugar de la palabra vendedor de forma predeterminada.

No

city Nombre de la ciudad de la direccin de envo. Nocountry Nombre del pas de la direccin de envo. Nocurrency_code Divisa del pago. El valor predeterminado es USD. Nocustom Variable de transferencia que el pagador no ve. Nofirst_name Nombre de la persona a la que se va a enviar el artculo. Nohandling Gastos de manipulacin que se cobrarn. Este importe se

aade al subtotal del importe total.No

invoice Nmero de pedido en el sistema de pedidos/facturas del vendedor.

No

last_name Apellidos de la persona a la que se va a enviar el artculo. Nolc Idioma de visualizacin de la pgina de inicio de sesin o

creacin de cuenta. Los valores posibles son: ES, USNo

night_phone_a Prefijo del nmero de telfono de EE. UU., o del pas del nmero de telfono de fuera de EE. UU. Se rellena previamente en el nmero de telfono particular del comprador.

No

night_phone_b El prefijo de tres dgitos de los nmeros de telfono de EE. UU. o todo el nmero de telfono si es de fuera de EE. UU., sin incluir el cdigo de pas. Se rellena previamente en el nmero de telfono particular del comprador.

NOTA:Utilice esta variable para nmeros de fuera de EE. UU.

No

TABLA 2.1 Variables HTML para la configuracin de la pgina de pago (Continuacin)

Variable Descripcin Obligatorio

Integracin de su sitio web mediante HTMLVariables HTML para la configuracin de la pgina de pagonight_phone_c El nmero de telfono de cuatro dgitos de los nmeros de telfono de EE. UU. Se rellena previamente en el nmero de telfono particular del comprador.

No

notify_url URL a la que PayPal enva informacin sobre la transaccin, en forma de notificacin de pago instantnea. Asegrese de introducir la URL completa, incluido http:// o https://.

No

paymentaction Indica si la transaccin es para un pago de una venta final o una autorizacin para una venta final (que se capturar ms adelante). Valores permitidos: authorization o sale. Valor predeterminado: sale

S

return URL a la que se redirige el navegador del comprador tras completar el pago. Asegrese de introducir la URL completa, incluido http:// o https://.

No

shipping Envo cobrado. Este importe se aade al subtotal del importe total.

No

state Estado de la direccin de envo. Nosubtotal Importe cobrado por la transaccin. Si no se especifican

envo, manipulacin ni impuestos, ser el importe total cobrado.

S

tax Impuestos cobrados. Este importe se aade al subtotal del importe total.

No

zip Cdigo postal de la direccin de envo. No

TABLA 2.1 Variables HTML para la configuracin de la pgina de pago (Continuacin)

Variable Descripcin Obligatorio 21

Integracin de su sitio web mediante HTMLVariables HTML para la configuracin de la pgina de pago

22

3 Personalizacin de su pgina de 23pago de PayPal

Puede personalizar el aspecto y el estilo de la pgina de pago de PayPal mediante las dos maneras siguientes: Modificacin de la configuracin de la cuenta PayPal. Uso de Variables HTML para personalizar el aspecto de la pgina de pago.

NOTA: Las variables HTML anularn la configuracin de la cuenta que guarda en su pgina Perfil.

Este captulo tambin contiene informacin sobre Flujo de pago optimizado para mviles.

NOTA: La pgina de pago se mostrar a los clientes despus de completar la integracin en HTML.

Personalizacin de su pgina de pago de PayPalModificacin de la configuracin de la cuenta PayPal

24Modificacin de la configuracin de la cuenta PayPalPuede personalizar la configuracin y el aspecto de su pgina de pago de PayPal. Para modificar la pgina de pago, inicie sesin en su cuenta en PayPal.com. En la pgina Perfil, en la seccin Configuracin de pago en sitio web, seleccione: Configuracin: para establecer la configuracin de la pgina de pago. Personalizacin: para especificar el aspecto y el estilo de la pgina de pago.

Personalizacin de su pgina de pago de PayPalModificacin de la configuracin de la cuenta PayPalConfiguracin

FIGURA 3.1 Configuracin: pgina de descripcin general de la configuracin

En la pgina Descripcin general de Configuracin puede desplazarse a cada una de las pestaas siguientes para establecer la configuracin de su pgina de pago de PayPal: Informacin del cliente: especifique si desea mostrar la informacin de facturacin o de

envo del cliente en su pgina de pago y qu campos sern obligatorios o modificables. Pgina de confirmacin de pagos: elija la configuracin de su pgina de confirmacin de

pagos. Esta es la pgina que vern sus clientes tras realizar una transaccin correcta. Recibo por correo electrnico: seleccione esta opcin para enviar a sus clientes un recibo

por correo electrnico y personalizar dicho recibo. Direcciones URL y transferencia de datos: especifique las URL significativas de su sitio

web. PayPal redirigir a sus clientes desde la pgina de pago de PayPal a las URL que usted proporcione.

Configuracin general: personalice la etiqueta del botn de la pgina de pago.La pgina de descripcin general de Configuracin tambin incluye un vnculo al portal de programadores de PayPal y otro a la pgina Personalizacin, en la que puede modificar el aspecto de la pgina de pago.25


26Informacin del cliente

En la pestaa de configuracin Informacin del cliente, puede seleccionar si desea mostrar los campos Informacin de facturacin e Informacin de envo en la pgina de pago de PayPal. Cuando marque la casilla junto a Informacin de facturacin o Informacin de envo, aparecer en la pgina una lista de los campos aplicables. Todos los campos de la lista aparecern en su pgina de pago.

FIGURA 3.2 Configuracin: pgina Informacin del cliente

En esta lista de los campos de informacin del cliente puede seleccionar qu campos desea hacer modificables u obligatorios en su pgina de pago. Marque la casilla situada junto a cada campo obligatorio en la seccin Convertir estos campos en obligatorios y junto a los campos modificables en la seccin Convertir estos campos en modificables.

Personalizacin de su pgina de pago de PayPalModificacin de la configuracin de la cuenta PayPalPayPal recomienda que muestre el menor nmero posible de opciones en la pgina de pago. Asimismo, si decide recopilar en la pgina de pago informacin que ya haba obtenido en su sitio web, crear una mala experiencia para el comprador. Por ejemplo, puede que ya haya obtenido la direccin de envo en su sitio web para calcular los gastos de transporte. Por tanto, no es necesario que la vuelva a solicitar en la pgina de pago. En lugar de volver a solicitar la direccin de envo del comprador en la pgina de pago de PayPal, puede transferir a PayPal la informacin de direccin de envo que ya ha obtenido. A continuacin, PayPal mostrar los campos de direccin de envo automticamente rellenados y modificables en su pgina de pago. Para obtener ms informacin sobre la transferencia de valores a la pgina de pago de PayPal, vaya a Variables HTML para la configuracin de la pgina de pago en la pgina 19. En la pestaa Informacin del cliente de la pgina puede indicar si desea mostrar los siguientes campos de informacin de facturacin e informacin de envo del cliente en su pgina de pago. Tambin puede decidir cules de estos campos sern obligatorios y modificables.

NOTA: Algunos vendedores estn obligados a transferir la informacin de facturacin del cliente con cada transaccin. Se recomienda que pruebe su integracin primero, en particular si piensa usar la integracin de iFrame, para saber si los campos de informacin de facturacin son obligatorios.

Tambin puede anular la configuracin de la pestaa Informacin del cliente durante la transaccin transfiriendo variables HTML a la pgina de pago de PayPal. Para obtener ms informacin, consulte Variables HTML para personalizar el aspecto de la pgina de pago en la pgina 42.

Campos de informacin de facturacin Campos de informacin de envo

Nombre Nombre de la empresa Nombre Apellidos

Direccin Direccin 1 Direccin 2 Ciudad Estado/Provincia/Regin Cdigo postal Pas

Informacin de contacto Nmero de telfono Direccin de correo electrnico

Nombre Nombre de la empresa Nombre Apellidos

Direccin Direccin 1 Direccin 2 Ciudad Estado/Provincia/Regin Cdigo postal Pas

Informacin de contacto Nmero de telfono Direccin de correo electrnico27


28Pgina de confirmacin de pagos

En la pestaa Pgina de confirmacin de pagos, puede especificar qu pgina ver el comprador tras realizar un pago correcto. Puede elegir mostrar una pgina de confirmacin de PayPal o una pgina de confirmacin de pagos alojada en su sitio web:

FIGURA 3.3 Configuracin: Pgina de confirmacin de pagos

Personalizacin de su pgina de pago de PayPalModificacin de la configuracin de la cuenta PayPal En la pgina de confirmacin de mi sitio webSi selecciona esta opcin, significa que pide a PayPal que redirija al comprador a su propia pgina de confirmacin de pagos, alojada en su sitio web. Se le pedir que proporcione la URL de retorno. La URL de retorno es la primera pgina que el cliente ve en su sitio web tras abandonar las pginas de PayPal. Si decide alojar su propia pgina de confirmacin de pagos, introduzca la ruta de acceso a dicha pgina en el campo URL de retorno. Cuando PayPal redirija al comprador a una pgina de confirmacin de pagos alojada en su sitio web, deber incluir un mensaje en esta pgina sobre el resultado de la transaccin. Asegrese de mostrar los datos del pedido mediante el Id. de transaccin que se le devolver.

En una pgina de confirmacin de PayPalAl seleccionar esta opcin, indica que desea mostrar al comprador una pgina de confirmacin alojada en PayPal. Puede personalizar su pgina de confirmacin alojada en PayPal con la siguiente informacin: (Opcional) Texto de encabezado (Opcional) Texto de pie Nmero de telfono del servicio de atencin al cliente.

Para actualizar la informacin de contacto de su servicio de atencin al cliente, vuelva a la pgina Perfil.

Direccin de correo electrnico del servicio de atencin al cliente. Para actualizar la informacin de contacto de su servicio de atencin al cliente, vuelva a la pgina Perfil.

URL de retornoLa URL de retorno es la primera pgina que el cliente ve en su sitio web tras abandonar las pginas de PayPal. En el campo URL de retorno, introduzca la ruta a la pgina de su sitio web que desea que vean los compradores tras la pgina de confirmacin de pago de PayPal. El comprador vuelve a su sitio web haciendo clic en un vnculo de la pgina de confirmacin de PayPal. Puede personalizar el texto del vnculo.

Texto del botn o vnculo de retornoAqu puede especificar el texto del vnculo de la pgina de confirmacin de PayPal que devolver al usuario a su sitio web. Para cambiar la forma en que la informacin se enva desde PayPal a su servidor web, mediante HTTP POST o GET, vaya a la pestaa de configuracin de Direcciones URL y transferencia de datos.29


30Recibo por correo electrnico

En la pestaa de configuracin Recibo por correo electrnico, puede especificar si desea que PayPal enve un recibo por correo electrnico al comprador tras una transaccin correcta. Esta funcin est desactivada de forma predeterminada. Para activarla, marque la casilla junto a Permitir que PayPal enve recibos por correo electrnico. Puede personalizar la siguiente informacin en la pgina del recibo por correo electrnico: Direccin de correo electrnico del remitente Direccin de correo electrnico de respuesta (opcional) Mostrar el nombre o logotipo de la empresa?

Puede seleccionar una de las siguientes opciones: Mostrar el nombre de mi empresa como texto Mostrar el logotipo de mi empresa No mostrar

Texto de encabezado (opcional) Texto de pie (opcional)

Nmero de telfono del servicio de atencin al cliente Direccin de correo electrnico del servicio de atencin al clientePara actualizar la informacin de contacto de su servicio de atencin al cliente, vuelva a la pgina Perfil.

Personalizacin de su pgina de pago de PayPalModificacin de la configuracin de la cuenta PayPalFIGURA 3.4 Configuracin: Recibo por correo electrnico31


32Direcciones URL y transferencia de datosLa configuracin de Direcciones URL y transferencia de datos le ayuda a administrar la transferencia de datos entre PayPal y su sitio web (mediante GET o POST). Tambin puede configurar sus valores de URL de cancelacin y de error aqu. Para modificar la URL de retorno, vaya a la Pgina de confirmacin de pagos.

FIGURA 3.5 Configuracin: Direcciones URL y transferencia de datos

Puede configurar los siguientes valores en la pestaa Direcciones URL y transferencia de datos:

Forma de transferencia de datosSeleccione el mtodo HTTP que deseara que usara PayPal para devolver los datos de pago a su servidor web. Esta forma de transferencia de datos se aplica a las URL de retorno, cancelacin y error. Las opciones son: GET POST

Personalizacin de su pgina de pago de PayPalModificacin de la configuracin de la cuenta PayPalURL de cancelacinSi un cliente decide cancelar un pago, este vnculo lo dirigir a la pgina de su sitio web que especifique. URL de cancelacin

Introduzca la URL de la pgina de su sitio web a la que debe volver el comprador si decide cancelar el pago. Tambin puede configurar la URL de cancelacin dinmicamente en el momento de la transaccin transfiriendo una variable HTML a PayPal. Esta variable HTML anular la URL de cancelacin especificada en la configuracin de su cuenta. Para obtener ms informacin, vaya a Variables HTML para la configuracin de la pgina de pago en la pgina 19.

Texto de la URL de cancelacinAqu puede personalizar el texto del vnculo de cancelacin del pago que se muestra en su pgina de pago de PayPal.

URL de errorSe trata de la URL de la pgina de su sitio web a la que PayPal debe redirigir al comprador si se produce un error durante la transaccin de pago.

Configuracin general

La pgina Configuracin general le ayuda a personalizar ms la pgina de pago de PayPal.

Texto del botn de la pgina de pagoPuede personalizar el texto del botn Pagar ahora. 33


34FIGURA 3.6 Configuracin: Configuracin general

Personalizacin

La pgina Personalizacin le permite personalizar el diseo y el aspecto de su pgina de pago de PayPal. Aqu puede seleccionar uno de los diseos de pgina disponibles. En funcin del diseo que seleccione, puede personalizar el encabezado, el color de fondo, el texto del subttulo, el color del botn de pago, el color del texto del botn y la seccin de resumen del pedido de su pgina de pago. Las pginas de pago de PayPal se optimizan tanto para navegadores de escritorio como para navegadores mviles. Para obtener ms informacin sobre el comportamiento de la pgina de pago con navegadores mviles, consulte Flujo de pago optimizado para mviles en la pgina 40.En la parte superior de la pgina, ver las cuatro plantillas de diseo que le ofrece PayPal. La plantilla A es la predeterminada. Puede seleccionar cualquiera de estas plantillas. Si desea una integracin de iFrame, seleccione la plantilla MiniLayout. Una vez seleccionada la plantilla de diseo que prefiere, puede personalizar secciones especficas de esta. Para realizar cambios en una seccin, haga clic con el botn izquierdo del ratn en la seccin que desea modificar o en el botn Hacer clic para editar de dicha seccin. Aparecer una ventana emergente con la configuracin aplicable a esa seccin como, por ejemplo, un selector de colores para cambiar el color o un campo para la introduccin de texto.

Personalizacin de su pgina de pago de PayPalModificacin de la configuracin de la cuenta PayPalUna vez personalizada la plantilla de diseo, haga clic en uno de los siguientes botones: Vista previa: obtenga una vista previa de los cambios que ha realizado en la plantilla antes

de guardarla y publicarla. Guardar y publicar: guarde todos los cambios que haya realizado y publique la plantilla

actualizada. Los compradores vern la pgina de pago actualizada. Cancelar: descarte todos los cambios que ha realizado en esta sesin. Versin anterior: descarte todos los cambios que ha realizado desde la ltima vez que

guard la plantilla. Los compradores vern la ltima plantilla guardada.

NOTA: Debe realizar todas las modificaciones (incluidos los cambios en las plantillas) dentro de la misma sesin; de lo contrario, todos los cambios se perdern y tendr que rehacer los cambios. Si se agota el tiempo de espera de la sesin, el diseo de la plantilla seguir siendo el de la ltima versin guardada y publicada.

Eleccin de una plantilla

Elija entre estas cuatro plantillas de diseo:

Diseo A Diseo B Diseo C MiniLayout35


36Diseo A. El diseo A es el predeterminado. El diseo A consta de un encabezado en la parte superior de la pgina, una seccin de formas de pago a la izquierda y una seccin con el resumen del pedido a la derecha. Solo puede personalizar el encabezado en este diseo. Puede especificar la altura del encabezado, mostrar el nombre de su empresa en texto o cargar el logotipo de esta. Tambin puede alinear el encabezado horizontalmente.

NOTA: En el caso de las plantillas de diseo A, B y C, cuando la pgina de pago se ve desde un navegador mvil compatible, PayPal muestra automticamente un flujo de pago optimizado para mviles en lugar de la plantilla de diseo. Las pginas de pago optimizadas para mviles no se pueden personalizar y su aspecto ser el mismo para los diseos A, B y C.

FIGURA 3.7 Personalizacin: Diseo A

Personalizacin de su pgina de pago de PayPalModificacin de la configuracin de la cuenta PayPalDiseo B. El diseo B es el que tiene ms opciones de personalizacin. Al igual que el diseo A, consta de un encabezado en la parte superior de la pgina, una seccin de formas de pago a la izquierda y una seccin con el resumen del pedido a la derecha. En el diseo B, tambin puede personalizar el color de fondo del encabezado, el fondo de pgina o elegir una imagen de fondo de la pgina. En la seccin de formas de pago de la izquierda, puede elegir los colores del texto del subttulo, el borde de la seccin, el botn Pagar y el texto del botn Pagar. En la seccin de resumen del pedido a la derecha, puede personalizar el color de fondo o usar una imagen de fondo.


FIGURA 3.8 Personalizacin: Diseo B37


38Diseo C. En el diseo C, la seccin con el resumen del pedido aparece en la parte superior de la pgina, inmediatamente debajo del encabezado, seguida de la seccin de formas de pago. De un modo parecido al diseo B, el diseo C le permite personalizar el encabezado, el fondo de la pgina y los colores de la seccin de formas de pago. No obstante, no puede personalizar la seccin de resumen del pedido.


FIGURA 3.9 Personalizacin: Diseo C

Personalizacin de su pgina de pago de PayPalModificacin de la configuracin de la cuenta PayPalMiniLayout. A diferencia de los otros diseos, MiniLayout solo muestra la seccin de formas de pago. No hay seccin de encabezado ni de resumen del pedido. MiniLayout puede mostrarse en una ventana emergente independiente o dentro de su sitio web, en un iFrame. Para obtener ms informacin sobre la integracin de iFrame, consulte Integracin de iFrame en la pgina 46. MiniLayout tiene un tamao fijo de 490 x 565 pxeles, con espacio adicional para mostrar mensajes de error. En MiniLayout puede personalizar el color del texto del subttulo, el color del borde, el color del botn Pagar y el color del texto del botn Pagar.

NOTA: En el caso de MiniLayout, cuando la pgina de pago se visualiza desde un navegador mvil, PayPal no muestra el flujo optimizado para mviles. El motivo es que si PayPal mostrara automticamente una plantilla optimizada para mviles integrada dentro de la pgina web de un vendedor, que puede no estar optimizada para mviles, se podran generar resultados inesperados e indeseables. Para mostrar un flujo optimizado para mviles, pase el valor mobile o mobile-iframe en la variable HTML template en el momento de la transaccin.

FIGURA 3.10 Personalizacin: MiniLayout39

Personalizacin de su pgina de pago de PayPalFlujo de pago optimizado para mviles

40Opciones de personalizacin de la plantilla de diseo

Piense en lo siguiente al personalizar una plantilla: Encabezado (aplicable a los diseos A, B y C): de forma predeterminada, el encabezado

mostrar el nombre de empresa que aparece en su perfil. Puede cambiar los siguiente: Altura y color del encabezado Tipo, tamao y color de fuente Cambiar entre mostrar el nombre de empresa y la imagen del logotipo de la empresa Posicin del nombre o logotipo de la empresa En los diseos B y C tambin puede cambiar el color de fondo del encabezado.

Fondo de pgina (aplicable a los diseos B y C): puede cambiar lo siguiente: Color de fondo URL de imagen de fondo

Seccin de formas de pago (aplicable a los diseos B, C y MiniLayout): puede cambiar lo siguiente: Color del borde de la seccin Color del texto del subttulo Color del botn Pagar y color del texto del botn

Seccin de resumen del pedido (aplicable solo al diseo B): puede cambiar lo siguiente: Color de fondo de la seccin URL de imagen de fondo

Flujo de pago optimizado para mvilesLa pgina de pago de PayPal est optimizada para navegadores mviles. Al utilizar las plantillas de diseo A, B o C, cuando un comprador ve la pgina de pago desde un navegador mvil compatible, PayPal muestra automticamente un flujo de pago optimizado para mviles en lugar de la plantilla de diseo.

NOTA: Las pginas de pago optimizadas para mviles no se pueden personalizar y su aspecto ser el mismo para los diseos A, B y C.

En el caso de la plantilla D, tambin conocida como MiniLayout o integracin en iFrame, cuando la pgina de pago se visualiza desde un navegador mvil, PayPal no muestra el flujo optimizado para mviles. El motivo es que si PayPal mostrara automticamente una plantilla optimizada para mviles integrada dentro de la pgina web de un vendedor, que puede no estar optimizada para mviles, se podran generar resultados inesperados e indeseables. Para mostrar un flujo optimizado para mviles, pase el valor mobile o mobile-iframe en la variable HTML template en el momento de la transaccin. Para obtener ms informacin, consulte la informacin sobre la variable HTML template en Variables HTML para personalizar el aspecto de la pgina de pago en la pgina 42.

Personalizacin de su pgina de pago de PayPalFlujo de pago optimizado para mvilesLa Figura 3.11, Flujo de pago con mvil para un pago con PayPal y la Figura 3.12, Flujo de pago con mvil para un pago con tarjeta de crdito muestran ejemplos del flujo de pago optimizado para mviles.

FIGURA 3.11 Flujo de pago con mvil para un pago con PayPal

TABLA 3.1 Variable HTML template

Valor de la variable templateComportamiento en un navegador web

Comportamiento desde un dispositivo mvil

templateA Muestra el diseo web. Muestra el flujo optimizado para mviles.

templateB Muestra el diseo web. Muestra el flujo optimizado para mviles.

templateC Muestra el diseo web. Muestra el flujo optimizado para mviles.

templateD Muestra el diseo web con iFrame. Muestra el diseo web con iFrame.mobile Muestra el diseo web

predeterminado.Muestra el flujo optimizado para mviles.

mobile-iframe Muestra el diseo web predeterminado.

Muestra el diseo con iFrame para mviles.

Inicio de sesin de PayPalEntrada41

Personalizacin de su pgina de pago de PayPalVariables HTML para personalizar el aspecto de la pgina de pago

42FIGURA 3.12 Flujo de pago con mvil para un pago con tarjeta de crdito

Variables HTML para personalizar el aspecto de la pgina de pagoEn la tabla siguiente se enumeran las variables HTML que puede utilizar para personalizar el aspecto de su pgina de pago. Las variables HTML que transfiera en el momento de la transaccin anularn la configuracin de la pgina de pago en el perfil de su cuenta PayPal. Encontrar variables HTML adicionales en: Variables HTML para la configuracin de la pgina de pago.


TABLA 3.2 Variables HTML para el aspecto y el estilo de su pgina de pago

Variable Descripcin

bodyBgColor Color del fondo circundante de la pgina de pago.bodyBgImg Imagen del fondo circundante de la pgina de pago. Las extensiones de archivo

pueden ser .gif, .jpg, .jpeg o .png.

footerTextColor Color del texto del pie de pgina.headerBgColor Color de fondo del encabezado.

Tarjeta de crditoEntrada

Personalizacin de su pgina de pago de PayPalVariables HTML para personalizar el aspecto de la pgina de pagoheaderHeight Altura del banner del encabezado. Puede ser de 50 a 140 pxeles. La anchura no se puede modificar. Siempre es de 940 pxeles.

logoFont Tipo de letra del texto del logotipo.logoFontColor Color del texto del logotipo.logoFontSize Tamao del tipo de letra del texto del logotipo.logoImage Imagen que se muestra en el logotipo. Los formatos de extensin de archivo

aceptados son .gif, .jpg, .jpeg o .png. La anchura de la imagen no puede ser superior a 940 pxeles.

logoImagePosition Posicin de la imagen en el logotipo.logoText Nombre de empresa que se muestra en su pgina de perfil. Este campo es editable y

el texto que se especifique aqu se muestra en el encabezado si no se especifica logoImage.

orderSummaryBgColor Color de la columna Resumen del pedido de la derecha de la pgina de pago. No se puede cambiar el color del cuadro Resumen del pedido.

orderSummaryBgImage Imagen de fondo que puede colocar en la columna Resumen del pedido. Los formatos de extensin de archivo aceptados son .gif, .jpg, .jpeg o .png.

pageButtonBgColor Color de fondo del botn Pagar ahora. pageButtonTextColor Color del botn Pagar ahora. No se puede cambiar el texto del botn.pageTitleTextColor Color del texto utilizado en el ttulo de la pgina. (El texto dice Elegir forma de

pago.)

sectionBorder Fondo de la seccin que muestra Pagar con mi cuenta PayPal o Pagar con tarjeta.showCustomerName Muestra el nombre del cliente (nombre y apellidos).

Valor predeterminado: true Valor permitido: true o false, donde true = mostrar y false = ocultar.

showBillingAddress Muestra informacin de la direccin de facturacin. Valor predeterminado: true Valor permitido: true o false, donde true = mostrar y false = ocultar.

showBillingPhone Muestra el nmero de telfono de facturacin. Valor predeterminado: true Valor permitido: true o false, donde true = mostrar y false = ocultar.

showBillingEmail Muestra la direccin de correo electrnico para facturacin. Valor predeterminado: false Valor permitido: true o false, donde true = mostrar y false = ocultar.

showHostedThankyouPage Muestra la pgina de confirmacin de PayPal. Valor predeterminado: true Valor permitido: true o false, donde true = mostrar y false = ocultar.


Variable Descripcin43

Personalizacin de su pgina de pago de PayPalVariables HTML para personalizar el aspecto de la pgina de pago

44showShippingAddress Muestra la direccin de envo. Valor predeterminado: false Valor permitido: true o false, donde true = mostrar y false = ocultar.

subheaderText Color del texto Pagar con mi cuenta PayPal o Pagar con tarjeta de crdito.template Plantilla de diseo que se utilizar para su pgina de pago. Puede anular la plantilla

de diseo en la configuracin de perfil de su cuenta pasando uno de los valores siguientes en el momento de la transaccin:

NOTA: En el caso de las plantillas de diseo A, B y C, cuando un comprador ve la pgina de pago desde un navegador mvil compatible, PayPal muestra automticamente un procedimiento de pago optimizado para mviles en lugar de la plantilla de diseo. Las pginas de pago optimizadas para mviles no se pueden personalizar y su aspecto ser el mismo para los diseos A, B y C.

templateA: configura la plantilla de la pgina de pago con la plantilla de diseo A.

templateB: configura la plantilla de la pgina de pago con la plantilla de diseo B.

templateC: configura la plantilla de la pgina de pago con la plantilla del diseo C.

templateD: configura la plantilla de la pgina de pago con la plantilla MiniLayout (integracin con iFrame). Al visualizar la pgina de pago desde un navegador mvil, PayPal no muestra el flujo optimizado para mviles. El motivo es que si PayPal mostrara automticamente una plantilla optimizada para mviles integrada dentro de la pgina web de un vendedor, que puede no estar optimizada para mviles, se podran generar resultados inesperados e indeseables. Para mostrar el flujo de pago optimizado para mviles, pase el valor mobile o mobile-iframe en la variable HTML template en el momento de la transaccin.

NOTA: Si utiliza la plantilla A, B, o C, no es necesario realizar ninguna accin para mostrar las pginas de pago optimizadas para mviles. PayPal detecta automticamente si el comprador est en un navegador mvil y muestra automticamente un flujo optimizado para mviles. Sin embargo, en el caso de templateD, tambin conocida como MiniLayout o integracin con iFrame, para mostrar el flujo de pago optimizado para mviles se debe pasar el valor mobile o mobile-iframe en el momento de la transaccin.

mobile: muestra el flujo de pago optimizado para mviles. Pase este valor si utiliza templateD, conocida tambin como MiniLayout o integracin con iFrame, y desea mostrar el flujo optimizado para mviles sin iFrame.

mobile-iframe: muestra una pgina optimizada para mviles. Pase este valor si utiliza templateD, conocida tambin como MiniLayout o integracin con iFrame, y desea mostrar el flujo optimizado para mviles con iFrame.


Variable Descripcin

4 Integracin de iFrame en su sitio

Nmero CVV2 (si procede, segn el tipo de tarjeta) Otros campos necesarios para otros tipos de tarjeta, como para fecha de inicio o nmero de

emisi45

n para Maestro o Switch.web

PayPal ofrece un formulario compacto de pago que se puede integrar en un iFrame en su sitio web. Puesto que este formulario se integra en su sitio web, el comprador nunca sale de su sitio web, con lo que se reducen posibles abandonos. Tambin puede mantener el aspecto y el estilo en el marco maestro que rodea el formulario compacto de pago. Los campos de tarjeta de crdito forman parte del formulario compacto de pago para que no tenga que reunir esta informacin por separado.

IMPORTANTE: Debido a problemas de seguridad relacionados con iFrame, solo se admiten para un uso seguro los siguientes navegadores: Internet Explorer 7.0, 8.0 y 9.0, Firefox 24, Chrome 30 y Safari 4.x y 5.x. Las transacciones con usuarios de otros navegadores no deben usar el flujo de iFrame, o bien se debe abandonar la transaccin. Asimismo, hay otro riesgo ms all del flujo de iFrame: si el iFrame de PayPal se convierte en el origen de un ataque, dara la impresin de que el ataque procede del sitio del vendedor; no use el flujo de iFrame si desea evitar este riesgo adicional.

NOTA: Pensando en los sitios web fraudulentos, en el formulario no aparece la marca PayPal.

Si desea una integracin de iFrame, debe usar la plantilla MiniLayout. Puede seleccionar MiniLayout en la pgina Personalizacin de su cuenta PayPal. O bien puede transferir la variable HTML Template=TemplateD en el momento de la transaccin. Los ejemplos de este captulo usan ese mtodo de variable HTML para seleccionar la plantilla MiniLayout. En el caso de MiniLayout, cuando la pgina de pago se visualiza desde un navegador mvil, PayPal NO muestra automticamente el flujo de pago optimizado para mviles. El motivo es que si PayPal mostrara automticamente una plantilla optimizada para mviles integrada dentro de la pgina web de un vendedor, que puede no estar optimizada para mviles, se podran generar resultados inesperados e indeseables. Para mostrar un flujo optimizado para mviles, pase el valor mobile o mobile-iframe en la variable HTML template en el momento de la transaccin.

La plantilla MiniLayout (el formulario compacto de pago) contiene los siguientes campos: Nmero de tarjeta de crdito Fecha de vencimiento

Integracin de iFrame en su sitio webIntegracin de iFrame

46La plantilla tambin ofrece las siguientes opciones: Eliminar el botn Pagar con PayPal. Aunque el formulario ofrece la opcin de pagar con

la cuenta PayPal de forma predeterminada, puede ponerse en contacto con el administrador de su cuenta o con el Servicio de Atencin al Cliente para desactivar esta opcin.

Personalizar manualmente el color del botn Pagar ahora.

IMPORTANTE: Este formulario compacto de pago no muestra la direccin de facturacin del comprador aunque se transfiera showBillingAddress=true. No obstante, para algunos vendedores, puede ser necesario transferir la direccin de facturacin a fin de procesar correctamente las transacciones.

Integracin de iFrameElija uno de los siguientes mtodos para integrar el formulario compacto de pago en su sitio web: Integracin manual Integracin de API

IMPORTANTE: Para conseguir un rendimiento ptimo, PayPal le recomienda que cargue el activo de iFrame antes de otros activos, como imgenes y JavaScripts. Si se ejecutan demasiados activos en su pgina de pago mientras carga iFrame, puede que la solicitud de iFrame no se realice o se retrase. Esto puede provocar que los compradores vean un iFrame en blanco.

Integracin manual

Para integrar el formulario compacto de pago en su sitio web, siga estos pasos:

1. Introduzca la etiqueta de iFrame donde desee que aparezca el formulario compacto de pago en su sitio web. Por ejemplo:

El tamao permitido para el formulario compacto de pago es de 570 pxeles de ancho por 540 pxeles de alto.

Integracin de iFrame en su sitio webIntegracin de iFrame2. Bajo el cdigo del iFrame, aada el formulario oculto que se rellena con las variables correspondientes de Pasarela integral (lo que incluye el importe total que se pagar) y especifique la variable TemplateD. Por ejemplo,

NOTA: Si se produce un error en las transacciones de iFrame, transfiera la direccin de facturacin. Encontrar una tabla con las variables HTML en Variables HTML para la configuracin de la pgina de pago.

3. Asegrese de que el nombre de destino coincide con el del iFrame, como se resalta en el ejemplo siguiente:

4. Enve el formulario utilizando JavaScript. Por ejemplo:

document.form_iframe.submit();

47


48Ejemplo de integracin manual

El ejemplo completo segn los pasos indicados es el siguiente:


Integracin de API

Para integrar el formulario compacto de pago en su sitio web mediante la API, consulte Uso de la API de administrador de botones con el flujo de pago de Pasarela integral en la pgina 52.

NOTA: Utilice la plantilla templateD para este tipo de integracin.Existen dos opciones en la respuesta para iniciar el flujo de pago de Pasarela integral: Utilizar la URL devuelta en la respuesta Uso de Form POST

Utilizar la URL devuelta en la respuesta

En la URL identificada en la respuesta como EMAILLINK, aada src para iFrame como se muestra en el ejemplo siguiente para redirigir al comprador e iniciar el flujo de pago.


IMPORTANTE: Los navegadores Safari no admiten esta opcin. Use la opcin Form POST que se describe a continuacin.

Integracin de iFrame en su sitio webIntegracin de iFrameUso de Form POST

Identifique el cdigo WEBSITECODE en la respuesta utilcelo para crear un botn Pagar ahora en su pgina de revisin. Cuando el comprador hace clic en el botn, se le redirige a la pgina de pago alojada en PayPal. Como la URL, el botn es utilizable durante unas dos horas o hasta que el pago se complete correctamente

1. Introduzca la etiqueta de iFrame donde desee que aparezca el formulario compacto de pago en su sitio web. Por ejemplo:


2. Inserte lo siguiente en la etiqueta de iFrame:

WEBSITECODE=

3. Enve el formulario utilizando JavaScript. Por ejemplo:


49


50Ejemplo de integracin de API (Form POST)

El ejemplo completo segn los pasos indicados es el siguiente:

WEBSITECODE=


5 Integracin de su sitio web 51mediante API

Mediante la API de administrador de botones, puede crear de forma programtica el botn de pago que inicia el flujo de pago de Pasarela integralPasarela integralPasarela integral, puede crear los siguientes tipos de botones de pago mediante BUTTONTYPE=PAYMENT: Los botones de token (BUTTONCODE=TOKEN) no se almacenan en PayPal. Son

dinmicos e inician el flujo de pago de Pasarela integral. Los parmetros asociados a este tipo de botn son seguros. Tienen una vida til de unas dos horas si no se utilizan.

Los botones encriptados (BUTTONCODE=ENCRYPTED) no se almacenan en PayPal. Los parmetros asociados a este tipo de botn estn encriptados. Debe actualizar las pginas Web que utilizan un botn encriptado cada vez que el botn o la informacin asociada cambian.

Botones de texto sin encriptar (BUTTONCODE=CLEARTEXT) no se almacenan en PayPal. Los parmetros asociados a este tipo de botn no estn encriptados. Se pueden usar dinmicamente porque usted puede cambiar el valor de un parmetro en cualquier momento. Sin embargo, si los usa, se enfrenta al riesgo de que se pueda alterar o robar informacin confidencial.

NOTA: Los botones alojados (BUTTONCODE=HOSTED) no son compatibles con Pasarela integral y si se usan devolvern un mensaje de error.

Para obtener ms informacin sobre la API de administrador de botones, consulte Operacin de API BMCreateButton en la pgina 57.

Integracin de su sitio web mediante APIUso de la API de administrador de botones con el flujo de pago de Pasarela integral

52Uso de la API de administrador de botones con el flujo de pago de Pasarela integralPara crear un botn de pago en su sitio web, llame a la operacin BMCreateButton de la API. Cuando el comprador hace clic en el botn de pago, PayPal inicia el flujo de pago de Pasarela integral. Debe descodificar la respuesta de la API BMCreateButton. Para obtener informacin sobre la codificacin URL, consulte la Gua del programador de API de pares de nombre-valor. Existen dos opciones en la respuesta para iniciar el flujo de pago de Pasarela integral: Utilizar la URL devuelta en la respuesta (recomendada) Uso de Form POST

Utilizar la URL devuelta en la respuesta (recomendada)

Utilizando la URL identificada en la respuesta como EMAILLINK, es posible redirigir al comprador e iniciar el flujo de pago.

Ejemplo de TOKENEMAILLINK=https://securepayments.paypal.com/webapps/HostedSoleSolutionApp/webflow/sparta/hostedSoleSolutionProcess?hosted_button_id=HSSS-GDrPDzuW-ADwkFDMjQmpUK1gTDdR.tv5alaGS6l.XWVVB1MTMQEnGNoLakufQb89zTjf6&HOSTEDBUTTONID=HSSS-GDrPDzuW-ADwkFDMjQmpUK1gTDdR.tv5alaGS6l.XWVVB1MTMQEnGNoLakufQb89zTjf6&TIMESTAMP=2010-09-15T00:30:35Z&CORRELATIONID=2fc9a340a2356&ACK=Success&VERSION=65.0&BUILD=1500269

Integracin de su sitio web mediante APIUso de la API de administrador de botones con el flujo de pago de Pasarela integralEjemplo de ENCRYPTEDEMAILLINK=https://securepayments.paypal.com/webapps/HostedSoleSolutionApp/webflow/sparta/hostedSoleSolutionProcess?cmd=_hosted-payment&business=idc%2dautomation%2duk%2dpro%2dt1%40paypal%2ecom&tax=2&shipping=3&business=K5HHZSMWMCN58&subtotal=11&handling=4&TIMESTAMP=2010-09-15T00:39:06Z&CORRELATIONID=23d12ce1161f2&ACK=Success&VERSION=65.0&BUILD=1500269

Ejemplo de CLEARTEXTEMAILLINK=https://securepayments.paypal.com/webapps/HostedSoleSolutionApp/webflow/sparta/hostedSoleSolutionProcess?cmd=_hosted-payment&business=idc%2dautomation%2duk%2dpro%2dt1%40paypal%2ecom&tax=2&shipping=3&business=K5HHZSMWMCN58&subtotal=11&handling=4&TIMESTAMP=2010-09-15T00:40:32Z&CORRELATIONID=64553e7c7c84&ACK=Success&VERSION=65.0&BUILD=1500269

Las variables de botones controlan la presentacin en el flujo y la informacin que se proporciona inicialmente al comprador. Como la URL est asociada a un token de Pasarela integral, la URL se puede utilizar durante unas dos horas desde su creacin o hasta que el pago se complete correctamente.

Uso de Form POST

Identifique el cdigo WEBSITECODE en la respuesta y utilcelo para crear un botn Pagar ahora en la pgina de revisin. Cuando el comprador hace clic en el botn, se le redirige a la pgina de pago alojada en PayPal. Al igual que sucede con la URL, el botn se puede utilizar durante unas dos horas o hasta que el pago se complete correctamente.53


54Ejemplo para TOKENWEBSITECODE=

Ejemplo para ENCRYPTEDWEBSITECODE=

Ejemplo de CLEARTEXTWEBSITECODE=

Integracin de su sitio web mediante APIUso de la API de administrador de botones con el flujo de pago de Pasarela integralNOTA: La pgina de pago de PayPal muestra un botn identificado como Pagar ahora para completar el flujo de pago. El botn Pagar ahora en la pgina de PayPal es diferente del botn Pagar ahora creado por la operacin de la API BMCreateButton en la pgina de revisin. Puede que tenga que cambiar la URL para este ltimo en BUTTONIMAGEURL para evitar la confusin. Si no se especifica una URL en BUTTONIMAGEURL, se utiliza el botn Pagar ahora predeterminado.

Encriptacin de botones utilizando claves pblicas yprivadas

Pago estndar encriptado ayuda a asegurar botones de pago generados o escritos manualmente. Pago estndar encriptado protege el cdigo HTML de botn que contiene informacin de precios encriptndola. El cdigo HTML de botn que usted protege utilizando Pago estndar encriptado no lo pueden alterar terceros con malas intenciones para crear pagos fraudulentos. Si desea obtener ms informacin, consulte Captulo 8, Proteccin de botones utilizando Pago estndar encriptado en la pgina 67.

Ejemplo de inicio del proceso de pago en Pasarela integral

El ejemplo muestra los parmetros NVP utilizando BUTTONCODE=TOKEN a fin de crear una URL para iniciar el flujo de pago de Pasarela integral....BUTTONCODE=TOKENBUTTONTYPE=PAYMENTBUTTONIMAGEURL=https://www.paypal.com/en_US/i/btn/btn_billing.gifL_BUTTONVAR0=subtotal=11L_BUTTONVAR1=tax=2L_BUTTONVAR2=shipping=3L_BUTTONVAR3=handling=4L_BUTTONVAR4=first_name=BobL_BUTTONVAR5=last_name=JonesL_BUTTONVAR6=address1=GardensL_BUTTONVAR7=address2=99343L_BUTTONVAR8=city=ParisL_BUTTONVAR9=state=AlsaceL_BUTTONVAR10=zip=75002L_BUTTONVAR11=country=FRL_BUTTONVAR12=billing_first_name=BobBillingL_BUTTONVAR13=billing_last_name=JonesBillingL_BUTTONVAR14=billing_address1=5088 - 061 Craven Hill GardensL_BUTTONVAR15=billing_address2=Apt# 199343L_BUTTONVAR16=billing_city=WolverhamptonL_BUTTONVAR17=billing_state=West MidlandsL_BUTTONVAR18=billing_zip=W12 4LQL_BUTTONVAR19=billing_country=GBL_BUTTONVAR20=night_phone_a=408L_BUTTONVAR21=night_phone_b=39855


56L_BUTTONVAR22=night_phone_c=3065L_BUTTONVAR23=notify_url=www.yourcompany.comL_BUTTONVAR24=custom=custom1L_BUTTONVAR25=cancel_return=http://www.cancel_return.comL_BUTTONVAR26=paymentaction=saleL_BUTTONVAR27=currency_code=GBPL_BUTTONVAR28=invoice=123456789L_BUTTONVAR29=lc=GBL_BUTTONVAR30=showBillingAddress=falseL_BUTTONVAR31=showShippingAddress=falseL_BUTTONVAR32=showBillingEmail=trueL_BUTTONVAR33=showBillingPhone=trueL_BUTTONVAR34=showCustomerName=trueL_BUTTONVAR35=showCardInfo=trueL_BUTTONVAR36=showHostedThankyouPage=trueL_BUTTONVAR37=bn=GBDL_BUTTONVAR38=cbt=Merchant ABCDL_BUTTONVAR39=address_override=falseL_BUTTONVAR40=cpp_header_image=RedL_BUTTONVAR41=logoText=YourCompanyLogoL_BUTTONVAR42=logoImage=http://yourcompanyimages.com/logo.gifL_BUTTONVAR43=logoImagePosition=centerL_BUTTONVAR44=logoFont=Arial BoldL_BUTTONVAR45=logoFontSize=24pxL_BUTTONVAR46=logoFontColor=#f0ff0fL_BUTTONVAR47=bodyBgImg=sdfL_BUTTONVAR48=bodyBgColor=#AEAEAEL_BUTTONVAR49=headerHeight=70pxL_BUTTONVAR50=headerBgColor=#4B6BA1L_BUTTONVAR51=PageTitleTextColor=BlueL_BUTTONVAR52=PageCollapseBgColor=BlueL_BUTTONVAR53=PageCollapseTextColor=YellowL_BUTTONVAR54=PageButtonBgColor=BlueL_BUTTONVAR55=PageButtonBgColor=BlueL_BUTTONVAR56=orderSummaryBgColor=#EDF2F7L_BUTTONVAR57=orderSummaryBgImage=http://teamworks/scr_bg_ordersummary.jpgL_BUTTONVAR58=footerTextColor=#333333L_BUTTONVAR59=footerTextlinkColor=#00f00fL_BUTTONVAR60=template=templateCL_BUTTONVAR61=return=http://www.yourcompany.com

Integracin de su sitio web mediante APIOperacin de API BMCreateButtonOperacin de API BMCreateButton Utilice la operacin BMCreateButton de la API para crear el botn de pago de Pasarela integral. Solicitud de BMCreateButton Respuesta de BMCreateButton Errores de BMCreateButton

Solicitud de BMCreateButton

Los campos de solicitud especifican las caractersticas del botn, que incluye los elementos de men asociados al botn. Puede especificar hasta 5 elementos de men, cada uno de los cuales pueden incluir hasta 10 posibles selecciones.

Campos de solicitud de BMCreateButton


Campo Descripcin

METHOD (Obligatorio) BMCreateButton

BUTTONCODE (Opcional) El tipo de cdigo de botn que se va a crear. Es uno de los siguientes valores: TOKEN: un botn seguro, no almacenado en PayPal y utilizado nicamente

para iniciar el flujo de pago de Pasarela integral; opcin predeterminada del botn Pagar ahora. Desde la versin 65.2

ENCRYPTED: un botn encriptado, no almacenado en PayPal. CLEARTEXT: un botn no encriptado, no almacenado en PayPal.

BUTTONTYPE (Obligatorio) El tipo de botn de desea crear.PAYMENT: botn Pagar ahora; desde la versin 65.2

L_BUTTONVARn (Opcional) Variables de botn HTML estndar57

Integracin de su sitio web mediante APIOperacin de API BMCreateButton

58Respuesta de BMCreateButton

La respuesta contiene un Id. si el botn est alojado en PayPal y el cdigo para HTML en un sitio web y para un vnculo del correo electrnico.

Campos de respuesta de BMCreateButton

Errores de BMCreateButton

Consulte la pgina de cdigos de error de las API de PayPal para buscar el nmero de un cdigo de error o un mensaje de error.

Campo Descripcin

WEBSITECODE Cdigo HTML para pginas webEMAILLINK Cdigo para la URL del flujo de pago de Pasarela integralHOSTEDBUTTONID Id. de un token de Pasarela integral

6 Prueba de la integracin en el

Haga clic en el vnculo No verificado en la pgina principal de Descripcin general de mi cuenta.

Hagade en59

clic en Aadir cuenta bancaria en la pgina Obtener verificacin y Eliminar lmites vo. entorno de pruebas

El entorno de pruebas de PayPal es un entorno interno dentro del que puede realizar prototipos y probar funciones de PayPal. Este entorno es una copia casi exacta del sitio web real de PayPal. Su finalidad es ofrecer a los programadores un entorno protegido para probar e integrar, y para evitar los problemas que podran surgir si se probasen soluciones de integracin de PayPal en el sitio activo. Antes de poner en produccin ninguna aplicacin basada en PayPal, debera probarla en el entorno de pruebas para asegurarse de que funciona como pretende y conforme a las directrices y los estndares establecidos en el acuerdo de Programadores de PayPal.Para ver informacin completa sobre cmo utilizar el entorno de pruebas, consulte la Gua del usuario del entorno de pruebas.

Credenciales de la cuenta del entorno de pruebas Cree una cuenta Business en el entorno de pruebas de PayPal para el pas que desee probar: Inicie sesin en el sitio web para programadores de PayPal: https://developer.paypal.com/.

Puede iniciar sesin con las credenciales de su cuenta PayPal existente o crear una cuenta nueva.

Vaya a Applications (Aplicaciones)\> Sandbox accounts (Cuentas del entorno de pruebas) y haga clic en el botn Create Account (Crear cuenta).

Seleccione el pas para el que desee probar su integracin con el men desplegable Country (Pas).

Configure Bank Verified Account (Cuenta verificada por el banco) como Yes (S). Rellene el resto del formulario y haga clic Create Account (Crear cuenta).

NOTA: Puede utilizar cualquier nombre para su cuenta, y no es necesario marcar la casilla Login in with PayPal (Inicio de sesin con PayPal).

Verifique su cuenta Business del entorno de pruebas de PayPal: Inicie sesin en el entorno de pruebas de PayPal (https://www.sandbox.paypal.com) con la

direccin de correo electrnico y contrasea de la cuenta Business del entorno de pruebas de PayPal que acaba de crear.

Prueba de la integracin en el entorno de pruebasCredenciales de la cuenta del entorno de pruebas

60 Rellene todos los campos con informacin ficticia.

NOTA: Cdigo de clasificacin y Nmero de cuenta deben ser nmeros nicos. Haga clic en Continuar y, a continuacin, en Aadir cuenta bancaria para aadir la cuenta

bancaria de prueba. Vaya a la pgina Configurar pago con cuenta bancaria y haga clic en Continuar. Haga clic en Enviar para finalizar el proceso de verificacin. Cambiar a una cuenta ProHaga clic en la flecha junto a la direccin de correo electrnico de su cuenta Business del entorno de pruebas y, a continuacin, haga clic en el vnculo Profile (Perfil) que aparece debajo de la direccin de correo electrnico (resaltado a continuacin).

Prueba de la integracin en el entorno de pruebasCredenciales de la cuenta del entorno de pruebasDe este modo, se abre la ventana Sandbox account details (Detalles de la cuenta del entorno de pruebas). Desde la pestaa Profile (Perfil) de esta ventana, seleccione Upgrade to Pro (Cambiar a Pro). A continuacin, haga clic en el botn Enable (Activar).

Configuracin de cuentas personales en el entorno de pruebas :Desde la pgina Applications (Aplicaciones) \> Sandbox accounts (Cuentas del entorno de pruebas) del sitio para programadores, puede crear varias cuentas Business (de vendedor) y personales (de comprador) para usarlas en las transacciones de prueba que realice en el entorno de pruebas. Consulte la Gua del usuario del entorno de pruebas para obtener ms informacin.

Ya puede probar su integracin de Pasarela integral en el entorno de pruebas.61

Prueba de la integracin en el entorno de pruebasPrueba de la integracin y la configuracin

62Prueba de la integracin y la configuracinLas secciones siguientes contienen informacin para probar su integracin y modificar el aspecto y el estilo de su pgina de pago en el entorno de pruebas. Prueba de la integracin Prueba de la configuracin

Prueba de la integracin

Para probar su integracin en el entorno de pruebas, siga los pasos que se especifican en Integracin sencilla de Pasarela integral en la pgina 17. Para hacer pruebas, debe realizar estos cambios en el Form POST:

1. Cambiar la URL para que dirija al entorno de pruebas.

De:

a:

2. Cambiar el valor business al valor del Id. de vendedor seguro especificado en la parte superior de la pgina Perfil del sitio de pruebas del entorno de pruebas.

De acuerdo con esto, el Form POST para las pruebas ser:

Prueba de la integracin en el entorno de pruebasPrueba de la integracin y la configuracinPrueba de la configuracin

Para cambiar el aspecto de su pgina de pago, modifique la configuracin de las pginas Personalizacin y Configuracin en la seccin Perfil del sitio del entorno de pruebas. Para ver los detalles completos, consulte Modificacin de la configuracin de la cuenta PayPal en la pgina 24.63

Prueba de la integracin en el entorno de pruebasPrueba de la integracin y la configuracin

64

7 Procesamiento de pedidos

completado correctamente en PayPal antes de enviar los artculos al comprador. Puede hacerlo comprobando la confirmacin por correo electrnico que le envi PayPal o verificando el historial de transacciones. Tambin puede seguir uno de estos mtodos:65Este captulo le gua en toda la experiencia del procesamiento de pedidos. Incluye informacin sobre la verificacin del estado y la autenticidad del pedido antes de cumplimentarlo.

Verificacin de la autenticidad y el estado de la transaccinCuando el comprador completa correctamente una transaccin, se le redirige bien a la pgina de confirmacin de PayPal o a un sitio web que ha especificado en la variable return o en la pgina Configuracin de la seccin Perfil (como se describe en Integracin sencilla de Pasarela integral en la pgina 17). Cuando el navegador se redirige al sitio web especificado, se le anexa un Id. de transaccin.

NOTA: Para asegurarse de que el Id. de transaccin se aada a la URL de retorno, inicie sesin en su cuenta de vendedor de PayPal y seleccione Perfil. En la seccin Pagos estndar en sitio web y Pago exprs de la pgina Perfil, seleccione Preferencias y verifique la opcin Retorno automtico est establecida en Activar.

En la misma pgina de configuracin, compruebe tambin que la opcin Transferencia de datos de pago est configurada como Activar.

Al recibir la redireccin (URL con Id. de transaccin), debe verificar que el pedido se ha

Procesamiento de pedidosCumplimentacin del pedido

66Validar notificacin de pago instantnea (IPN)

IPN le permite recibir mensajes sobre pagos y actividad de transacciones de PayPal mediante una comunicacin asncrona de servidor a servidor. Esto le permite integrar sus pagos por Internet con su proceso de cumplimentacin de pedidos. A travs de IPN, recibe mensajes para lo siguiente: Pagos y su estado (pendiente, completo o rechazado) Acciones del filtro de administracin de fraudes Actividad de pagos peridicos Autorizaciones, devoluciones de cargo, disputas, cancelaciones y reembolsos.Una vez procesada una transaccin, PayPal enva una IPN a la URL de notificacin especificada en su transaccin mediante el parmetro notify_url, o en su Perfil de

pasarelaintegral es

Documents