Está en la página 1de 103

Gua de Integracin de Pasarela integral

ltima actualizacin: Octubre de 2010

Gua de Integracin de Pasarela integral Nmero de documento: 10117.en_US-201008

2011 PayPal, Inc. Todos los derechos reservados. PayPal es una marca comercial registrada de PayPal, Inc. El logotipo de PayPal es una marca comercial de PayPal, Inc. Las dems marcas comerciales que aparecen en este documento pertenecen a sus respectivos propietarios. La informacin de este documento pertenece a PayPal, Inc. No se puede utilizar, reproducir o revelar sin el permiso por escrito de PayPal, Inc. Copyright PayPal, Inc. Todos los derechos reservados. PayPal (Europe) S. r.l. & Cie, S.C.A. - Socit en Commandite par Actions, Domicilio social: 22-24 Boulevard Royal, L-2449, Luxembourg, RCS Luxembourg B 118 349. Nota para el consumidor: el servicio de PayPal se considera un instrumento de prepago segn las leyes de Singapur. No requiere la aprobacin de las autoridades monetarias de Singapur. Lea detenidamente las condiciones de uso. Nota de exencin de responsabilidad: PayPal, Inc. le proporciona a usted esta informacin TAL CUAL, con todos sus fallos. PayPal, Inc. no garantiza en modo alguno (ya sea de forma expresa, implcita o legal) la informacin contenida en este documento. PayPal, Inc. no asume responsabilidad alguna por daos (ni directos ni indirectos), 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 del producto o del servicio descritos en este documento. PayPal, Inc. se reserva el derecho de realizar cambios a cualquier informacin contenida en este documento sin previo aviso.

Contenidos

Prlogo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Acerca de esta gua . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 A quin va dirigida esta gua? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Historial de revisiones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Sugerencias sobre la documentacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Captulo 1

Comenzar a utilizar Pasarela integral . . . . . . . . . . . . 9

Descripcin general . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Funciones y ventajas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Cmo funciona Pasarela integral . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Proteccin del vendedor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Revisin del pago instantnea. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Procesamiento de transacciones con Pago exprs de PayPal . . . . . . . . . . . . . . . 13 Introduccin a la integracin con Pasarela integral . . . . . . . . . . . . . . . . . . . . . 15

Captulo 2

Integracin de su sitio Web mediante HTML . . . . . . . . 17


Ejemplo de integracin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Integracin sencilla de Pasarela integral. . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Variables HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Captulo 3

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


Configuracin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Personalizacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Modificacin de la configuracin de la cuenta PayPal . . . . . . . . . . . . . . . . . . . . 23

Adicin de variables HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Captulo 4

Integracin de iFrames en su sitio Web . . . . . . . . . . . 35


Integracin manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 Integracin de API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Integracin de iFrames. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Octubre de 2010

Contenidos

Captulo 5

Integracin de su sitio Web mediante API

. . . . . . . . . 41

Alojamiento de botones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Uso de la API Button Manager con el pago de Pasarela integral . . . . . . . . . . . . . . 42 Utilizar la URL devuelta en la respuesta (recomendada) . . . . . . . . . . . . . . . . 42 Uso de Form POST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Encriptacin de botones utilizando claves pblicas y privadas . . . . . . . . . . . . . 45 Operacin de API BMCreateButton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Solicitud de BMCreateButton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Respuesta de BMCreateButton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Errores de BMCreateButton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Captulo 6

Proteccin de botones utilizando Pago estndar encriptado . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Encriptacin de clave pblica utilizada por Pago estndar encriptado . . . . . . . . . . . 52 Configuracin de certificados antes de utilizar Pago estndar encriptado. . . . . . . . . . 52 Generacin de su clave privada utilizando OpenSSL . . . . . . . . . . . . . . . . . . 53 Generacin de su certificado pblico utilizando OpenSSL . . . . . . . . . . . . . . . 53 Carga de su certificado pblico en su cuenta PayPal . . . . . . . . . . . . . . . . . . 53 Descarga del certificado pblico de PayPal del sitio Web de PayPal . . . . . . . . . . 55 Eliminacin del certificado pblico . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 Uso de Pago estndar encriptado para proteger los botones de pago . . . . . . . . . 56 Bloqueo de pagos estndar desprotegidos y no encriptados . . . . . . . . . . . . . . 57

Captulo 7

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


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

Creacin de una cuenta preconfigurada . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Captulo 8

Procesamiento de pedidos . . . . . . . . . . . . . . . . . 65
Validar notificacin de pago instantnea (IPN) . . . . . . . . . . . . . . . . . . . . . 65 Ejecutar una llamada de API GetTransactionDetails . . . . . . . . . . . . . . . . . . 66

Verificacin de la autenticidad y el estado de la transaccin . . . . . . . . . . . . . . . . 65

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

Apndice A Operaciones de API opcionales . . . . . . . . . . . . . . . 67


API GetTransactionDetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Solicitud de GetTransactionDetails . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Respuesta de GetTransactionDetails . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Octubre de 2010

Contenidos

API RefundTransaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Solicitud de RefundTransaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Respuesta de RefundTransaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 API DoCapture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 Solicitud de DoCapture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 Respuesta de DoCapture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Captulo B

Cambiarse de Website Payments Standard a Pasarela integral . . . . . . . . . . . . . . . . . . . . . . . . . . . 85


Ejemplo de comparacin de cdigo . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Apndice C Mensajes de error . . . . . . . . . . . . . . . . . . . . . . 89 Apndice D Cdigos de divisa . . . . . . . . . . . . . . . . . . . . . . 99

Octubre de 2010

Contenidos

Octubre de 2010

Prlogo

Acerca de esta gua


La Gua de Integracin de Pasarela integral describe cmo realizar la integracin con Pasarela integral. Incluye informacin sobre: Funciones y ventajas de Pasarela integral. Seller Protection. Cambiarse de Pago estndar a Pasarela integral. Integracin de su sitio Web con Pasarela integral. Personalizacin de su pgina de pago de PayPal. 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 es para vendedores que quieran realizar la integracin con Pasarela integral para aadir el procesamiento de la transaccin a su sitio Web.

Historial de revisiones
La tabla siguiente muestra el historial de revisiones realizado a Gua de Integracin de Pasarela integral
TABLA P.1 Historial de revisiones para esta gua Fecha de publicacin October2010 Descripcin Se cre Gua de Integracin de Pasarela integral

Gua de Integracin de Pasarela integral

Prlogo
Sugerencias sobre la documentacin

Sugerencias sobre la documentacin


Aydenos a mejorar esta gua enviando sus comentarios a: documentationfeedback@paypal.com

Gua de Integracin de Pasarela integral

Comenzar a utilizar Pasarela integral

Descripcin general
Pasarela integral 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 o almacenar informacin de tarjeta 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 ventajas
Funciones 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.
N O T A : La

implementacin de Pasarela integral ayuda a conseguir el cumplimiento de las normas de la PCI, aunque no lo garantiza necesariamente.

Pagos por telfono: Formulario de pago por Internet alojado por PayPal, lo que le permitir aceptar pedidos por telfono, por fax, por correo y en persona para las principales tarjetas de crdito. 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 obtener ms informacin, consulte Proteccin del vendedor en la pgina 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 13. Admite iFramesPayPal 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

Gua de Integracin de Pasarela integral

Comenzar a utilizar Pasarela integral


Cmo funciona Pasarela integral

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 Captulo 3, Personalizacin de su pgina de pago de PayPal.

Admite las principales tarjetas de crdito: Admite Visa, MasterCard, Tarjeta Aurora (procesada por Cetelem).

Cmo funciona 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 HTML o API (disponible en una versin futura). 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. 3. 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.

10

Gua de Integracin de Pasarela integral

Comenzar a utilizar Pasarela integral


Cmo funciona Pasarela integral

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

Gua de Integracin de Pasarela integral

11

Comenzar a utilizar Pasarela integral


Proteccin del vendedor

Proteccin del vendedor


Si PayPal es la nica forma de pago de su sitio Web, las transacciones procesadas a travs de Pasarela integral sern aptas para 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). Se aplican condiciones. Para ver todas las condiciones, consulte Condiciones de uso de Pasarela integral y Pagos por telfono de PayPal.

IMPO RTANTE:

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 sean aptas para 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 gEn revisinh, 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 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 Rechazado (rechazado por Revisin del pago). Para transacciones con riesgo, PayPal le recomienda que no enve los artculos hasta que se determine que la transaccin esta Completada. Los pagos se completan como aptos para la proteccin del vendedor de PayPal. Puede 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)

12

Gua de Integracin de Pasarela integral

Comenzar a utilizar Pasarela integral


Procesamiento de transacciones con Pago exprs de PayPal

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 67.
N O T A : 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 comprobar peridicamente el estado del pago utilizando la operacin de API GetTransactionDetails, comprobando el correo electrnico de PayPal, revisando mensajes IPN o comprobando el historial de transacciones en https://www.paypal.com.

Procesamiento de transacciones con Pago exprs de PayPal


Pago 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

Gua de Integracin de Pasarela integral

13

Comenzar a utilizar Pasarela integral


Procesamiento de transacciones con Pago exprs de PayPal

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 cmo funciona Pago exprs de PayPal 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.

14

Gua de Integracin de Pasarela integral

Comenzar a utilizar Pasarela integral


Introduccin a la integracin con Pasarela integral

Introduccin a la integracin con Pasarela integral


Tras 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 parecido 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 Captulo 2, Integracin de su sitio Web mediante HTML o Captulo 5, Integracin de su sitio Web mediante API. 2. Tambin puede personalizar la apariencia y el contenido de su pgina de pago alojada por PayPal enviando las variables HTTP adecuadas o editando la configuracin de su cuenta PayPal. Consulte Captulo 3, Personalizacin de su pgina de pago de PayPal. 3. Tambin puede probar la integracin en el entorno de pruebas PayPal Sandbox. Este paso se describe en Captulo 7, Prueba de la integracin en el entorno de pruebas.

Gua de Integracin de Pasarela integral

15

Comenzar a utilizar Pasarela integral


Introduccin a la integracin con Pasarela integral

16

Gua de Integracin de Pasarela integral

2
NOTA:

Integracin de su sitio Web mediante HTML


Este captulo ofrece instrucciones para una integracin sencilla que le permita comenzar a procesar transacciones utilizando Pasarela integral. 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 23. Aadir las variables HTML adecuadas a la pgina de pago, como se describe en Tabla 2.1, Variables HTML para la configuracin de la pgina de pago y Tabla 3.1, Variables HTML para el aspecto y el estilo de su pgina de pago. Las variables HTML anularn la configuracin que guarde en su pgina Perfil.

IMPO RTANTE:

Integracin sencilla de Pasarela integral


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

La divisa predeterminada es USD. Adems, puede especificar las variables HTML incluidas en Tabla 2.1, Variables HTML para la configuracin de la pgina de pago para personalizar la informacin obtenida en la pgina de pago o Tabla 3.1, Variables HTML para el aspecto y el estilo de su pgina de pago 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.

Gua de Integracin de Pasarela integral

17

Integracin de su sitio Web mediante HTML


Integracin sencilla de Pasarela integral

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 Captulo 8, Procesamiento de pedidos.

Ejemplo de integracin
A continuacin se muestra un ejemplo de integracin sencilla de Pasarela integral: 1. Ejemplo de Form POST de Pasarela integral:
<form action=https://securepayments.paypal.com/acquiringweb?cmd=_hostedpayment method="post"> <input type="hidden" name="cmd" value="_hosted-payment"> <input type name="subtotal" value="50"> <input type name="business" value="HNZ3QZMCPBAAA"> <input type name="return" value="https://yourwebsite.com/receipt_page.html"> <input type="submit" name="METHOD" value="Pay"> </form>

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. 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 PayPal Sandbox para probar la integracin. Para ver informacin completa sobre la prueba de su integracin en el entorno de pruebas PayPal Sandbox, consulte Captulo 7, Prueba de la integracin en el entorno de pruebas.

18

Gua de Integracin de Pasarela integral

Integracin de su sitio Web mediante HTML


Variables HTML

Variables HTML
La tabla siguiente muestra las variables HTML de Pasarela integral HTML que puede utilizar para enviar informacin adicional de la transaccin junto con su solicitud de Web. Para ver una lista de variables HTML que puede utilizar para personalizar el aspecto y el estilo de su pgina de pago, consulte Tabla 3.1, Variables HTML para el aspecto y el estilo de su pgina de pago.
TABLA 2.1 Variables HTML para la configuracin de la pgina de pago Variable
address1

Descripcin Nombre de la calle de la direccin de envo. (1 de 2 campos) Nombre de la calle de la direccin de envo. (2 de 2 campos) 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. Nombre de la calle de la direccin de facturacin. (1 de 2 campos) Nombre de la calle de la direccin de facturacin. (2 de 2 campos) Nombre de la ciudad de la direccin de facturacin. Cdigo de pas de la direccin de facturacin. Nombre de la persona a la que se va a facturar el artculo. Apellidos de la persona a la que se va a facturar el artculo. Estado o provincia de la direccin de facturacin. Cdigo postal de la direccin de facturacin. Identifica la fuente que cre el cdigo para el botn. Formato - <Empresa>_<Servicio>_<Producto>_<Pas> 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. Direccin de correo electrnico del comprador.

Obligatorio No No No

address2

address_override

billing_address1

No No No No No No No No No

billing_address2

billing_city billing_country billing_first_name billing_last_name billing_state billing_zip bn

business

buyer_email

No

Gua de Integracin de Pasarela integral

19

Integracin de su sitio Web mediante HTML


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

Descripcin El navegador se redirigir a esta URL si el comprador hace clic en el vnculo "Volver al vendedorh. Asegrese de introducir la URL completa, incluido http:// o https://. Define el texto para el vnculo gVolver al vendedorh 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 gvendedorh de forma predeterminada.
N O T A : Se debe definir la variable shopping_url.

Obligatorio No

cbt

No

city country currency_code custom first_name handling

Nombre de la ciudad de la direccin de envo. Nombre del pas de la direccin de envo. Divisa del pago. El valor predeterminado es USD. Variable de transferencia que el pagador no ve. Nombre de la persona a la que se va a enviar el artculo. Gastos de manipulacin que se cobrarn. Este importe se aade al subtotal del importe total. Nmero de pedido en el sistema de pedidos/facturas del vendedor. Descripcin del artculo. Si se omite, el comprador introduce un nombre de artculo en el momento del pago si paga con PayPal. Se recomienda que especifique esta variable para optimizar la experiencia si el comprador opta por pagar con PayPal. Apellidos de la persona a la que se va a enviar el artculo. Idioma de la pgina de identificacin o registro. 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. 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.
N O T A : Utilice esta variable para nmeros de fuera de

