Integration Types
Otras características
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
PayPal es un método de pago mediante explorador compatible en Mastercard Gateway. En esta página se describen los detalles de integración específicos la API de NVP con PayPal, incluido el modo de configurar su cuenta comercial PayPal para aceptar pagos mediante el motor de pagos, los requisitos de marca, etc. Le recomendamos leer las pautas de integración para los pagos mediante explorador, antes de crear una integración de PayPal.
Para usar PayPal como método de pago a través del motor de pagos, usted debe tener una cuenta comercial PayPal configurada para el motor de pagos. Para obtener detalles, consulte Configurar su cuenta comercial PayPal.
Para registrarse en una cuenta comercial PayPal, haga clic aquí.
Si tiene una integración de Hosted Checkout existente, PayPal estará disponible en forma automática una vez que su proveedor de servicios de pago haya configurado correctamente el vínculo del adquirente para PayPal.
Para conocer más detalles, consulte Pagos mediante explorador a través de la integración de Hosted Checkout.
Elija la integración de Direct Payment si desea ofrecer el método de pago de PayPal en su propia página de pago.
Usted puede elegir el flujo de pago más adecuado para el sitio de su tienda.
PayPal permite que sus pagadores realicen pagos en forma rápida y segura en el sitio de su tienda, lo que les permite usar su cuenta PayPal para pagos y opcionalmente proporcionar información de envío en el sitio de la tienda. Con PayPal, los pagadores comienzan y terminan el proceso de pagos en el sitio de su tienda. Los pagadores solo necesitan iniciar sesión en su cuenta PayPal y confirmar su dirección de envío y método de pago. El sitio de la tienda después puede recuperar la información de envío.
El motor de pagos admite dos tipos de flujos de pagos de PayPal: Acceso directo y Lineal.
El flujo de acceso directo le permite redirigir al pagador desde el sitio de la tienda al sitio Web de PayPal al utilizar el botón “Pago con PayPal’, que se ubica en la página de revisión de tarjetas del sitio de la tienda. El pagador se salta el flujo de pago normal y hace el pago usando la información almacenada en su cuenta PayPal. PayPal proporciona el nombre, la dirección de correo electrónico y la dirección de envío de la cuenta bancaria del pagador de vuelta al sitio de la tienda, lo que permite un pago más rápido al saltarse el ingreso de esta información en el sitio de la tienda.
El flujo lineal le permite al pagador continuar a través del flujo de pago normal, al ingresar su información de facturación y envío en el sitio de la tienda. Cuando se le indica al pagador que elija su método de pago, el pagador elige la opción PayPal ubicada en la página de facturación del sitio de la tienda junto a otras opciones de pago. A diferencia de la transacción de acceso directo, el sitio de la tienda proporciona la dirección de envío del pagador a PayPal.
Con los flujos de pago de Acceso directo y Lineal, usted puede elegir la visualización del botón "Pagar ahora" o el botón "Continuar" en el sitio web de PayPal.
El botón "Pagar ahora" permite que el pagador confirme el pago en el sitio web de PayPal antes de ser redirigido de vuelta al sitio de su tienda. Esta opción le permite proporcionar una experiencia de pago más rápida al pagador cuando el pagador completa el pago en el sitio web de PayPal.
El botón "Continuar" permite redirigir al pagador al sitio de su tienda para confirmar el pago después de ver todos los detalles del pedido. Esta opción le permite cambiar el pedido, si es necesario, antes de aceptar el pago (por ejemplo: al agregar cargos de transporte y envío basados en la dirección devuelta desde PayPal). Usted también puede incluir otros pasos de pago, por ejemplo: promover ventas en su página Confirmar pedido.
Consulte Confirmación de pago a continuación para obtener detalles acerca de cómo implementar esto en su integración de PayPal.
Dependiendo del flujo de pago, Lineal o Acceso directo, usted puede elegir la recopilación de la dirección de envío del pagador en el sitio de su tienda o el sitio web de PayPal, respectivamente. Por defecto, PayPal recopila la dirección de envío del pagador desde el sitio web de PayPal. El pagador puede agregar o editar dicha dirección si es necesario. Usted puede elegir no mostrar la dirección de envío y/o inhabilitar ediciones. Consulte Mostrar/Anular dirección de envío a continuación para obtener información acerca de cómo implementar esto en su integración de PayPal.
A continuación, el ejemplo describe el flujo de Acceso directo en que el pagador utiliza la dirección de envío como se almacenó en PayPal. El pagador revisa y confirma el pago en el sitio de la tienda del negocio.
El flujo de pago es de la siguiente manera:
Initiate Browser Payment
al motor de pagos y redirige al pagador a la URL incluida en la respuesta.Retrieve Transaction
. Confirm Browser Payment
al motor de pagos.Referencia de API de Initiate Browser Payment [REST][NVP]
La integración de Direct Payment le permite ofrecer el método de pago de PayPal en su propia página de pago.
Los siguientes campos en la solicitud de Initiate Browser Payment
son específicos para PayPal o tienen uso específico en la integración de PayPal. Para conocer otros detalles, consulte Pagos mediante explorador a través de la integración de Direct Payment.
sourceOfFunds.type = PAYPAL
browserPayment.operation
= Authorize
o Pay
Con PayPal, la autorización vence dentro de 3 días desde la fecha en que ocurrió la autorización. Si aún desea capturar los fondos después del vencimiento de la autorización, puede utilizar la operación Update Authorization.
browserPayment.paypal.paymentConfirmation
Cuando inicie un pago con PayPal, debe especificar si desea que el pagador confirme el pago en el sitio web de PayPal o en el sitio de su tienda.
Referencia de API de campo Confirmación de pago [REST][NVP]
Si confirma con el proveedor (PayPal), el sitio web de PayPal muestra el botón "Pagar ahora", lo que permite que el pagador confirme el pago en el sitio web de PayPal antes de ser redirigido al sitio de su tienda. Debe enviar una solicitud de Retrieve Transaction
al motor de pagos para determinar el éxito o fracaso del pago.
Si confirma en el sitio de la tienda, el sitio web de PayPal muestra el botón "Continuar", lo que permite que el pagador sea redirigido al sitio de su tienda donde el pagador puede confirmar el pago. Debe enviar una solicitud de Retrieve Transaction
al motor de pagos para recuperar los detalles y ver si el pagador ha continuado o no con el pago. Si el pagador continúa con el pago en el sitio de su tienda, debe enviar una llamada de Confirm Browser Payment
para confirmar el pago con PayPal. La respuesta de Confirm Browser Payment
incluirá información sobre el éxito o fracaso del pago.
Referencia de API de Confirm Browser Payment [REST][NVP]
En ambos casos, si el pago es exitoso, la operación Retrieve Transaction devuelve:
Usted puede administrar la forma en que el pagador le proporciona la dirección de envío al usar dos campos:
browserPayment.paypal.displayShippingAddress
: cuando se configura como verdadero (predeterminado), la dirección de envío se muestra en el sitio web de PayPal.
Referencia de API de campo Mostrar dirección de envío [REST][NVP]
browserPayment.paypal.overrideShippingAddress
: cuando se configura como verdadero (predeterminado), el pagador puede cambiar la dirección de envío en el sitio web de PayPal.
Referencia de API de campo Anular dirección de envío [REST][NVP]
Por defecto, PayPal recopila por usted la dirección de envío del pagador en el sitio web de PayPal. Si elige recopilar la dirección de envío del pagador en el sitio de su tienda y no desea que PayPal muestre la dirección de envío al pagador, debe configurar como falsa la opción browserPayment.paypal.displayShippingAddress
. Esto también se aplica cuando no se requiere la dirección de envío en un pedido (por ejemplo, cuando solo se trata de productos digitales).
El motor de pagos siempre devolverá la dirección de envío en la respuesta de Retrieve Transaction
si se proporcionó la dirección en la solicitud de Initiate Browser Payment
o si la opción browserPayment.paypal.displayShippingAddress
está configurada como verdadera.
Consulte la tabla a continuación para conocer varios escenarios que se pueden aplicar a su integración. Puede elegir un escenario diferente para cada pago.
Initiate Browser Payment | Sitio web de PayPal | ||||||
---|---|---|---|---|---|---|---|
Mostrar dirección de envío | Anular dirección de envío | ¿Se requiere la dirección de envío? | ¿Se proporcionó la dirección de envío? | ¿La dirección de envío es válida? | ¿Se muestra la dirección de envío al pagador? | Origen de la dirección de envío visualizada | ¿El pagador puede cambiar la dirección de envío? |
verdadero (predeterminado) | verdadero (predeterminado) | opcional | no | no aplica | sí | PayPal recopila la dirección de envío. | sí |
verdadero (predeterminado) | verdadero (predeterminado) | opcional | sí | sí | sí | PayPal muestra la dirección de envío que usted proporciona en la solicitud en el sitio web de PayPal. | sí |
verdadero (predeterminado) | verdadero (predeterminado) | opcional | sí | no | sí | PayPal ignora la dirección de envío que usted proporciona en la solicitud, en vez de eso, recopila la dirección de envío en el sitio web de PayPal. | sí |
verdadero (predeterminado) | falso | obligatorio | sí | sí | sí | PayPal muestra la dirección de envío que usted proporciona en la solicitud en el sitio web de PayPal. | no |
verdadero (predeterminado) | falso | obligatorio | sí | no | no | PayPal rechaza la solicitud. | No corresponde |
falso | No corresponde | No corresponde | sí | sí | no | PayPal ignora la dirección de envío que usted proporciona en la solicitud. | no |
falso | No corresponde | No corresponde | No corresponde | No corresponde | no | PayPal no tiene una dirección de envío para mostrar. | No corresponde |
Es posible especificar los detalles de producto de línea en la solicitud de Initiate Browser Payment
para proporcionar todos los detalles del pedido a los pagadores antes de que ellos confirmen el pago. La investigación sobre consumidores muestra que existen más compradores que completan sus compras cuando ven los productos individuales y otros detalles de un pedido durante un pago con PayPal. Por consiguiente, se le recomienda que proporcione la información del pedido cuando inicie el pago con PayPal para motivar a los pagadores a que continúen con el pago en vez de abandonarlo.
Los productos de línea se consideran como proporcionados si se especifica el nombre o el precio unitario del producto.
Para obtener más información sobre los detalles de producto de línea, consulte Datos de producto de línea.
La tabla siguiente muestra los códigos de respuesta de transacción para los posibles escenarios que puede encontrar después de iniciar un pago mediante explorador.
Respuesta de Initiate Browser Payment |
Qué significa esto... |
---|---|
response.gatewayCode=SUBMITTED result=SUCCESS |
Redirigir al pagador utilizando la URL proporcionada en la respuesta. |
response.gatewayCode=SUBMITTED result=FAILURE or PENDING or UNKNOWN |
Envíe otra solicitud de INITIATE_BROWSER_PAYMENT . |
Respuesta de Retrieve Transaction/Retrieve Order |
Qué significa esto... |
response.gatewayCode=APPROVED result=SUCCESS |
El pago se realizó correctamente. |
response.gatewayCode= PENDING result=PENDING |
El pago tiene una revisión pendiente en el sistema de PayPal. El motor de pagos actualizará el estado del pago tan pronto como el sistema PayPal informe al motor de pagos sobre el resultado de la revisión. Consulte Pagos pendientes. |
response.gatewayCode= CANCELLED result=FAILURE |
El pagador canceló la interacción para este pago. Ofrezca al pagador la opción de probar otro método de pago. |
response.gatewayCode= DECLINED or INSUFFICIENT_FUNDS or NOT_SUPPORTED result=FAILURE |
El pago fue rechazado por PayPal. |
response.gatewayCode= ACQUIRER_SYSTEM_ERROR result=FAILURE |
El adquirente no pudo procesar la transacción. Puede consultar con el adquirente el motivo del error del pago, o bien puede intentar RETRIEVE_TRANSACTION de nuevo. También, puede ofrecer al pagador la opción de probar otro método de pago. |
response.gatewayCode= SYSTEM_ERROR result=FAILURE |
El motor de pagos no pudo procesar la transacción. |
response.gatewayCode=TIMED_OUT result=FAILURE |
La interacción entre el pagador y el sistema de PayPal no se completó correctamente, por ejemplo, el motor de pagos no recibió una redirección del navegador del pagador proveniente del negocio en un plazo de 24 horas, o bien el motor de pagos no pudo recuperar los detalles de la interacción entre el pagador y el sistema de PayPal, por ende el pago quedó incompleto. |
response.gatewayCode=UNKNOWN result=UNKNOWN |
El motor de pagos no pudo averiguar si el pago se realizó correctamente o no. |
En algunos casos, el motor de pagos puede devolver el estado de PENDIENTE en la respuesta de transacción. Por ejemplo, si la transacción actualmente está bajo evaluación de riesgos en PayPal. Si el estado es pendiente y usted configuró sus propios filtros de administración de fraudes, debería iniciar sesión en su cuenta comercial PayPal y revisar el pago.
Cuando PayPal actualice el estado de una transacción pendiente, se lo notificará al motor de pagos. Puede recuperar el resultado de la transacción actualizada con la operación Retrieve Transaction
.
El motor de pagos considera una transacción PENDIENTE como exitosa hasta que se recibe una notificación que indique el éxito o fracaso de la transacción. El total de pedidos (montos totales autorizados/capturados/reembolsados) se actualizan tomando en cuenta las transacciones pendientes. Si se rechaza la transacción, se revocan las actualizaciones.
Puede reembolsar los pagos procesados a través de PayPal, en parte, por completo o en exceso. Sin embargo, tenga en cuenta que el monto del reembolso solo se aplica a la operación Capture específica que desea reembolsar y no al monto total autorizado. Por ejemplo, si a la autorización de 100 USD le siguen dos capturas parciales de 30 USD (Captura 1) y 70 USD (Captura 2), entonces a cualquier monto reembolsado en este pedido, en parte, por completo o en exceso, se aplica de forma individual en la Captura 1 o en la Captura 2 y no en el monto total del pedido de 100 USD. Esto quiere decir que un reembolso de 50 USD en la Captura 1 y en la Captura 2 se considera excesivo y parcial, respectivamente.
Esta sección le ayuda a configurar sus páginas de pagos con el fin de cumplir con los requisitos de marca de PayPal.
Cuando usted ofrece PayPal como un método de pago a sus pagadores, es importante que se asegure de que la experiencia de pago del pagador cumpla o supere las mejores prácticas de los estándares de implementación de pagos descritas por PayPal.
Para proporcionar una experiencia sin contratiempos a sus pagadores, el motor de pagos recomienda personalizar sus páginas de pago de PayPal. Para realizar esto:
Para obtener pautas acerca de cómo presentar los elementos de interfaz de usuario en sus páginas de pago, consulte la Guía de estándares de interfaz de usuario para pagos rápidos en el sitio web de PayPal.
Esta sección describe cómo configurar su cuenta comercial PayPal para trabajar con la integración del motor de pagos.
Para procesar transacciones a través de PayPal, se deben otorgar permisos al motor de pagos para llamadas de API específicas que el motor de pagos debe realizar en su nombre.
Para realizar esto:
Debe proporcionar la dirección de correo electrónico de su cuenta comercial PayPal a su proveedor de servicios de pago.
Con estos detalles, su proveedor de servicios de pago completará la configuración. Una vez que se complete su integración con el motor de pagos para PayPal, puede iniciar un pago mediante explorador con PAYPAL como tipo de pago. Según la integración, es posible que deba proporcionar algunos campos específicos para PayPal, los que se indican en la siguiente sección.
El motor de pagos proporciona un Emulador de PayPal, que le permite probar su integración para usar la funcionalidad de PayPal a través del motor de pagos.