No No No No No No No No

invoice

item_name

last_name lc night_phone_a

No No No

night_phone_b

No

EE.UU.

20

Gua de Integracin de Pasarela integral

Integracin de su sitio Web mediante HTML


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

Descripcin 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. 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://. 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. URL a la que se redirige el navegador del comprador tras completar el pago. Asegrese de introducir la URL completa, incluido http:// o https://. Envo cobrado. Este importe se aade al subtotal del importe total. Estado de la direccin de envo. Importe cobrado por la transaccin. Si no se especifican envo, manipulacin ni impuestos, ser el importe total cobrado. Impuestos cobrados. Este importe se aade al subtotal del importe total. Cdigo postal de la direccin de envo.

Obligatorio No

notify_url

No

paymentaction

No

return

No

shipping

No No S

state subtotal

tax

No No

zip

Gua de Integracin de Pasarela integral

21

Integracin de su sitio Web mediante HTML


Variables HTML

22

Gua de Integracin de Pasarela integral

Personalizacin de su pgina de pago de PayPal


Puede personalizar el aspecto y el estilo de la pgina de pago de PayPal de las dos maneras siguientes: Modificacin de la configuracin de la cuenta PayPal Adicin de variables HTML variables HTML anularn la configuracin que guarde en su pgina Perfil.

N O T A : Las

Modificacin de la configuracin de la cuenta PayPal


En la seccin Perfil de PayPal.com, puede cambiar el aspecto y el estilo de la pgina de pago modificando la configuracin en las pginas siguientes en la seccin Configuracin de pago estndar.

Configuracin Personalizacin

Gua de Integracin de Pasarela integral

23

Personalizacin de su pgina de pago de PayPal


Modificacin de la configuracin de la cuenta PayPal

24

Gua de Integracin de Pasarela integral

Personalizacin de su pgina de pago de PayPal


Modificacin de la configuracin de la cuenta PayPal

Configuracin

Esta pgina le permite seleccionar la informacin que desea recopilar y mostrar en su pgina de pago, as como dnde desde mostrar la confirmacin del pago. Aunque ofrecemos varias opciones en esta pgina, le recomendamos que muestra las menos posible en la pgina de pago. Por ejemplo, puede que ya haya obtenido la direccin de envo en su propia pgina Web para calcular los gastos de envo y que la haya transferido a la pgina de pago de PayPal. Por tanto, no es necesario mostrar esta opcin de nuevo en la pgina de pago. Podra tener informacin ya recopilada en su sitio Web, pero que desea transferir a PayPal para volver a mostrarla en la pgina de pago alojada. Esta informacin se rellenar previamente y ser editable en esta pgina.

Gua de Integracin de Pasarela integral

25

Personalizacin de su pgina de pago de PayPal


Modificacin de la configuracin de la cuenta PayPal

Qu informacin desea mostrar en la pgina de pago de Pasarela integral? Puede seleccionar los campos que se mostrarn en su pgina de pago alojada. Tiene las opciones siguientes:

Informacin de tarjeta: Informacin de la tarjeta de crdito del comprador. Este campo se muestra siempre y se selecciona de forma predeterminada. Nombre del cliente: Nombre y apellidos del comprador. Direccin de facturacin: Direccin de facturacin del comprador. Nmero de telfono de facturacin: Nmero de telfono de facturacin del comprador. Direccin de correo electrnico de facturacinDireccin de correo electrnico de facturacin del comprador. Direccin de envo: Direccin de envo del comprador. Es obligatorio para la proteccin del vendedor. Asegrese de definir la variable HTML de la direccin de envo del comprador si no marca esta casilla.

Cmo desea mostrar la confirmacin de pago? Una vez realizada correctamente la transaccin, puede optar por mostrar la confirmacin de pago bien en la pgina de confirmacin de PayPal o en la de su empresa.

En una pgina de PayPal que muestra que el pago se ha completado: La confirmacin de pago aparece en la pgina de confirmacin de PayPal. Tambin puede proporcionar una URL en la pgina de confirmacin para redirigir al comprador de nuevo a su sitio Web. Para ello, introduzca la URL adecuada en el campo que se facilita. En la pgina de confirmacin de la empresa: La confirmacin de pago aparecer en su propia pgina de confirmacin de pago. Para ello, introduzca la URL de la pgina que mostrar la confirmacin de pago. Deber comunicar el resultado de la transaccin al comprador cuando PayPal le redirija de nuevo a su URL. No olvide mostrar los detalles especficos del pedido para que lo que vea el comprador tenga sentido. Puede obtener los detalles especficos del pedido utilizando el Id. de transaccin que le transferiremos con la URL de retorno.

26

Gua de Integracin de Pasarela integral

Personalizacin de su pgina de pago de PayPal


Modificacin de la configuracin de la cuenta PayPal

Personalizacin

Esta pgina le permite personalizar su pgina de pago. Puede personalizar el encabezado, el fondo, el ttulo, la parte inferior y la columna de resumen del pedido de su pgina de pago. PayPal ofrece tres plantillas de diseo entre las que elegir. La plantilla A es la predeterminada, pero puede elegir cualquier de las tres plantillas que se ofrecen.

Gua de Integracin de Pasarela integral

27

Personalizacin de su pgina de pago de PayPal


Modificacin de la configuracin de la cuenta PayPal
NOTA:

Sus compradores no vern la pgina de pago hasta que usted haya completado la integracin HTML con su sitio Web.

Obtenga una vista previa del diseo de su pgina de pago. Puede cambiar el diseo de la plantilla o seleccionar y personalizar otra plantilla en esta pgina. Pare realizar cambios, haga doble clic en la seccin que est intentando modificar o el botn Hacer clic para editar para esa seccin. En el men emergente que aparece, haga clic en el selector de color para cambiar el color o introduzca la URL adecuada, segn sea necesario. Si el comprador paga iniciando sesin en PayPal, el aspecto y el estilo de ese flujo se puede personalizar a travs de las opciones de personalizacin de Pago Pro en la pgina Perfil. Tras realizar los cambios, haga clic en uno de los botones siguientes:

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. 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 la sesin caduca, el diseo de la plantilla seguir siendo el de la ltima versin publicada.

NOTA:

28

Gua de Integracin de Pasarela integral

Personalizacin de su pgina de pago de PayPal


Modificacin de la configuracin de la cuenta PayPal

Eleccin de una plantilla

Elija entre las tres siguientes plantillas de diseo:


Plantilla A Plantilla B Plantilla C

Plantilla A. Seleccionada de forma predeterminada: puede personalizar el encabezado.


FIGURA 3.1 FIGURA 3.2

Gua de Integracin de Pasarela integral

29

Personalizacin de su pgina de pago de PayPal


Modificacin de la configuracin de la cuenta PayPal

Plantilla B. Personalice el encabezado, el fondo, el ttulo, el botn y la columna de resumen del pedido.
FIGURA 3.3 FIGURA 3.4

30

Gua de Integracin de Pasarela integral

Personalizacin de su pgina de pago de PayPal


Modificacin de la configuracin de la cuenta PayPal

Plantilla C. Personalice el encabezado, el fondo, el ttulo y el botn.


FIGURA 3.5 FIGURA 3.6

Gua de Integracin de Pasarela integral

31

Personalizacin de su pgina de pago de PayPal


Modificacin de la configuracin de la cuenta PayPal

Personalizacin de la plantilla

Piense en lo siguiente al personalizar una plantilla:

Encabezado (aplicable a las plantillas A, B y C): de forma predeterminada, en el encabezado se mostrar el nombre de empresa de 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 Recomendamos que aloje las imgenes en un servidor seguro (https://) para evitar la ventana con el cuadro de dilogo de seguridad que puede interferir en la conversin.

NOTA:

Fondo (aplicable a las plantillas B y C): puede cambiar lo siguiente: - Color de fondo - URL de imagen de fondo

Ttulo y botn (aplicable a las plantillas B y C): puede cambiar lo siguiente: - Color de encabezado - Color de barra de ttulo y color de texto de ttulo - Color de botn y color de texto de botn

Columna de resumen del pedido (aplicable a la plantilla C): puede cambiar lo siguiente: - Color de columna - URL de imagen

32

Gua de Integracin de Pasarela integral

Personalizacin de su pgina de pago de PayPal


Adicin de variables HTML

Adicin de variables HTML


La tabla siguiente muestra las variables HTML de Pasarela integral que puede utilizar para personalizar el aspecto y el estilo de su pgina de pago.
TABLA 3.1 Variables HTML para el aspecto y el estilo de su pgina de pago Variable
bodyBgColor bodyBgImg

Descripcin Color del fondo circundante de la pgina de pago. Imagen del fondo circundante de la pgina de pago. Las extensiones de archivo pueden ser .gif, .jpg, .jpeg o .png. Imagen en la parte superior izquierda de la pgina de pago. El tamao mximo de la imagen es de 750 pxeles de ancho por 90 de alto. PayPal recomienda que proporcione una imagen que slo est almacenada en un servidor seguro (https). Los formatos de extensin de archivo aceptados son .gif, .jpg, .jpeg o .png. Color del texto del pie de pgina. Color de fondo del encabezado. Altura del banner del encabezado. Puede ser de 50 a 140 pxeles. L anchura no se puede modificar. Siempre es de 940 pxeles. Tipo de letra del texto del logotipo. Color del texto del logotipo. Tamao del tipo de letra del texto del logotipo. 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. Posicin de la imagen en el logotipo. 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. El 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. 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. Color de fondo del botn Pagar ahora. Color del botn Pagar ahora. No se puede cambiar el texto del botn.

cpp_header_image

footerTextColor headerBgColor headerHeight

logoFont logoFontColor logoFontSize logoImage

logoImagePosition logoText

orderSummaryBgColor

orderSummaryBgImage

pageButtonBgColor pageButtonTextColor

Gua de Integracin de Pasarela integral

33

Personalizacin de su pgina de pago de PayPal


Adicin de variables HTML TABLA 3.1 Variables HTML para el aspecto y el estilo de su pgina de pago Variable
pageTitleTextColor

Descripcin Color del texto utilizado en el ttulo de la pgina. (El texto dice gElegir forma de pagoh.) Fondo de la seccin que muestra gPagar con mi cuenta PayPalh o gPagar con tarjetah. Muestra el nombre del cliente (nombre y apellidos). Valor predeterminado: true Valor permitido: true o false, donde true = mostrar y false = ocultar. Muestra informacin de la direccin de facturacin. Valor predeterminado: true Valor permitido: true o false, donde true = mostrar y false = ocultar. Muestra el nmero de telfono de facturacin. Valor predeterminado: true Valor permitido: true o false, donde true = mostrar y false = ocultar. Muestra la direccin de correo electrnico para facturacin. Valor predeterminado: false Valor permitido: true o false, donde true = mostrar y false = ocultar. Muestra la pgina de confirmacin de PayPal. Valor predeterminado: true Valor permitido: true o false, donde true = mostrar y false = ocultar. Muestra direccin de envo. Valor predeterminado: false Valor permitido: true o false, donde true = mostrar y false = ocultar. Color del texto gPagar con mi cuenta PayPalh o gPagar con tarjeta de crditoh. Plantilla utilizada para su pgina de pago. Las opciones son TemplateA, TemplateB y TemplateC. TemplateD se utiliza para la integracin de iFrames nicamente y no es una opcin de la pgina de personalizacin en PayPal.com.

sectionBorder

showCustomerName

showBillingAddress

showBillingPhone

showBillingEmail

showHostedThankyouPage

showShippingAddress

subheaderText

template

34

Gua de Integracin de Pasarela integral

Integracin de iFrames en su sitio 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.
IMPO RTANTE:

Por problemas de seguridad relacionados con los iFrames, los navegadores compatibles y seguros son los siguientes: Internet Explorer 7.0 y 8.0, Firefox 3.5.x y 3.6.x, Chrome 4 y 5, Safari 4.x y 5.x. Las transacciones con usuarios de otros navegadores deben utilizar el flujo de iFrames o abandonar la transaccin. Adems, existe un riesgo aadido ms all del flujo de iFrames: si el iFrame de PayPal se convierte en origen de un ataque, parecera que el ataque proviene del sitio Web del vendedor; utilice el flujo de iFrames si desea evitar este riesgo aadido.

N O T A : Pensando

en los sitios Web fraudulentos, el formulario no contiene marcas de PayPal.

El formulario compacto de pago contiene los campos siguientes:


Nmero de tarjeta de crdito Fecha de vencimiento 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 emisin para Maestro o Switch. 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.

El formulario ofrece asimismo las opciones siguientes:

Gua de Integracin de Pasarela integral

Integracin de iFrames en su sitio Web


Integracin de iFrames

Integracin de iFrames
Elija uno de los siguientes mtodos de integracin para integrar el formulario compacto de pago en su sitio Web:

Integracin manual Integracin de API

Integracin manual
Para integrar el formulario compacto de pago en su sitio Web, siga estos pasos: 1. Introduzca la etiqueta de iFrames donde desee que aparezca el formulario compacto de pago en su sitio Web: Por ejemplo:
<iframe name="hss_iframe" width="570px" height="540px"></iframe>

El tamao permitido para el formulario compacto de pago es de 570 pxeles de ancho por 540 pxeles de alto. 2. Bajo el cdigo de los iFrames, aada el formulario oculto que se rellena con las variables de Pasarela integral adecuadas (lo que incluye el importe total que se pagar) y especifique la variable TemplateD. Por ejemplo,
<form style="display:none" target="hss_iframe" name="form_iframe" method="post" action="https://securepayments.paypal.com/acquiringweb?cmd=_hostedpayment"> <input type="hidden" name="cmd" value="_hosted-payment" /> <input type name="subtotal" value="50"> <input type="hidden" name="business" value="HNZ3QZMCPBAAA" /> <input type="hidden" name="template" value="templateD" /> <input type name="return" value="https://yourwebsite.com/receipt_page.html"> </form>

3. Asegrese de que el nombre de destino coincide con el de los iFrames, como se resalta en el ejemplo siguiente:
<iframe name="hss_iframe" width="570px" height="540px"></iframe> <form style="display:none" target="hss_iframe" name="form_iframe" method="post" action="https://securepayments.paypal.com/acquiringweb?cmd=_hostedpayment">

36

Gua de Integracin de Pasarela integral

Integracin de iFrames en su sitio Web


Integracin de iFrames

4. Enve el formulario utilizando JavaScript. Por ejemplo:


<script type="text/javascript"> document.form_iframe.submit(); </script> Ejemplo de integracin manual

El ejemplo completo segn los pasos indicados es el siguiente:


<iframe name="hss_iframe" width="570px" height="540px"></iframe> <form style="display:none" target="hss_iframe" name="form_iframe" method="post" action="https://securepayments.paypal.com/acquiringweb?cmd=_hostedpayment"> <input type="hidden" name="cmd" value="_hosted-payment" /> <input type name="subtotal" value="50"> <input type="hidden" name="business" value="HNZ3QZMCPBAAA" /> <input type="hidden" name="template" value="templateD" /> <input type name="return" value="https://yourwebsite.com/receipt_page.html"> </form> <script type="text/javascript"> document.form_iframe.submit(); </script>

Integracin de API
Para integrar el formulario compacto de pago en su sitio Web utilizando la API, consulte Uso de la API Button Manager con el pago de Pasarela integral en la pgina 42 y llame a la API BMCreateButton para crear un botn de pago en su sitio Web.
N O T A : 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 gsrch para iFrames como en el ejemplo siguiente para redirigir al comprador e iniciar el flujo de pago.
<iframe src="https://www.paypal.com/...?hosted_button_id=HSS-.." width="570px" height="540px"></iframe>

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

Gua de Integracin de Pasarela integral

37

Integracin de iFrames en su sitio Web


Integracin de iFrames

Uso 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 iFrames donde desee que aparezca el formulario compacto de pago en su sitio Web: Por ejemplo:
<iframe name="hss_iframe" width="570px" height="540px"></iframe>

El tamao permitido para el formulario compacto de pago es de 570 pxeles de ancho por 540 pxeles de alto. 2. Inserte lo siguiente en la etiqueta de iFrames:
WEBSITECODE=<form action="https://www.paypal.com/cgi-bin/webscr" method="post"> <input type="hidden" name="cmd" value="_s-xclick"> <input type="hidden" name="hosted_button_id" value="HSSbXkpgPTNgZi7CyfIwWTAkWPSDbKziokU"> <input type="image" src="https://www.paypal.com/i/btn/btn_paynow_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online."> <img alt="" border="0" src="https://www.paypal.com/i/scr/pixel.gif" width="1" height="1"> </form>

3. Enve el formulario utilizando JavaScript. Por ejemplo:


<script type="text/javascript"> document.form_iframe.submit(); </script>

38

Gua de Integracin de Pasarela integral

Integracin de iFrames en su sitio Web


Integracin de iFrames

Ejemplo de integracin de API (Form POST)

El ejemplo completo segn los pasos indicados es el siguiente:


<iframe name="hss_iframe" width="570px" height="540px"></iframe> WEBSITECODE=<form action="https://www.paypal.com/cgi-bin/webscr" method="post"> <input type="hidden" name="cmd" value="_s-xclick"> <input type="hidden" name="hosted_button_id" value="HSSbXkpgPTNgZi7CyfIwWTAkWPSDbKziokU"> <input type="image" src="https://www.paypal.com/i/btn/btn_paynow_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online."> <img alt="" border="0" src="https://www.paypal.com/i/scr/pixel.gif" width="1" height="1"> </form> <script type="text/javascript"> document.form_iframe.submit(); </script>

Gua de Integracin de Pasarela integral

39

Integracin de iFrames en su sitio Web


Integracin de iFrames

40

Gua de Integracin de Pasarela integral

Integracin de su sitio Web mediante 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 integral en su sitio Web. Puede crear el botn de pago dinmicamente cuando el comprador intenta realizar el proceso de pago desde su sitio Web. Cuando el comprador hace clic en el botn de pago, usted llama a la operacin de API BMCreateButton para crear un botn de pago y mostrarlo en su pgina Web. Cuando el comprador hace clic en este botn de pago, se le redirige a la pgina de pago de PayPal, donde puede completar el pago. Las variables HTML controlan la presentacin de las pginas de pago de PayPal, la informacin contenida en las pginas y las pginas a las que se puede redirigir el comprador al salir de las pginas de pago. Para ver una lista de variables HTML, consulte Variables HTML en la pgina 19. Para ver informacin completa sobre la API de administrador de botones, consulte API de administrador de botones (NVP) o API de administrador de botones (SOAP).
N O T A : Mediante

la API de administrador de botones, puede crear de forma programtica el botn de pago, pero no puede administrarlo, editarlo o eliminarlo.

Alojamiento de botones
Para Pasarela integral, mediante BUTTONTYPE=PAYMENT, puede crear los tipos siguientes de botones de pago:

Los botones de cdigo personal (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 2 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. botones alojados (BUTTONCODE=HOSTED) no son compatibles con Pasarela integral y si se usan devolvern un mensaje de error.

N O T A : Los

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

Gua de Integracin de Pasarela integral

41

Integracin de su sitio Web mediante API


Uso de la API Button Manager con el pago de Pasarela integral

Uso de la API Button Manager con el pago de Pasarela integral


Para crear un botn de pago en su sitio Web, llame a la operacin de API BMCreateButton. 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, puede redirigir al comprador e iniciar el flujo de pago. Ejemplo para TOKEN:
EMAILLINK=https://www.paypal.com/cgi-bin/webscr?cmd=_sxclick&hosted_button_id=HSS2MTCOLOp9LoPGdFYsYclhbGyjJVNrMHO&HOSTEDBUTTONID=HSS2MTCOLOp9LoPGdFYsYclhbGyjJVNrMHO&TIMESTAMP=2010-0915T00:30:35Z&CORRELATIONID=2fc9a340a2356&ACK=Success&VERSION=65.0&BUILD=150 0269

42

Gua de Integracin de Pasarela integral

Integracin de su sitio Web mediante API


Uso de la API Button Manager con el pago de Pasarela integral

Ejemplo para ENCRYPTED:


EMAILLINK=https://www.paypal.com/acquiringweb?cmd=_hostedpayment&business=idc%2dautomation%2duk%2dpro%2dt1%40paypal%2ecom&tax=2&ship ping=3&business=K5HHZSMWMCN58&subtotal=11&handling=4&TIMESTAMP=2010-0915T00:39:06Z&CORRELATIONID=23d12ce1161f2&ACK=Success&VERSION=65.0&BUILD=150 0269

Ejemplo para CLEARTEXT:


EMAILLINK=https://www.paypal.com/acquiringweb?cmd=_hostedpayment&business=idc%2dautomation%2duk%2dpro%2dt1%40paypal%2ecom&tax=2&ship ping=3&business=K5HHZSMWMCN58&subtotal=11&handling=4&TIMESTAMP=2010-0915T00:40:32Z&CORRELATIONID=64553e7c7c84&ACK=Success&VERSION=65.0&BUILD=1500 269

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 cdigo personal de Pasarela integral, la URL es utilizable 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 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

Gua de Integracin de Pasarela integral

43

Integracin de su sitio Web mediante API


Uso de la API Button Manager con el pago de Pasarela integral

Ejemplo para TOKEN:


WEBSITECODE=<form action="https://www.paypal.com/cgi-bin/webscr" method="post"> <input type="hidden" name="cmd" value="_s-xclick"> <input type="hidden" name="hosted_button_id" value="HSS2MTCOLOp9LoPGdFYsYclhbGyjJVNrMHO"> <input type="image" src="https://www.paypal.com/en_US/i/btn/btn_auto_billing_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online."> <img alt="" border="0" src="https://www.paypal.com/en_GB/i/scr/pixel.gif" width="1" height="1"> </form>

Ejemplo para ENCRYPTED:


WEBSITECODE=<form action="https://www.paypal.com/cgi-bin/webscr" method="post"> <input type="hidden" name="cmd" value="_s-xclick"> <input type="hidden" name="encrypted" value="BEGIN PKCS7......END PKCS7"> <input type="image" src="https://www.paypal.com/en_US/i/btn/btn_auto_billing_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online."> <img alt="" border="0" src="https://www.paypal.com/en_GB/i/scr/pixel.gif" width="1" height="1"> </form>

Ejemplo para CLEARTEXT:


WEBSITECODE=<form action="https://www.paypal.com/acquiringweb" method="post"> <input type="hidden" name="cmd" value="_hosted-payment"> <input type="hidden" name="business" value="idc-automation-uk-prot1@paypal.com"> <input type="hidden" name="tax" value="2"> <input type="hidden" name="shipping" value="3"> <input type="hidden" name="business" value="K5HHZSMWMCN58"> <input type="hidden" name="subtotal" value="11"> <input type="hidden" name="handling" value="4"> <input type="image" src="https://www.paypal.com/en_US/i/btn/btn_auto_billing_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online."> <img alt="" border="0" src="https://www.paypal.com/en_GB/i/scr/pixel.gif" width="1" height="1"> </form>
N O T A : 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.

44

Gua de Integracin de Pasarela integral

Integracin de su sitio Web mediante API


Uso de la API Button Manager con el pago de Pasarela integral

Encriptacin de botones utilizando claves pblicas y privadas


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. Para obtener informacin detallada, consulte Captulo 6, Proteccin de botones utilizando Pago estndar encriptado Ejemplo de iniciacin de pago con Pasarela integral. El ejemplo muestra los parmetros NVP utilizando BUTTONCODE=TOKEN para crear una URL para iniciar el flujo de pago de Pasarela integral.
... BUTTONCODE=TOKEN BUTONTYPE=PAYMENT BUTTONIMAGEURL=https://www.paypal.com/en_US/i/btn/btn_billing.gif L_BUTTONVAR0=subtotal=11 L_BUTTONVAR1=tax=2 L_BUTTONVAR2=shipping=3 L_BUTTONVAR3=handling=4 L_BUTTONVAR4=first_name=Bob L_BUTTONVAR5=last_name=Jones L_BUTTONVAR6=address1=Gardens L_BUTTONVAR7=address2=99343 L_BUTTONVAR8=city=Paris L_BUTTONVAR9=state=Alsace L_BUTTONVAR10=zip=75002 L_BUTTONVAR11=country=FR L_BUTTONVAR12=billing_first_name=BobBilling L_BUTTONVAR13=billing_last_name=JonesBilling"> L_BUTTONVAR14=billing_address1=5088 - 061 Craven Hill Gardens L_BUTTONVAR15=billing_address2=Apt# 199343 L_BUTTONVAR16=billing_city=Wolverhampton L_BUTTONVAR17=billing_state=West Midlands L_BUTTONVAR18=billing_zip=W12 4LQ L_BUTTONVAR19=billing_country=GB L_BUTTONVAR20=night_phone_a=408 L_BUTTONVAR21=night_phone_b=398 L_BUTTONVAR22=night_phone_c=3065 L_BUTTONVAR23=notify_url=www.ebay.com L_BUTTONVAR24=custom=custom1 L_BUTTONVAR25=cancel_return=http://www.cancel_return.com L_BUTTONVAR26=paymentaction=sale L_BUTTONVAR27=currency_code=GBP L_BUTTONVAR29=invoice= L_BUTTONVAR30=lc=GB L_BUTTONVAR31=showBillingAddress=false L_BUTTONVAR32=showShippingAddress=false L_BUTTONVAR33=showBillingEmail=true L_BUTTONVAR33=showBillingPhone=true L_BUTTONVAR34=showCustomerName=true

Gua de Integracin de Pasarela integral

45

Integracin de su sitio Web mediante API


Operacin de API BMCreateButton

L_BUTTONVAR35=showCardInfo=true L_BUTTONVAR36=showHostedThankyouPage=true L_BUTTONVAR37=bn=GBD L_BUTTONVAR38=cbt=Merchant ABCD L_BUTTONVAR39=address_override=0 L_BUTTONVAR40=cpp_header_image=Red L_BUTTONVAR41=logoText=WalMart L_BUTTONVAR42=logoImage=http://i2.walmartimages.com/wmlogo.gif L_BUTTONVAR43=logoImagePosition=center L_BUTTONVAR44=logoFont=Arial Bold L_BUTTONVAR45=logoFontSize=24px L_BUTTONVAR46=logoFontColor=#f0ff0f L_BUTTONVAR47=bodyBgImg=sdf L_BUTTONVAR48=bodyBgColor=#AEAEAE L_BUTTONVAR49=headerHeight=70px L_BUTTONVAR50=headerBgColor=#4B6BA1 L_BUTTONVAR51=PageTitleTextColor=Blue L_BUTTONVAR52=PageCollapseBgColor=Blue L_BUTTONVAR53=PageCollapseTextColor=Yellow L_BUTTONVAR54=PageButtonBgColor=Blue L_BUTTONVAR55=PageButtonBgColor=Blue L_BUTTONVAR56=orderSummaryBgColor=#EDF2F7 L_BUTTONVAR57=orderSummaryBgImage=http://teamworks/scr_bg_ordersummary.jpg L_BUTTONVAR58=footerTextColor=#333333 L_BUTTONVAR59=footerTextlinkColor=#00f00f L_BUTTONVAR60=template=templateC L_BUTTONVAR61=return=http://www.walmart.com

Operacin de API BMCreateButton


Utilice la operacin de API BMCreateButton 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.

46

Gua de Integracin de Pasarela integral

Integracin de su sitio Web mediante API


Operacin de API BMCreateButton

Campos de solicitud de BMCreateButton

Campo METHOD

Descripcin (Obligatorio) BMCreateButton (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, 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 (Obligatorio) El tipo de botn de desea crear. PAYMENT: Botn Pagar ahora; desde la versin 65.2 (Opcional) Variables de botn HTML estndar

BUTTONCODE

BUTTONTYPE L_BUTTONVARn

Opciones de idioma de botn

El idioma de botn debe ser compatible con el pas identificado por el cdigo de pas.
Pas Todos los pases no identificados a continuacin Austria Blgica Opciones de idioma de botn
en:

ingls; opcin predeterminada alemn; opcin predeterminada ingls

de: en: en: nl:

ingls; opcin predeterminada holands fr: francs


en: fr:

Canad China (en todo el mundo) Francia Alemania Hong Kong Italia

ingls; opcin predeterminada francs ingls; opcin predeterminada chino francs; opcin predeterminada ingls alemn; opcin predeterminada ingls chino; opcin predeterminada ingls italiano; opcin predeterminada ingls

en: zh: fr: en: de: en: zh: en: it: en:

Gua de Integracin de Pasarela integral

47

Integracin de su sitio Web mediante API


Operacin de API BMCreateButton

Pas Japn Mxico Pases Bajos Polonia Espaa Suiza

Opciones de idioma de botn


ja: en: es: en: nl: en: pl: en: es: en: de: fr:

japons; opcin predeterminada ingls espaol; opcin predeterminada ingls holands; opcin predeterminada ingls polaco; opcin predeterminada ingls espaol; opcin predeterminada ingls

alemn; opcin predeterminada francs en: ingls ingls; opcin predeterminada francs es: espaol zh: chino
en: fr:

Estados Unidos

Respuesta 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

Campo WEBSITECODE EMAILLINK HOSTEDBUTTONID

Descripcin Cdigo HTML para pginas Web Cdigo para URL para el flujo de pago de Pasarela integral Id. de un cdigo personal de Pasarela integral

48

Gua de Integracin de Pasarela integral

Integracin de su sitio Web mediante API


Operacin de API BMCreateButton

Errores de BMCreateButton

Cdigo de error 10001 11923 11924 11925 11926 11927 11928 11929

Mensaje corto Error interno Argumento no vlido Argumento no vlido Argumento no vlido Datos no vlidos Argumento no vlido Argumento no vlido Datos no vlidos

Mensaje largo Error interno El valor de imagen de botn especificado no es vlido. La URL de imagen de botn especificada no es vlida. El tipo de botn especificado no es vlido. Uno de los parmetros especificados que utilizan ButtonVar no es vlida. El texto del botn Comprar ahora especificado no es vlido. El correo electrnico o el Id. de vendedor especificados no son vlidos. Un botn de carro necesita que se especifiquen un nombre de artculo y un importe. Un botn de cupn de regalo necesita que se especifique una URL de compras vlida. El texto del botn Suscripcin especificado no es vlido. Debe especificar un nmero correspondiente de entradas para nombres y selecciones de opcin. No puede omitir nmeros de ndice para selecciones de opcin. Las selecciones de opcin se deben especificar secuencialmente. Debe especificar el mismo nmero de entradas para precios que para selecciones de opcin. No puede especificar a la vez un precio de artculo y precios para selecciones individuales dentro de una opcin.

Corrigiendo error...

11930

Datos no vlidos

11931 11932

Argumento no vlido Datos no vlidos

11933

Datos no vlidos

11934

Datos no vlidos

11936

Datos no vlidos

Gua de Integracin de Pasarela integral

49

Integracin de su sitio Web mediante API


Operacin de API BMCreateButton

Cdigo de error 11937

Mensaje corto Argumento no vlido

Mensaje largo Un nombre de cuadro de texto especificado no es vlido. Los nombres de cuadro de texto no deben superar los 64 caracteres. El valor de cdigo de botn especificado no es vlido. Un nombre de opcin especificado no es vlido. Los nombres de opcin no deben superar los 64 caracteres. Un valor de seleccin de opcin especificado no es vlido. Los valores de seleccin de opcin no deben superar los 64 caracteres. Un valor de precio de opcin especificado no es vlido. Asegrese de que los signos de puntuacin se han introducido correctamente. El valor de pas de botn especificado no es vlido. La combinacin de pas de botn y cdigo de idioma especificada no es vlida. La tasa de impuesto especificada no es vlida. Asegrese de que los signos de puntuacin se han introducido correctamente y de que el valor especificado est comprendido entre 0,0 y 100. El importe especificado no es vlido. Asegrese de que los signos de puntuacin se han introducido correctamente. El valor de cdigo de divisa especificado no es vlido. El importe de subtotal no es vlido. El importe de impuesto no es vlido. El importe de manipulacin no es vlido. El importe de envo no es vlido.

Corrigiendo error...

11938 11940

Argumento no vlido Argumento no vlido

11941

Argumento no vlido

11942

Argumento no vlido

11943 11945 11947

Argumento no vlido Datos no vlidos Argumento no vlido

11948

Argumento no vlido

12210 13117 13118 13119 13120

Argumento no vlido Argumento no vlido Argumento no vlido Argumento no vlido Argumento no vlido

50

Gua de Integracin de Pasarela integral

Proteccin de botones utilizando Pago estndar encriptado


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. Pago estndar encriptado se basa en una encriptacin estndar de clave pblica para su proteccin. Con las claves pblica y privada, puede generar dinmicamente cdigo HTML para botones de pago y encriptar los detalles de pago antes de mostrar los botones en el sitio Web. La tabla siguiente ilustra la secuencia de acciones que tienen lugar con botones de pago protegidos utilizando Pago estndar encriptado.

TABLA 6.1 Cmo funciona Pago estndar encriptado Acciones del sitio Web Genere una clave pblica para el sitio Web, crguela en PayPal y descargue el certificado pblico de PayPal en el sitio Web.
N O T A : Realice esta accin una

Accin del comprador

Accin de PayPal

sola vez, al integrar por primera vez Pago estndar en su sitio Web. Genere cdigo HTML para un botn de pago. Encripte el cdigo generado utilizando la clave pblica de PayPal y firmando el cdigo encriptado con la clave privada del sitio Web. Publique el cdigo HTML firmado y encriptado para el botn de pago en el sitio Web. Haga clic en el botn de pago de PayPal publicado. Compruebe la autenticidad de los datos utilizando la clave pblica del sitio Web, que se carg previamente en PayPal. Desencripte el cdigo de botn protegido utilizando la clave privada de PayPal.

Gua de Integracin de Pasarela integral

Proteccin de botones utilizando Pago estndar encriptado


Encriptacin de clave pblica utilizada por Pago estndar encriptado TABLA 6.1 Cmo funciona Pago estndar encriptado Acciones del sitio Web Accin del comprador Accin de PayPal Redirija el navegador del pagador a la experiencia de pago de PayPal correspondiente, segn se especifique en las variables HTML del cdigo de botn desencriptado.

Encriptacin de clave pblica utilizada por Pago estndar encriptado


Pago estndar encriptado utiliza encriptacin de clave pblica, o criptografa asimtrica, que proporciona seguridad y comodidad, al permitir a remitentes y destinatarios de la comunicacin encriptada intercambiar claves pblicas para desbloquear los mensajes de la otra parte. Los aspectos fundamentales de la encriptacin de clave pblica son:

Claves pblicas: Las claves pblicas las crean los destinatarios y se entregan a los remitentes antes de que encripten y enven la informacin. Los certificados pblicos se componen de una clave pblica y de informacin de identificacin, como el originador de la clave y una fecha de caducidad. Los certificados pblicos los pueden firmar autoridades emisoras de certificados, que garantizan que los certificados pblicos y sus claves pblicas pertenecen a las entidades especificadas. Usted y PayPal intercambian los certificados pblicos. Claves privadas: Las claves privadas las crean los destinatarios y las guardan confidencialmente. Usted crea una clave privada y la conserva en su sistema. PayPal conserva en su propio sistema su propia clave privada.

El proceso de encriptacin: Los remitentes utilizan sus claves privadas y las claves pblicas de los destinatarios para encriptar la informacin antes de enviarla. Los destinatarios utilizan sus claves privadas y las claves pblicas de los destinatarios para desencriptar la informacin antes de enviarla. El proceso de encriptacin tambin utiliza firmas digitales de certificados pblicos para verificar el remitente de la informacin. Usted utiliza su clave privada y la clave pblica de PayPal para encriptar el cdigo HTML de botn. PayPal utiliza su propia clave privada y la clave pblica de usted para desencriptar el cdigo de botn antes de que los usuarios hagan clic en los botones de pago.

Configuracin de certificados antes de utilizar Pago estndar encriptado


Realice las acciones siguientes antes de utilizar Pago estndar encriptado para proteger sus botones de pago:

52

Gua de Integracin de Pasarela integral

Proteccin de botones utilizando Pago estndar encriptado


Configuracin de certificados antes de utilizar Pago estndar encriptado

Generacin de su clave privada utilizando OpenSSL Generacin de su certificado pblico utilizando OpenSSL Carga de su certificado pblico en su cuenta PayPal Descarga del certificado pblico de PayPal del sitio Web de PayPal

PayPal slo utiliza certificados pblicos X.509, no claves pblicas. Se puede utilizar una clave pblica para la desencriptacin, pero no contiene informacin que identifique quin proporcion la clave. Un certificado pblico incluye una clave pblica junto con informacin sobre la clave, como cundo caduca o a quin pertenece. PayPal acepta certificados pblicos en formato OpenSSL PEM de cualquier autoridad establecida emisora de certificados, como VeriSign. Puede generar una clave privada y un certificado pblico propios utilizando software de cdigo fuente abierto, como OpenSSL (https://www.openssl.org), que se detalla en la siguiente seccin.

Generacin de su clave privada utilizando OpenSSL


Utilizando el programa openssl, introduzca el comando siguiente para generar su clave privada. El comando genera una clave privada RSA de 1024 bits que se almacena en el archivo my-prvkey.pem:
openssl genrsa -out my-prvkey.pem 1024

Generacin de su certificado pblico utilizando OpenSSL


El certificado pblico debe tener formato PEM. Para generar su certificado, introduzca el siguiente comando openssl, que genera un certificado pblico en el archivo my-pubcert.pem:
openssl req -new -key my-prvkey.pem -x509 -days 365 -out my-pubcert.pem

Carga de su certificado pblico en su cuenta PayPal


Para cargar su certificado pblico en su cuenta PayPal: 1. Inicie sesin en su cuenta PayPal en https://www.paypal.es. 2. Haga clic en la subpestaa Perfil. 3. En la columna Preferencias de ventas, haga clic en el vnculo Configuracin de pagos encriptados. Aparece la pgina Certificados de Pago estndar. 4. Desplcese hacia abajo en la pgina hasta la seccin Sus certificados pblicos y haga clic en el botn Aadir. Aparece la pgina Aadir certificado.

Gua de Integracin de Pasarela integral

53

Proteccin de botones utilizando Pago estndar encriptado


Configuracin de certificados antes de utilizar Pago estndar encriptado

5. Haga clic en el botn Examinar y seleccione el certificado pblico que desea cargar en PayPal desde el ordenador local.
N O T A : El

archivo que cargue debe tener formato PEM.

6. Haga clic en Aadir. Una vez cargado el certificado pblico, aparecer en la seccin Sus certificados pblicos de la pgina Certificados de Pago estndar. 7. Guarde el Id. de certificado que PayPal ha asignado a su certificado pblico en lugar seguro. Necesitar el Id. de certificado asignado por PayPal para encriptar sus botones de pago utilizando el software de Pago estndar encriptado proporcionado por PayPal.

54

Gua de Integracin de Pasarela integral

Proteccin de botones utilizando Pago estndar encriptado


Configuracin de certificados antes de utilizar Pago estndar encriptado

Descarga del certificado pblico de PayPal del sitio Web de PayPal


Para descargar el certificado pblico de PayPal: 1. Inicie sesin en su cuenta PayPal en https://www.paypal.es. 2. Haga clic en la subpestaa Perfil. 3. En la columna Preferencias de vendedor, haga clic en el vnculo Configuracin de pagos encriptados 4. Desplcese hacia abajo en la pgina hasta la seccin Certificado pblico de PayPal. 5. Haga clic en el botn Descargar y guarde el archivo en una ubicacin segura del ordenador local.

Eliminacin del certificado pblico


IMPO RTANTE: Si

elimina su certificado pblico, su Id. de certificado asociado ya no ser vlido para encriptar botones y los botones que haya generado o que haya escrito manualmente para su sitio Web que utilicen el Id. no funcionarn correctamente.

Para eliminar uno o varios de sus certificados pblicos: 1. Inicie sesin en su cuenta PayPal en https://www.paypal.es. 2. Haga clic en la subpestaa Perfil. 3. En la columna Preferencias de vendedor, haga clic en el vnculo Configuracin de pagos encriptados 4. Desplcese hacia abajo en la pgina hasta la seccin Certificado pblico de PayPal. 5. Seleccione el botn de opcin junto al certificado que desee eliminar y haga clic en el botn Eliminar. Aparece la pgina Eliminar certificado. 6. Haga clic en el botn Eliminar para confirmar la eliminacin del certificado pblico que ha seleccionado.

Gua de Integracin de Pasarela integral

55

Proteccin de botones utilizando Pago estndar encriptado


Configuracin de certificados antes de utilizar Pago estndar encriptado

Uso de Pago estndar encriptado para proteger los botones de pago


Pago estndar encriptado incluye software de Java y Microsoft Windows para proteger botones de pago generados o escritos manualmente. Descargue el software de la siguiente ubicacin tras iniciar sesin en PayPal: https://www.paypal.com/es/cgibin/webscr?cmd=p/xcl/rec/ewp-code. Tras descargar y extraer el software, copie su clave privada, el certificado pblico, el archivo p12 y el certificado pblico de PayPal a la carpeta en la que se encuentre el software. 1. Prepare un archivo de entrada de variables de Pago estndar y valores para cada botn encriptado que desee generar. Cada variable y cada valor deben estar en una lnea diferente, como en el ejemplo siguiente.
N O T A : La

variable cert_id identifica el certificado pblico que usted carg en el sitio Web de PayPal.

cert_id=Z24MFU6DSHBXQ cmd=_xclick business=sales@company.com item_name=Handheld Computer item_number=1234 custom=sc-id-789 amount=500.00 currency_code=USD tax=41.25 shipping=20.00 address_override=1 address1=123 Main St city=Austin state=TX zip=94085 country=US no_note=1 cancel_return=http://www.company.com/cancel.htm

2. Ejecute el software de encriptacin utilizando la sintaxis adecuada, como se muestra a continuacin: - Java: PPEncrypt CertFile PrivKeyFile PPCertFile InputFile OutputFile [Sandbox] - Microsoft Windows: java ButtonEncryption CertFile PKCS12File PPCertFile Password InputFile OutputFile [Sandbox] donde el argumento es: - CertFile: Nombre de ruta para su propio certificado pblico - PKCS12File: Nombre de ruta para el formato PKCS12 de su propio certificado pblico - PPCertFile: Nombre de ruta para una copia del certificado pblico de PayPal - Password: Frase de acceso al formato PKCS12 de su propio certificado pblico

56

Gua de Integracin de Pasarela integral

Proteccin de botones utilizando Pago estndar encriptado


Configuracin de certificados antes de utilizar Pago estndar encriptado

- InputFile: Nombre de ruta para el archivo que contiene las variables de formulario HTML de pagos estndar no encriptados - OutputFile: Nombre de archivo para la salida encriptada - [Sandbox]: La palabra opcional Sandbox le permite probar botones de pago en el entorno de pruebas de PayPal que usted protegi con Pago estndar encriptado 3. Copie el cdigo encriptado en su sitio Web.

Bloqueo de pagos estndar desprotegidos y no encriptados


Para aadir seguridad a los botones protegidos y encriptados, actualice el perfil de su cuenta PayPal para bloquear pagos desprotegidos y no encriptados. Para bloquear pagos de botones de Pago estndar desprotegidos y no encriptados: 1. Inicie sesin en su cuenta PayPal en https://www.paypal.es. 2. Haga clic en la subpestaa Perfil. 3. En la columna Preferencias de vendedor, haga clic en el vnculo Configuracin de pagos encriptados 4. Desplcese hacia abajo en la pgina hasta la seccin Pago estndar encriptado. 5. Junto a la etiqueta Bloquear pago estndar no encriptado, seleccione el botn de opcin Activado. 6. Desplcese hasta la parte inferior de la pgina y haga clic en.Guardar.

Gua de Integracin de Pasarela integral

57

Proteccin de botones utilizando Pago estndar encriptado


Configuracin de certificados antes de utilizar Pago estndar encriptado

58

Gua de Integracin de Pasarela integral

Prueba de la integracin en el entorno de pruebas


El entorno de pruebas PayPal Sandbox es un entorno interno dentro del que puede realizar prototipos y probar funciones de PayPal. El entorno de pruebas PayPal Sandbox es una copia casi exacta del sitio Web real de PayPal. Su finalidad es ofrecer a los programadores un entrono 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 expuestos por la red de programadores de PayPal (PDN). Para ver informacin completa sobre cmo utilizar el entorno de pruebas, consulte la Gua del usuario del entorno de pruebas.

Creacin de una cuenta preconfigurada


Al iniciar sesin en el entorno de pruebas, aparece la pgina principal del entorno de pruebas, como se muestra a continuacin:

Gua de Integracin de Pasarela integral

59

Prueba de la integracin en el entorno de pruebas


Creacin de una cuenta preconfigurada

Para probar la integracin de Pasarela integral, cree una cuenta preconfigurada siguiendo estos pasos: 1. En la pgina principal del entorno de pruebas, en la seccin Cuentas de prueba, haga clic en Crear cuenta preconfigurada de comprador o vendedor. 2. Aparece la pgina Crear cuenta de prueba del entorno de pruebas, como se muestra a continuacin:

60

Gua de Integracin de Pasarela integral

Prueba de la integracin en el entorno de pruebas


Creacin de una cuenta preconfigurada

3. Elija Espaa en el men desplegable Pas. 4. Seleccione Pago Pro como Tipo de cuenta. 5. Los campos de correo electrnico y contrasea de identificacin se rellenan automticamente. El resto de los campos son opciones, as que realice las selecciones oportunas o acepte las predeterminadas.
N O T A : Tome nota de la contrasea, ya que la necesitar para iniciar sesin en el entorno de

pruebas. 6. Haga clic en Crear cuenta. Esta pgina confirma la creacin de la cuenta de prueba:

N O T A : El correo electrnico de identificacin es una direccin pseudoaleatoria que se basa

en la direccin que usted especific. Los nmeros de tarjeta de crdito y de cuenta bancaria tambin se generan de forma aleatoria, y se muestran al hacer clic en Ver detalles. 7. Compruebe que el valor Revisin del pago est definido como Activada. Al hacerlo, todas las transacciones de esta cuenta se ponen en estado pendiente. Entonces, puede hacer clic para aceptar o rechazar en la pgina Detalles de transaccin para simular la accin de un agente fraudulento.

Gua de Integracin de Pasarela integral

61

Prueba de la integracin en el entorno de pruebas


Creacin de una cuenta preconfigurada

8. Haga clic en Acceder al sitio de prueba del entorno de pruebas. El sitio de prueba del entorno de pruebas aparece en una ventana nueva del navegador, como se muestra a continuacin. Si no se abre la sesin en el sitio de prueba del entorno de pruebas automticamente, inicie sesin utilizando la direccin de correo electrnica creada para la cuenta de prueba como parte del paso 6, as como la contrasea de la que tom nota en el paso 5.

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

62

Gua de Integracin de Pasarela integral

Prueba de la integracin en el entorno de pruebas


Creacin de una cuenta preconfigurada

Prueba de la integracin y la configuracin


Las 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:
<form action=https://securepayments.paypal.com/acquiringweb?cmd=_hostedpayment method="post"> <input type="hidden" name="cmd" value="_hosted-payment">

a:
<form action= https://securepayments.sandbox.paypal.com/cgibin/acquiringweb method="post"> <input type="hidden" name="cmd" value="_hosted-payment">

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:
<form action= https://www.sandbox.paypal.com/cgi-bin/acquiringweb method="post"> <input type="hidden" name="cmd" value="_hosted-payment"> <input type name="subtotal" value="50"> <input type name="business" value="HNZ3QZMCPBAAA"> <input type name="return" value="https://yourwebsite.com/receipt_page.html"> <input type="submit" name="METHOD" value="Pay Now"> </form>
NOTA:

Prueba de la configuracin

Para cambiar el aspecto y el estilo de su pgina de pago, modifique la configuracin de las pginas y Configuracin de la seccin Perfil del sitio del entorno de pruebas. Para ver los

Gua de Integracin de Pasarela integral

63

Prueba de la integracin en el entorno de pruebas


Creacin de una cuenta preconfigurada

detalles completos, consulte Modificacin de la configuracin de la cuenta PayPal en la pgina 23.

64

Gua de Integracin de Pasarela integral

Procesamiento de pedidos

Este 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 transaccin


Cuando el comprador completa correctamente una transaccin, se le redirige o a la pgina de confirmacin de PayPal o a un sitio Web que usted especific 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. Al recibir la redireccin (URL con Id. de transaccin), debe verificar que el pedido se ha 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:

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

Una vez procesada una transaccin, PayPal enva una IPN a la URLnotify especificada en su transaccin o en su perfil de PayPal. Debe verificar que el Id. de transaccin, el importe de transaccin y otros parmetros especficos del pedido, como el Id. de factura, y que se envan en la IPN coinciden con la informacin de la que dispone en su sistema de procesamiento de pedidos Para obtener ms detalles, consulte la Gua de notificacin de pago instantnea.

Gua de Integracin de Pasarela integral

65

Procesamiento de pedidos
Cumplimentacin del pedido

Ejecutar una llamada de API GetTransactionDetails


Utilizando la API GetTransactionDetails, puede obtener informacin sobre una transaccin especfica. Si ha integrado las API de PayPal, puede llamar a GetTransactionDetails con el Id. de transaccin que se devolvi en la redireccin de Web para validar la autenticidad del pedido. Para ver los detalles completos, consulte API GetTransactionDetails en la pgina 67.

Cumplimentacin del pedido


Tras haber verificado la autenticidad del importe y el estado del pago, puede cumplimentar el pedido enviando el artculo al comprador.
N O T A : Para

beneficiarse de la proteccin del vendedor, el artculo comprado se debe enviar a la direccin que se proporcion a PayPal en la pgina de pago o se comunic con anterioridad. De lo contario, el artculo no est cubierto por la Proteccin del vendedor. Para ms informacin, vaya a Proteccin del vendedor en la pgina 12.

66

Gua de Integracin de Pasarela integral

Operaciones de API opcionales

Utilizando el Id. de transaccin, hay disponibles varias operaciones de API de PayPal. Las ms utilizadas para Pasarela integral son: API GetTransactionDetails API RefundTransaction API DoCapture

API GetTransactionDetails
Obtener informacin sobre una transaccin especfica.

Solicitud de GetTransactionDetails Respuesta de GetTransactionDetails

Solicitud de GetTransactionDetails

TABLA A.1 Campo


METHOD

Campos de solicitud de GetTransactionDetails Descripcin Debe ser GetTransactionDetails. (Obligatorio) Identificador exclusivo de una transaccin.
N O T A : Los detalles de algunos tipos de transacciones no se pueden

TRANSACTIONID

recuperar con GetTransactionDetails. No puede obtener detalles de retiradas de transferencias bancarias, por ejemplo. Longitud y limitaciones de caracteres: 17 caracteres alfanumricos de byte nico.

Gua de Integracin de Pasarela integral

67

Operaciones de API opcionales


API GetTransactionDetails

Respuesta de GetTransactionDetails

N O T A : Todos

los campos definidos en la estructura formal de la respuesta de GetTransactionDetails Se devuelven los datos en una respuesta slo si PayPal tiene datos registrados que se corresponden con el campo.

Campos de informacin de receptor Campos de informacin de pagador Campos de nombre del pagador Campos de direccin Campos de informacin de pago Campos de informacin de artculo de pago Campos de artculo de pago Campos de subasta Campos de trminos de suscripcin

Campos de informacin de receptor

TABLA A.2 Campo

Campos de informacin de receptor Descripcin Direccin de correo electrnico principal del receptor del pago (el vendedor). Si es destinatario del pago y el pago se enva a su direccin de correo electrnico no principal, el valor de receptor seguir siendo su direccin de correo electrnico principal. Longitud y limitaciones de caracteres: 127 caracteres alfanumricos de byte nico. Id. de cuenta exclusivo del destinatario del pago (el vendedor). Este valor es el mismo que el del Id. de recomendacin del destinatario.

RECEIVERMAIL

RECEIVERID

68

Gua de Integracin de Pasarela integral

Operaciones de API opcionales


API GetTransactionDetails

Campos de informacin de pagador

TABLA A.3 Campo


EMAIL

Campos de informacin de pagador Descripcin Direccin de correo electrnico del pagador. Longitud y limitaciones de caracteres: 127 caracteres de byte nico. Nmero de identificacin exclusivo de cuenta PayPal de cliente. Longitud y limitaciones de caracteres: 13 caracteres alfanumricos de byte nico. Estado del pagador. Valores vlidos: verified unverified Longitud y limitaciones de caracteres: 10 caracteres alfabticos de byte nico. Pas de residencia del pagador con el formato de la norma ISO 3166 para cdigos de pas de dos caracteres. Longitud y limitaciones de caracteres: Dos caracteres de byte nico. Nombre de empresa del pagador. Longitud y limitaciones de caracteres: 127 caracteres de byte nico.

PAYERID

PAYERSTATUS

SHIPTOCOUNTRYCODE

PAYERBUSINESS

Campos de nombre del pagador

TABLA A.4 Campo


SALUTATION

Campos de nombre del pagador Descripcin Saludo del pagador. Longitud y limitaciones de caracteres: 20 caracteres de byte nico. Nombre del pagador. Longitud y limitaciones de caracteres: 25 caracteres alfanumricos de byte nico. Segundo nombre del pagador. Longitud y limitaciones de caracteres: 25 caracteres alfanumricos de byte nico. Apellidos del pagador. Longitud y limitaciones de caracteres: 25 caracteres alfanumricos de byte nico.

FIRSTNAME

MIDDLENAME

LASTNAME

Gua de Integracin de Pasarela integral

69

Operaciones de API opcionales


API GetTransactionDetails TABLA A.4 Campo
SUFFIX

Campos de nombre del pagador Descripcin Sufijo del pagador. Longitud y limitaciones de caracteres: 12 caracteres alfanumricos de byte nico.

Campos de direccin

TABLA A.5 Campo

Campos de direccin Descripcin Empresa de eBay que mantiene esta direccin. Valores vlidos: eBay PayPal Estado de la direccin postal registrada con PayPal. Valores vlidos: none Confirmed Unconfirmed Nombre de la persona que tiene esta direccin. Longitud y limitaciones de caracteres: 32 caracteres de byte nico. Primera direccin postal Longitud y limitaciones de caracteres: 100 caracteres de byte nico. Segunda direccin postal Longitud y limitaciones de caracteres: 100 caracteres de byte nico. Nombre de la ciudad Longitud y limitaciones de caracteres: 100 caracteres de byte nico. Estado o provincia Longitud y limitaciones de caracteres: 40 caracteres de byte nico. Cdigo postal de EE.UU. o cdigo postal especfico de otro pas. Longitud y limitaciones de caracteres: 40 caracteres de byte nico. Nombre ampliado del pas Longitud y limitaciones de caracteres: 20 caracteres de byte nico. Cdigo de pas. Longitud y limitaciones de caracteres: Dos caracteres de byte nico. Cdigo de pas. Longitud y limitaciones de caracteres: Dos caracteres de byte nico.

ADDRESSOWNER

ADDRESSSTATUS

SHIPTONAME

SHIPTOSTREET

SHIPTOSTREET2

SHIPTOCITY

SHIPTOSTATE

SHIPTOZIP

SHIPTOCOUNTRYCODE

SHIPTOPHONENUMBER

SHIPTOPHONENUM

70

Gua de Integracin de Pasarela integral

Operaciones de API opcionales


API GetTransactionDetails

Campos de informacin de pago

TABLA A.6 Campo

Campos de informacin de pago Descripcin Id. de transaccin exclusivo del pago. Longitud y limitaciones de caracteres: 17 caracteres de byte nico. Nmero de identificacin de transaccin principal o relacionada. Este campo se rellena para los siguientes tipos de transaccin: Cancelacin: Captura de una transaccin autorizada. Cancelacin: Nueva autorizacin de una transaccin. Captura de un pedido: El valor de ParentTransactionID es el OrderID original. Autorizacin de un pedido: El valor de ParentTransactionID es el OrderID original. Captura de una autorizacin de pedido. Anulacin de un pedido: El valor de ParentTransactionID es el OrderID original. Longitud y limitaciones de caracteres: 16 dgitos en formato xxxxxxxx-xxxx-xxxx Nmero de identificacin de recibo Longitud y limitaciones de caracteres: 16 dgitos en formato xxxxxxxx-xxxx-xxxx El tipo de transaccin Valores vlidos: cart express-checkout Longitud y limitaciones de caracteres: 15 caracteres de byte nico. Indica si el pago es instantneo o se ha retrasado. Longitud y limitaciones de caracteres: Siete caracteres de byte nico. Valores vlidos: none echeck instant Marca de fecha y hora del pago. Por ejemplo: 2006-08-15T17:23:15Z.

TRANSACTIONID

PARENTTRANSACTIONID

RECEIPTID

TRANSACTIONTYPE

PAYMENTTYPE

ORDERTIME

Gua de Integracin de Pasarela integral

71

Operaciones de API opcionales


API GetTransactionDetails TABLA A.6 Campo
AMT

Campos de informacin de pago Descripcin Importe final cargado incluyendo la forma de envo y los impuestos del perfil del vendedor. Longitud y limitaciones de caracteres: No debe superar 10.000 USD en ninguna divisa. Sin smbolo de divisa. Independientemente de la divisa, el separador decimal es un punto (.) y el separador opcional de millares es una coma (,). Equivalente a un mximo de nueve caracteres para USD. Cdigo de divisa de tres caracteres. Tarifa de PayPal cargada para la transaccin Longitud y limitaciones de caracteres: No debe superar 10.000 USD en ninguna divisa. Sin smbolo de divisa. Independientemente de la divisa, el separador decimal es un punto (.) y el separador opcional de millares es una coma (,). Equivalente a un mximo de nueve caracteres para USD. Importe depositado en la cuenta PayPal tras la conversin de divisa. Impuesto aplicado a la transaccin. Longitud y limitaciones de caracteres: No debe superar 10.000 USD en ninguna divisa. Sin smbolo de divisa. Independientemente de la divisa, el separador decimal es un punto (.) y el separador opcional de millares es una coma (,). Equivalente a un mximo de nueve caracteres para USD. Tipo de cambio si tiene lugar una conversin de divisas. Es relevante slo si va a facturar en una divisa no principal. Si el cliente opta por pagar en una divisa distinta de la divisa principal, la conversin se realiza en la cuenta del cliente. Longitud y limitaciones de caracteres: Un decimal que no supere los 17 caracteres, incluido el separador decimal.

CURRENCYCODE FEEAMT

SETTLEAMT TAXAMT

EXCHANGERATE

72

Gua de Integracin de Pasarela integral

Operaciones de API opcionales


API GetTransactionDetails TABLA A.6 Campo
PAYMENTSTATUS

Campos de informacin de pago Descripcin Estado del pago. El estado del pago: None: Sin estado Canceled-Reversal: Se ha anulado una cancelacin; por ejemplo, si gana una disputa y los fondos para la cancelacin se le han devuelto a usted. Completed: El pago se ha completado y los fondos se han aadido correctamente al saldo de su cuenta. Denied: Usted ha rechazado el pago. Esto sucede slo si el pago estaba pendiente debido a una de las siguientes razones descritas en el elemento Motivos para estar pendiente. Expired Se ha alcanzado el perodo de autorizacin para este pago. Failed: ha habido un error en el pago. Esto sucede slo si el pago se realiz desde la cuenta bancaria de su cliente. In-Progress: La transaccin no ha terminado; p. ej., una autorizacin puede estar a la espera de completarse. Partially-Refunded: El pago se ha reintegrado en parte. Pending: El pago est pendiente. Consulte el campo PendingReason para obtener ms informacin. Refunded: Usted ha reintegrado el pago. Reversed: Se ha cancelado un pago debido a una devolucin de cargo u otro tipo de cancelacin. Los fondos se han retirado del saldo de su cuenta y se han devuelto al comprador. El motivo para la cancelacin se especifica en el elemento ReasonCode. Processed: Se ha aceptado un pago. Voided: Se ha anulado la autorizacin para esta transaccin.

Gua de Integracin de Pasarela integral

73

Operaciones de API opcionales


API GetTransactionDetails TABLA A.6 Campo
PENDINGREASON

Campos de informacin de pago Descripcin


N O T A : PendingReason se devuelve en la respuesta slo si

PaymentStatus equivale a Pending. El motivo por el que el pago est pendiente: none: Sin motivo para que el pago est pendiente. address: La direccin est pendiente porque su cliente no incluy una direccin de envo confirmada y sus preferencias de recepcin de pagos estn definidas para permitirle aceptar o rechazar manualmente cada uno de estos pagos. Para cambiar la preferencia, vaya a la seccin Preferencias de su Perfil. authorisation: El pago est pendiente porque se ha autorizado pero no se ha liquidado. Debe capturar los fondos antes. echeck: El pago est pendiente porque se realiz mediante cargo en cuenta bancaria y an no se ha compensado. intl: El pago est pendiente porque usted tiene una cuenta fuera de EE.UU. y no tiene mecanismo de retirada. Debe aceptar o rechazar manualmente este pago de su descripcin de cuenta. multi-currency: No tiene saldo en la divisa enviada y no tiene sus preferencias de recepcin de pagos definidas para convertir y aceptar automticamente este pago. Debe aceptar o rechazar manualmente este pago. order: El pago est pendiente porque forma parte de un pedido que se ha autorizado pero no se ha liquidado. paymentreview: El pago est pendiente mientras PayPal est revisando si hay riesgos. unilateral: El pago est pendiente porque se realiz a una direccin de correo electrnico que an no est registrada o confirmada. verify: El pago est pendiente porque usted no est verificado. Debe verificar su cuenta antes de poder aceptar este pago. other: El pago est pendiente por un motivo diferente a los especificados anteriormente. Para obtener ms informacin, pngase en contacto con el Servicio de Atencin al Cliente de PayPal.

74

Gua de Integracin de Pasarela integral

Operaciones de API opcionales


API GetTransactionDetails TABLA A.6 Campo
REASONCODE

Campos de informacin de pago Descripcin El motivo de la cancelacin si TransactionType es reversal: none: Sin cdigo de motivo chargeback: Se ha producido una cancelacin en esta transaccin porque su cliente ha presentado una devolucin de cargo. guarantee: Se ha producido una cancelacin en esta transaccin porque su cliente ha activado una garanta de devolucin de dinero. buyer-complaint: Se ha producido una cancelacin en esta transaccin porque su cliente ha cursado una reclamacin sobre la transaccin. refund: Se ha producido una cancelacin de esta transaccin porque ha dado un reintegro al cliente. other: Se ha producido una cancelacin de esta transaccin por un motivo diferente a los anteriores. Desde la versin 64.4, el tipo de proteccin del vendedor en vigor para la transaccin, que es uno de los valores siguientes: Eligible: El vendedor est protegido por la poltica de proteccin del vendedor de PayPal para pagos no autorizados y artculos no recibidos ItemNotReceivedEligible: El vendedor est protegido por la poltica de proteccin del vendedor de PayPal para artculos no recibidos UnauthorizedPaymentEligible: El vendedor est protegido por la poltica de proteccin del vendedor de PayPal para pagos no autorizados Ineligible: El vendedor no est protegido por la poltica de proteccin del vendedor de PayPal

PROTECTIONELIGIBILITY

Campos de informacin de artculo de pago

TABLA A.7 Campo


INVNUM

Campos de informacin de artculo de pago Descripcin Nmero de factura establecido en la transaccin original. Longitud y limitaciones de caracteres: 127 caracteres alfanumricos de byte nico. Campo personalizado establecido en la transaccin original. Longitud y limitaciones de caracteres: 127 caracteres alfanumricos de byte nico. Nota introducida por su cliente en el campo de nota de pago del sitio Web de PayPal. Longitud y limitaciones de caracteres: 255 caracteres alfanumricos de byte nico. Importe de impuestos cargado al pago.

CUSTOM

NOTE

SALESTAX

Gua de Integracin de Pasarela integral

75

Operaciones de API opcionales


API GetTransactionDetails

Campos de artculo de pago

TABLA A.8 Campo


L_DESCn

Campos de artculo de pago Descripcin Importe de impuestos cargado al pago. Estos parmetros se deben ordenar secuencialmente partiendo de 0 (por ejemplo L_DESC0, L_DESC1). Nmero de artculo establecido por usted. Si se trata de una transaccin de carro de la compra, PayPal aade el nmero del artculo a la variable HTML item_number. Por ejemplo, item_number1, item_number2, etc. Longitud y limitaciones de caracteres: 127 caracteres alfanumricos de byte nico. Estos parmetros se deben ordenar secuencialmente partiendo de 0 (por ejemplo L_NUMBER0, L_NUMBER1). Cantidad definida por el usuario o introducida por el cliente. Longitud y limitaciones de caracteres: Sin lmite Coste del artculo. Estos parmetros se deben ordenar secuencialmente partiendo de 0 (por ejemplo L_AMT0, L_AMT1). Nombres de opcin de PayPal para un artculo del carro de la compra; cada nombre se corresponde con un valor de opcin. Puede haber varios nombres de opcin por cada artculo. Los nombres de opcin se ordenan secuencialmente partiendo de 0 (por ejemplo, L_OPTIONSNAMES0, L_OPTIONSNAME1). Valores de opcin de PayPal que se corresponden con los nombres de opcin de un artculo del carro de la compra. Los nombres de opcin se ordenan secuencialmente partiendo de 0 (por ejemplo, L_OPTIONSVALUE0, L_OPTIONSVALUE1).

L_NUMBERn

L_QTYn

L_AMTn

L_OPTIONSNAMEn

L_OPTIONSVALUEn

Campos de subasta

TABLA A.9 Campo


BUYERID CLOSINGDATE MULTIITEM

Campos de subasta Descripcin Id. de subasta del cliente Fecha de cierre de la subasta Contador utilizado para los pagos de varios artculos de subasta.

76

Gua de Integracin de Pasarela integral

Operaciones de API opcionales


API RefundTransaction

Campos de trminos de suscripcin

TABLA A.10 Campos de trminos de suscripcin Campo


AMT

Descripcin Importe cargado al suscriptor en un pago. Longitud y limitaciones de caracteres: Sin lmite Perodo de tiempo que se carga al suscriptor. Longitud y limitaciones de caracteres: Sin lmite

PERIOD

API RefundTransaction
Emitir un reintegro al titular de la cuenta PayPal asociado a una transaccin.

Solicitud de RefundTransaction Respuesta de RefundTransaction

Solicitud de RefundTransaction

TABLA A.11 Campos de solicitud de RefundTransaction Campo


METHOD TRANSACTIONID

Descripcin Debe ser RefundTransaction. (Obligatorio) Identificador exclusivo de una transaccin. Longitud y limitaciones de caracteres: 17 caracteres alfanumricos de byte exclusivo. (Obligatorio) Tipo de reintegro que est realizando: Other Full Partial Importe del reintegro. Amount es obligatorio si RefundType es Partial.
N O T A : Si RefundType es Full, no puede definir Amount.

REFUNDTYPE

AMT

NOTE

(Opcional) Nota personalizada sobre el reintegro. Longitud y limitaciones de caracteres: 255 caracteres alfanumricos de byte nico.

Gua de Integracin de Pasarela integral

77

Operaciones de API opcionales


API DoCapture

Respuesta de RefundTransaction

TABLA A.12 Campos de respuesta de RefundTransaction Campo


REFUNDTRANSACTIONID

Descripcin Id. de transaccin exclusivo del reintegro. Longitud y limitaciones de caracteres: 17 caracteres alfanumricos de byte exclusivo. Tarifa de transaccin reintegrada al destinatario del pago original. Importe reintegrado al pagador original. Importe restado del saldo de PayPal del destinatario del pago original para hacer el reintegro.

FEEREFUNDAMT GROSSREFUNDAMT NETREFUNDAMT

API DoCapture
Capturar un pago autorizado.

Solicitud de DoCapture Respuesta de DoCapture

Solicitud de DoCapture

TABLA A.13 Campos de solicitud de DoCapture Campo


METHOD AUTHORIZATIONID

Descripcin (Obligatorio) Debe ser DoCapture. (Obligatorio) Nmero de identificacin de la autorizacin del pago que desea capturar. Es el Id de transaccin devuelto desde DoExpressCheckoutPayment o DoDirectPayment. Longitud y limitaciones de caracteres: 19 caracteres de byte nico como mximo. (Obligatorio) Importe que se va a capturar. Limitaciones: El valor es un nmero positivo que no puede superar 10,000 USD en ninguna divisa. Sin smbolo de divisa. Debe tener dos decimales, el separador decimal debe ser un punto (.) y el separador opcional de miles debe ser una coma (,). (Opcional) Cdigo de divisa de tres caracteres. Opcin predeterminada: USD.

AMT

CURRENCYCODE

78

Gua de Integracin de Pasarela integral

Operaciones de API opcionales


API DoCapture TABLA A.13 Campos de solicitud de DoCapture Campo
COMPLETETYPE

Descripcin (Obligatorio) El valor Complete indica si esta captura es la ltima que desea realizar. El valor NotComplete indica que tiene intencin de realizar ms capturas.
N O T A : Si es Complete, cualquier importe restante de la transaccin

de nueva autorizacin original se anula automticamente y las restantes autorizaciones abiertas se anulan. Longitud y limitaciones de caracteres: 12 caracteres alfanumricos de byte nico.
INVNUM

(Opcional) Nmero de factura u otro nmero de identificacin que se muestra al vendedor y al cliente en el historial de transacciones.
N O T A : Este valor en DoCapture sobrescribir un valor definido

anteriormente en onDoAuthorisation.
N O T A : El valor se registra slo si la autorizacin que va a capturar es

una autorizacin de pedido y no una autorizacin bsica. Longitud y limitaciones de caracteres: 127 caracteres alfanumricos de byte nico.
NOTE

(Opcional) Nota informativa sobre esta liquidacin que se muestra al pagador en el correo electrnico y en su historial de transacciones. Longitud y limitaciones de caracteres: 255 caracteres de byte nico.

Gua de Integracin de Pasarela integral

79

Operaciones de API opcionales


API DoCapture TABLA A.13 Campos de solicitud de DoCapture Campo
SOFTDESCRIPTOR

Descripcin (Opcional) El soft descriptor es una descripcin para cada transaccin del pago que se transfiere al extracto de la tarjeta de crdito del cliente. Si se proporciona un valor para el soft descriptor, el descriptor completo que se muestra en el extracto del cliente tiene el formato siguiente: <PP * | PAYPAL*><Descriptor del vendedor segn lo definido en las preferencias de recepcin de pagos><1space><soft descriptor> El soft descriptor slo puede contener los caracteres siguientes. Caracteres alfanumricos - (guin) * (asterisco) . (punto) {space} Si utiliza otros caracteres (como g,h), se devolver un cdigo de error. El soft descriptor no incluye el nmero de telfono, que se puede alternar entre el nmero del Servicio de Atencin al Cliente del vendedor y el de PayPal. La longitud mxima del soft descriptor total es de 22 caracteres. De ellos, 4 u 8 se usarn para el prefijo de PayPal que se muestra en el formato de datos. As, la longitud mxima del soft descriptor transferido en la solicitud de API es: 22- len(<PP * | PAYPAL *>) - len(<Descriptor segn lo definido en las preferencias de recepcin de pagos> + 1) Por ejemplo, supongamos las condiciones siguientes: El prefijo de PayPal se define como PAYPAL* en las herramientas administrativas de PayPal. El descriptor del vendedor definido en las preferencias de recepcin de pagos se define como EBAY. Se transfiere el soft descriptor como JanesFlowerGifts LLC. La cadena de descriptor resultante en la tarjeta de crdito sera: PAYPAL*EBAY JanesFlow

80

Gua de Integracin de Pasarela integral

Operaciones de API opcionales


API DoCapture

Respuesta de DoCapture

Campos de respuesta de DoCapture Campos de tipo de informacin de pagador Campos de direccin de destino Campos de nombre del pagador utiliza la versin 56.0 o posterior de la API DoCapture, slo se garantiza la devolucin del Id. de autorizacin, el Id. de transaccin, el tipo de transaccin, la fecha de pago, el importe bruto y el estado del pago. Si necesita los valores de otros campos y no se devuelven, puede obtenerlos llamando a GetTransactionDetails o utilizando el mecanismo de informes .

N O T A : Si

Campos de respuesta de DoCapture

TABLA A.14 Campos de respuesta de DoCapture Campo


AUTHORIZATIONID

Descripcin Nmero de identificacin de autorizacin especificado en la solicitud. Longitud y limitaciones de caracteres: 19 caracteres de byte nico como mximo.

Campos de tipo de informacin de pagador

TABLA A.15 Campos de tipo de informacin de pagador Campo


EMAIL

Descripcin Direccin de correo electrnico del pagador. Longitud y limitaciones de caracteres: 127 caracteres de byte nico. Nmero de identificacin exclusivo de cuenta PayPal de cliente. Longitud y limitaciones de caracteres: 13 caracteres alfanumricos de byte nico. Estado del pagador. Valores vlidos: verified unverified Longitud y limitaciones de caracteres: 10 caracteres alfabticos de byte nico. Pas de residencia del pagador con el formato de la norma ISO 3166 para cdigos de pas de dos caracteres. Longitud y limitaciones de caracteres: Dos caracteres de byte nico.

PAYERID

PAYERSTATUS

COUNTRYCODE

Gua de Integracin de Pasarela integral

81

Operaciones de API opcionales


API DoCapture TABLA A.15 Campos de tipo de informacin de pagador Campo
BUSINESS

Descripcin Nombre de empresa del pagador. Longitud y limitaciones de caracteres: 127 caracteres de byte nico.

Campos de direccin de destino

TABLA A.16 Campos de direccin de destino Campo


ADDRESSSTATUS

Descripcin Estado de la direccin postal registrada con PayPal. Valores vlidos: none Confirmed Unconfirmed Nombre de la persona que tiene esta direccin. Longitud y limitaciones de caracteres: 32 caracteres de byte nico. Primera direccin postal. Longitud y limitaciones de caracteres: 100 caracteres de byte nico. Segunda direccin postal. Longitud y limitaciones de caracteres: 100 caracteres de byte nico. Nombre de la ciudad. Longitud y limitaciones de caracteres: 40 caracteres de byte nico. Estado o provincia. Longitud y limitaciones de caracteres: 40 caracteres de byte nico. Obligatorio slo para direcciones de EE.UU. Cdigo postal de EE.UU. o cdigo postal especfico de otro pas. Longitud y limitaciones de caracteres: 20 caracteres de byte nico. Cdigo de pas. Longitud y limitaciones de caracteres: Dos caracteres de byte nico.

SHIPTONAME

SHIPTOSTREET

SHIPTOSTREET2

SHIPTOCITY

SHIPTOSTATE

SHIPTOZIP

SHIPTOCOUNTRYCODE

82

Gua de Integracin de Pasarela integral

Operaciones de API opcionales


API DoCapture

Campos de nombre del pagador

TABLA A.17 Campos de nombre del pagador Campo


SALUTATION

Descripcin Saludo del pagador. Longitud y limitaciones de caracteres: 20 caracteres de byte nico. Nombre del pagador. Longitud y limitaciones de caracteres: 25 caracteres de byte nico. Segundo nombre del pagador. Longitud y limitaciones de caracteres: 25 caracteres de byte nico. Apellidos del pagador Longitud y limitaciones de caracteres: 25 caracteres de byte nico. Sufijo del pagador Longitud y limitaciones de caracteres: 12 caracteres de byte nico.

FIRSTNAME

MIDDLENAME

LASTNAME

SUFFIX

Gua de Integracin de Pasarela integral

83

Operaciones de API opcionales


API DoCapture

84

Gua de Integracin de Pasarela integral

B
de:

Cambiarse de Website Payments Standard a Pasarela integral


Si se est cambiando de Website Payment Standard a Pasarela integral, debe realizar los cambios siguientes: 1. En la etiqueta FORM, cambie el valor cmd en el atributo de accin

<form action="https://www.paypal.com/cgi-bin/webscr" method="post"> <input type="hidden" name="cmd" value="_xclick">

to:
<form action=hhttps://securepayments.paypal.com/acquiringweb?cmd=_hoste d-paymenth method="post"><input type="hidden" name="cmd" value="_hosted-payment">

2. Cambie la variable HTML amount a subtotal.


N O T A : Website

Payment Standard tiene valores independientes para amount y quantity, mientras que Pasarela integral utiliza nicamente subtotal. Asegrese de que el subtotal incluye el importe que desea cobrar al comprador, teniendo en cuenta los descuentos aplicables y la cantidad de artculos.

3. Si ya ha personalizado el flujo de pago, como el color y el fondo, deber rehacer esa configuracin para Pasarela integral. Para obtener ms informacin sobre la personalizacin del aspecto y el estilo de su pgina de pago, consulte Captulo 3, Personalizacin de su pgina de pago de PayPal.

Gua de Integracin de Pasarela integral

85

Cambiarse de Website Payments Standard a Pasarela integral

Ejemplo de comparacin de cdigo


A continuacin se muestra una comparacin de cdigo de Website Payment Standard y Pasarela integral.
N O T A : En

los ejemplos siguientes, recuerde que para Website Payment Standard, amount y quantity se especifican como 10 y 2 respectivamente. Para Pasarela integral, subtotal es 20, que es la suma de los valores mencionados de amount y quantity. Se resalta en negrita.

Ejemplo de cdigo de Pago estndar <form action="https://www.paypal.com/cgi-bin/webscr" method="post"> <input type="hidden" name="cmd" value="_xclick"> <input type="hidden" name="business" value="seller@designerfotos.com"> <input type="hidden" name="amount" value="10"> <input type="hidden" name="quantity" value="2"> <input type="hidden" name="tax" value="1"> <input type="hidden" name="currency_code" value="USD"> <input type="hidden" name=" invoice" value="MEM32507725"> <!-- Enable override of payers stored PayPal address. --> <input type="hidden" name="address_override" value="1"> <!-- Set prepopulation variables to override stored address. --> <input type="hidden" name="first_name" value="John"> <input type="hidden" name="last_name" value="Doe"> <input type="hidden" name="address1" value="345 Lark Ave"> <input type="hidden" name="city" value="San Jose"> <input type="hidden" name="state" value="CA"> <input type="hidden" name="zip" value="95121"> <input type="hidden" name="country" value="US"> <input type="hidden" name="bn" value="CC_Partner_WPS"> <input type="hidden" name="notify_url" value="https://www.paypal.com/IPN/"> <input type="image" name="submit" border="0" src="https://www.paypal.com/img.gif "> </form> Ejemplo de cdigo de Pasarela integral <form action=https://securepayments.paypal.com/acquiringweb?cmd=_hostedpayment method="post"><input type="hidden" name="cmd" value="_hostedpayment"> <input type="hidden" name="business" value="HNZ3QZMCPBAAA"> <input type="hidden" name="subtotal" value="20"> <input type="hidden" name="tax" value="1"> <input type="hidden" name="currency_code" value="USD"> <input type="hidden" name="invoice" value="MEM32507725"> <input type="hidden" name="template" value=TemplateB"> <!-- Enable override of payers stored PayPal address. --> <input type="hidden" name="address_override" value="1"> <input type="hidden" name="showShippingAddress" value="false"> <!-- Set prepopulation variables to override stored address. --> <input type="hidden" name="first_name" value="John"> <input type="hidden" name="last_name" value="Doe">

86

Gua de Integracin de Pasarela integral

Cambiarse de Website Payments Standard a Pasarela integral

<input type="hidden" name="address1" value="345 Lark Ave"> <input type="hidden" name="city" value="San Jose"> <input type="hidden" name="state" value="CA"> <input type="hidden" name="zip" value="95121"> <input type="hidden" name="country" value="US"> <input type="hidden" name="billing_first_name" value="John"> <input type="hidden" name=" billing_last_name" value="Doe"> <input type="hidden" name=" billing_address1" value="345 Lark Ave"> <input type="hidden" name=" billing_city" value="San Jose"> <input type="hidden" name=" billing_state" value="CA"> <input type="hidden" name=" billing_zip" value="95121"> <input type="hidden" name=" billing_country" value="US"> <input type="hidden" name="bn" value="CC_Partner_H3S"> <input type="hidden" name="notify_url" value="https://www.paypal.com/IPN/"> <input type="image" name="submit" border="0" src="https://www.paypal.com/img.gif "> </form>

Gua de Integracin de Pasarela integral

87

Cambiarse de Website Payments Standard a Pasarela integral

88

Gua de Integracin de Pasarela integral

C
TABLA C.1 Cdigo de error 10001

Mensajes de error

La tabla siguiente muestra cdigos de error y la accin correctiva correspondiente.


Cdigos de error y acciones correctivas correspondientes Mensaje de error El pago no puede procesarse en este momento. Intntelo de nuevo ms tarde. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. Su tarjeta de crdito ha caducado. Pague con una tarjeta vlida. Introduzca un cdigo de seguridad de tarjeta vlido. Accin correctiva Intntelo de nuevo ms tarde.

10004

Hay un problema con su integracin. Compruebe los parmetros que ha proporcionado.

10009

Intntelo de nuevo ms tarde.

10010

Proporcione un Id. de factura vlido.

10413

Subtotal, envo, manipulacin e impuestos. Revise los totales en su integracin.

10500

No ha aceptado el acuerdo de pagos.

10501

El acuerdo de pagos est desactivado o inactivo.

10502

La tarjeta de crdito utilizada ha caducado.

10504

El CVV proporcionado no es vlido. El CVV debe tener de 3 a 4 dgitos.

Gua de Integracin de Pasarela integral

89

Mensajes de error

TABLA C.1

Cdigos de error y acciones correctivas correspondientes(Continuacin) Mensaje de error El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. Introduzca una fecha de caducidad de tarjeta vlida. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. Introduzca un nombre. Introduzca un apellido. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse en este momento. Intntelo de nuevo ms tarde. Introduzca un importe vlido. Introduzca un nmero de tarjeta vlido. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. Introduzca un nmero de tarjeta de crdito vlido. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. Accin correctiva Su cuenta PayPal est restringida. Pngase en contacto con PayPal con este cdigo de error.

Cdigo de error 10507

10508 10509

La fecha de caducidad debe tener el formato correcto. PayPal no ha podido determinar la direccin IP del comprador.

10511

Revise la integracin para asegurarse de que se proporciona un valor vlido para PaymentAction.

10512 10513 10520

El nombre de pila del comprador es obligatorio. El apellido del comprador es obligatorio. Los importes suministrados no coinciden.

10523

Intntelo de nuevo ms tarde.

10525 10527 10534

Verifique su integracin para asegurarse de que los importes no son iguales a cero. La tarjeta de crdito introducida no es vlida. PayPal tiene restringida actualmente la tarjeta de crdito introducida. Pngase en contacto con PayPal con este cdigo de error. La tarjeta de crdito introducida no es vlida. Todos los artculos del carro de la compra deben estar en la misma divisa.

10535 10536

90

Gua de Integracin de Pasarela integral

Mensajes de error

TABLA C.1

Cdigos de error y acciones correctivas correspondientes(Continuacin) Mensaje de error El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. Introduzca una direccin vlida. Introduzca un nmero de tarjeta de crdito vlido. introduzca una direccin de correo electrnico vlida. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pague con otra tarjeta de crdito. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. Accin correctiva El filtro de pases administrado por el vendedor ha rechazado la transaccin. Para aceptar esta transaccin, cambie la configuracin de riesgos en PayPal. PayPal ha rechazado la transaccin debido a una direccin no vlida. El comprador debe proporcionar la direccin correcta. PayPal tiene restringida actualmente la tarjeta de crdito introducida. Pngase en contacto con PayPal con este cdigo de error. La direccin de correo electrnico no tiene el formato correcto. El comprador debe proporcionar una direccin de correo electrnico con formato correcto. PayPal ha rechazado la transaccin. Pngase en contacto con PayPal con este cdigo de error.

Cdigo de error 10539

10540

10541

10542

10544

10545

PayPal ha rechazado la transaccin por posible actividad fraudulenta. Pngase en contacto con PayPal con este cdigo de error. PayPal ha rechazado la transaccin por posible actividad fraudulenta en la direccin IP. Pngase en contacto con PayPal con este cdigo de error. Ninguna: es un error interno de PayPal.

10546

10547

10548

La cuenta de vendedor que est intentando realizar la transaccin no es una cuenta PayPal Business. Compruebe la configuracin de la cuenta. La cuenta de vendedor que est intentando realizar la transaccin no puede procesar transacciones de cargo en cuenta bancaria. Pngase en contacto con PayPal con este cdigo de error. Se ha desactivado el acceso a cargos en cuenta bancaria para su cuenta. Pngase en contacto con PayPal con este cdigo de error.

10549

10550

Gua de Integracin de Pasarela integral

91

Mensajes de error

TABLA C.1

Cdigos de error y acciones correctivas correspondientes(Continuacin) Mensaje de error El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. Introduzca una direccin de facturacin completa. Introduzca un ao vlido para la fecha de caducidad de la tarjeta de crdito Introduzca un mes vlido para la fecha de caducidad de la tarjeta de crdito El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pague con otro tipo de tarjeta. El pago no puede procesarse. Pague con otra tarjeta de crdito. Introduzca un nombre vlido para la direccin de facturacin. Accin correctiva La cuenta de vendedor que est intentando realizar la transaccin no tiene una direccin de correo electrnico confirmada con PayPal. Compruebe la configuracin de la cuenta. El vendedor ha intentado realizar una transaccin en la que el importe superaba el lmite superior para ese vendedor. Compruebe sus preferencias de recepcin de pagos. Pngase en contacto con PayPal si necesita ms ayuda.

Cdigo de error 10552

10553

10557

10558

No se pueden realizar cargos en la tarjeta de crdito suministrada en la divisa solicitada.

10561 10562

El comprador debe introducir la direccin de facturacin completa. El comprador debe introducir un ao vlido para la caducidad de la tarjeta. El comprador debe introducir un mes vlido para la caducidad de la tarjeta. Se ha detectado una transaccin duplicada; recomiende al comprador que lo intente ms tarde.

10563

10564

10565

No se admite el pas del vendedor.

10566

No se admite el tipo de tarjeta de crdito.

10570

La tarjeta de crdito suministrada no admite la "autorizacin". El comprador debe introducir un nombre vlido en la direccin de facturacin.

10701

92

Gua de Integracin de Pasarela integral

Mensajes de error

TABLA C.1

Cdigos de error y acciones correctivas correspondientes(Continuacin) Mensaje de error Introduzca una direccin vlida en la lnea 1 de la direccin de facturacin. Introduzca una direccin vlida en la lnea 2 de la direccin de facturacin. Introduzca una ciudad vlida en la direccin de facturacin. Introduzca un estado vlido en la direccin de facturacin. Introduzca un cdigo postal vlido en la direccin de facturacin. Introduzca un pas vlido en la direccin de facturacin. Introduzca una direccin de facturacin completa. Introduzca una direccin en la lnea 1 de la direccin de facturacin. Introduzca una ciudad en la direccin de facturacin. Introduzca un estado en la direccin de facturacin. Introduzca un cdigo postal vlido en la direccin de facturacin. Introduzca un pas en la direccin de facturacin. Introduzca un nombre vlido en la direccin de facturacin. Introduzca un estado vlido en la direccin de facturacin. Accin correctiva El comprador debe introducir una direccin vlida en la lnea 1 de la direccin de facturacin. El comprador debe introducir una direccin vlida en la lnea 2 de la direccin de facturacin. El comprador debe introducir un estado vlido en la direccin de facturacin. El comprador debe introducir un estado vlido en la direccin de facturacin. El comprador debe introducir un cdigo postal vlido en la direccin de facturacin. El comprador debe introducir un pas vlido en la direccin de facturacin. El comprador debe introducir la direccin de facturacin completa. El comprador debe introducir una direccin en la lnea 1 de la direccin de facturacin. El comprador debe introducir una ciudad en la direccin de facturacin. El comprador debe introducir un estado en la direccin de facturacin. El comprador debe introducir un cdigo postal vlido en la direccin de facturacin. El comprador debe introducir un pas en la direccin de facturacin. El comprador debe introducir un nombre vlido en la direccin de facturacin. El comprador debe introducir un estado vlido en la direccin de facturacin.

Cdigo de error 10702

10703

10704

10705

10706

10707 10708 10709

10710 10711 10712

10713 10714

10715

Gua de Integracin de Pasarela integral

93

Mensajes de error

TABLA C.1

Cdigos de error y acciones correctivas correspondientes(Continuacin) Mensaje de error Introduzca un cdigo postal vlido en la direccin de facturacin. Introduzca un cdigo postal vlido en la direccin de facturacin. Introduzca una ciudad vlida en la direccin de facturacin. Introduzca un nombre de destinatario vlido en la direccin de envo. Introduzca una direccin vlida en la lnea 1 de la direccin de envo. Introduzca una direccin vlida en la lnea 2 de la direccin de envo. Introduzca una ciudad vlida en la direccin de envo. Introduzca un estado vlido en la direccin de envo. Introduzca un cdigo postal vlido en la direccin de envo. Introduzca un pas vlido en la direccin de envo. Introduzca una direccin de envo completa. Introduzca una direccin en la lnea 1 de la direccin de envo. Introduzca una ciudad en la direccin de envo. Introduzca un estado en la direccin de envo. Introduzca un cdigo postal en la direccin de envo. Accin correctiva El comprador debe introducir un cdigo postal vlido en la direccin de facturacin. El comprador debe introducir un cdigo postal vlido en la direccin de facturacin. El comprador debe introducir una ciudad vlida.

Cdigo de error 10716

10717

10718

10719

El comprador debe introducir un nombre de destinatario vlido para la direccin de envo. El comprador debe introducir una direccin vlida en la lnea 1 de la direccin de envo. El comprador debe introducir una direccin vlida en la lnea 2 de la direccin de envo. El comprador debe introducir una ciudad vlida en la direccin de envo. El comprador debe introducir un estado vlido en la direccin de envo. El comprador debe introducir un cdigo postal vlido en la direccin de envo. El comprador debe introducir un pas vlido en la direccin de envo. El comprador debe introducir una direccin de envo completa. El comprador debe introducir una direccin 1 en la direccin de envo. El comprador debe introducir una ciudad en la direccin de envo. El comprador debe introducir un estado en la direccin de envo. El comprador debe introducir un cdigo postal vlido en la direccin de envo.

10720

10721

10722 10723 10724

10725 10726 10727

10728 10729 10730

94

Gua de Integracin de Pasarela integral

Mensajes de error

TABLA C.1

Cdigos de error y acciones correctivas correspondientes(Continuacin) Mensaje de error Introduzca un pas en la direccin de envo. Introduzca un nombre de destinatario vlido en la direccin de envo. Introduzca un estado vlido en la direccin de envo. Introduzca un cdigo postal vlido en la direccin de envo. Introduzca un cdigo postal vlido en la direccin de envo. Introduzca una ciudad y un estado vlidos en la direccin de envo. Introduzca un pas vlido en la direccin de facturacin. Introduzca un pas vlido en la direccin de envo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. Introduzca un cdigo de seguridad de la tarjeta. Introduzca un estado vlido en la direccin de envo. Introduzca un estado vlido en la direccin de facturacin. El pago no puede procesarse. Pague con otra tarjeta. Accin correctiva El comprador debe introducir un pas en la direccin de envo. El comprador debe introducir un estado vlido en la direccin de envo. El comprador debe introducir un estado vlido en la direccin de envo. El comprador debe introducir un cdigo postal vlido en la direccin de envo. El comprador debe introducir un cdigo postal vlido en la direccin de envo. El comprador debe introducir una ciudad y un estado vlidos en la direccin de envo. El comprador debe introducir un pas vlido en la direccin de facturacin. El comprador debe introducir un pas vlido en la direccin de envo. No se admite la tarjeta de crdito de este pas.

Cdigo de error 10731 10732

10733 10734

10735

10736

10744 10745 10746

10747

Pngase en contacto con PayPal con este cdigo de error.

10748 10750 10751

El comprador debe introducir un cdigo de seguridad de la tarjeta. El comprador debe introducir un estado vlido en la direccin de envo. El comprador debe introducir un estado vlido en la direccin de facturacin. La transaccin la ha rechazado el banco emisor, no PayPal. El comprador debe probar con otra tarjeta.

10752

Gua de Integracin de Pasarela integral

95

Mensajes de error

TABLA C.1

Cdigos de error y acciones correctivas correspondientes(Continuacin) Mensaje de error El pago no puede procesarse. Pague con otra tarjeta. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pague con otra tarjeta. El pago no puede procesarse. Pague con otra tarjeta. No se puede procesar el pago porque esta transaccin parece ser un duplicado de una transaccin reciente. El pago no puede procesarse. Pague con otra tarjeta. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. Introduzca la fecha en que la tarjeta de crdito empez a ser vlida. El pago no puede procesarse. Pague con otra tarjeta. El pago no puede procesarse. Pague con otra tarjeta. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. Introduzca un cdigo de seguridad de tarjeta vlido. Accin correctiva El comprador debe utilizar otra tarjeta de crdito. Revise su integracin para asegurarse de que se admite el cdigo de divisa.

Cdigo de error 10754 10755

10756 10759 10761

El comprador debe utilizar otra tarjeta de crdito. PayPal ha rechazado la transaccin. Pngase en contacto con PayPal con este cdigo de error. La transaccin se ha rechazado porque PayPal est procesando una transaccin con el mismo vendedor y por el mismo importe. Este error puede producirse cuando un comprador enva varias transacciones idnticas en una sucesin rpida. Demasiados fallos de CVV en la tarjeta de crdito. El comprador debe probar con otra tarjeta. Ninguna: es un error interno de PayPal.

10762 10763

10764

PayPal ha rechazado la transaccin. Pngase en contacto con PayPal con este cdigo de error.

11998

El comprador debe proporcionar la fecha de inicio correcta para la tarjeta de crdito. PayPal ha rechazado la transaccin porque esta tarjeta ha tenido demasiados errores en poco tiempo. Pngase en contacto con PayPal con este cdigo de error. PayPal ha rechazado la transaccin. Pngase en contacto con PayPal con este cdigo de error. Se ha rechazado la transaccin porque el vendedor no tiene en el sistema un acuerdo de entidad comercial vlido con PayPal. Pngase en contacto con PayPal con este cdigo de error. La transaccin se ha rechazado porque el CVV introducido no coincide con la tarjeta de crdito.

15001

15002 15003

15004

96

Gua de Integracin de Pasarela integral

Mensajes de error

TABLA C.1

Cdigos de error y acciones correctivas correspondientes(Continuacin) Mensaje de error El pago no puede procesarse. Pague con otra tarjeta. Introduzca un nmero de tarjeta vlido. Su tarjeta ha caducado. Pague con una tarjeta vlida. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. El pago no puede procesarse. Pngase en contacto directamente con el vendedor con este cdigo. Accin correctiva La transaccin la ha rechazado el banco emisor, no PayPal. El comprador debe probar con otra tarjeta. La transaccin la ha rechazado el banco emisor, no PayPal. El comprador debe probar con otra tarjeta. Esta transaccin la ha rechazado el emisor de la tarjeta porque la tarjeta ha caducado. El comprador debe probar con otra tarjeta. Revise su integracin para asegurarse de que los totales coinciden.

Cdigo de error 15005 15006 15007

15008

15009

Hay una falta de coincidencia en el cdigo de divisa. Pngase en contacto con PayPal con este cdigo de error. Los datos de la tarjeta de crdito introducida no son vlidos. Pngase en contacto con PayPal con este cdigo de error.

99998

Gua de Integracin de Pasarela integral

97

Mensajes de error

98

Gua de Integracin de Pasarela integral

D
AUD CAD CHF CZK DKK EUR GBP HKD HUF JPY NOK NZD PLN SEK SGD USD

Cdigos de divisa

La tabla siguiente muestra todas las divisas admitidas por PayPal.


TABLA D.1 Cdigo de divisa Cdigos de divisa Nombre de pas Dlar australiano Dlar canadiense Franco suizo Corona checa Corona danesa Euro Libra esterlina Dlar de Hong Kong Forint hngaro Yen japons Corona noruega Dlar de Nueva Zelanda Zloty polaco Corona sueca Dlar de Singapur Dlar estadounidense

Gua de Integracin de Pasarela integral

99

Cdigos de divisa

100

Gua de Integracin de Pasarela integral

ndice

A
address_override 19 address1 19 address2 19 alojamiento de botones 41 botones de cdigo personal 41 botones de texto sin encriptar 41 botones encriptados 41 API integracin 41 API BMCreateButton 41 API de administrador de botones 41 API DoCapture 78 API GetTransactionDetails 66, 67 API RefundTransaction 77

C
Campos de respuesta de BMCreateButton 48 Campos de solicitud de BMCreateButton 47 cancel_return 20 cbt 20 certificado pblico carga 53 descarga 55 eliminacin 55 generacin 53 city 20 clave privada 45 clave pblica 45 claves privadas 52 generacin 53 claves pblicas 52 CLEARTEXT 41, 43, 44 cdigos de divisa 99 columna de resumen del pedido 32 configuracin 25 country 20 cpp_header_image 33 cuenta preconfigurada 59 Cumplimiento de PCI 9 currency_code 20 custom 20

B
billing_address1 19 billing_address2 19 billing_city 19 billing_country 19 billing_first_name 19 billing_last_name 19 billing_state 19 billing_zip 19 bn 19 bodyBgColor 33 bodyBgImg 33 botn 32 botones de cdigo personal 41 botones de texto sin encriptar 41 botones encriptados 41 business 19 BUTTONCODE 47 BUTTONCODE=CLEARTEXT 41 BUTTONCODE=ENCRYPTED 41 BUTTONCODE=HOSTED 41 BUTTONCODE=TOKEN 41 BUTTONTYPE 47 BUTTONTYPE=PAYMENT 41 buyer_email 19

D
descripcin general 9

E
EMAILLINK 37, 42, 48 encabezado 32 encriptacin 45 ENCRYPTED 41, 43, 44 Errores de BMCreateButton 49 estado de la transaccin 65

Octubre 2010

101

ndice

F
first_name 20 fondo 32 footerTextColor 33

METHOD 47 modificacin de la configuracin de la cuenta 23

N
night_phone_a 20 night_phone_b 20 night_phone_c 21 Notificacin de pago instantnea (IPN) 65 notify_url 21

G
guardar y publicar 28

H
handling 20 headerBgColor 33 headerHeight 33 HOSTED 41 HOSTEDBUTTONID 48 HTML integracin 17

O
Opciones de idioma de botn 47 Operacin de API BMCreateButton 46 operaciones de API opcionales 67 orderSummaryBgColor 33 orderSummaryBgImage 33 OutputFile 57

I
iFrames 35 integracin de API 37 InputFile 57 integracin de API 41 integracin HTML 17 Integracin manual de iFrames 36 integracin sencilla 17 invoice 20 item_name 20

P
pageButtonBgColor 33 pageButtonTextColor 33 pageTitleTextColor 34 paymentaction 21 personalizacin de la plantilla 32 personalizacin de su pgina de pago 23 Plantilla A 29 Plantilla B 30 Plantilla C 31 PPCertFile 56 procesamiento de pedidos 65 proceso de encriptacin 52 Proteccin del vendedor 9, 12 prueba de la integracin 59

L
L_BUTTONVAR 47 last_name 20 lc 20 logoFont 33 logoFontColor 33 logoFontSize 33 logoImage 33 logoImagePosition 33 logoText 33

R
Respuesta de BMCreateButton 48 return 21

S M
mensajes de error 89 sectionBorder 34 shipping 21

102

Octubre 2010

ndice

showBillingAddress 34 showBillingEmail 34 showBillingPhone 34 showCustomerName 34 showHostedThankyouPage 34 showShippingAddress 34 Solicitud de BMCreateButton 46 state 21 subheaderText 34 subtotal 21

T
tax 21 template 34 ttulo 32 TOKEN 41, 42, 44

V
variables HTTP 19, 33 versin anterior 28 vista previa 28

W
WEBSITECODE 38, 43, 48

Z
zip 21

Octubre 2010

103