Pagos con PayPal

PayPal es un método de pago mediante explorador compatible en Mastercard Payment Gateway. En esta página se describen los detalles de integración específicos de 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.

Si está integrado para usar PayPal antes de la versión 50 de API, haga clic aquí.

Prerrequisitos

Para usar PayPal como método de pago a través de Mastercard Payment Gateway, 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í.

Experiencia de pago de PayPal

Las siguientes secciones le ayudarán a elegir la experiencia de pago de PayPal que sea más adecuada para su sitio.

{
   "apiOperation":"INITIATE_BROWSER_PAYMENT",
   "browserPayment":{
      "operation":"AUTHORIZE",
      "paypal":{
         "paymentConfirmation":"CONFIRM_AT_MERCHANT"
      },
      "returnUrl":"Https://test.com"
   },
   "order":{
      "amount":"4.20",
      "currency":"USD"
   },
   "sourceOfFunds":{
      "type":"PAYPAL"
   }
}
        

{
   "apiOperation":"INITIATE_BROWSER_PAYMENT",
   "browserPayment":{
      "operation":"PAY",
      "paypal":{
         "paymentConfirmation":"CONFIRM_AT_PROVIDER"
      },
      "returnUrl":"Https://test.com"
   },
   "order":{
      "amount":"4.20",
      "currency":"USD"
   },
   "sourceOfFunds":{
      "type":"PAYPAL"
   }
}
        

Integración de PayPal

PayPal como opción de pago en Hosted Checkout

Si utiliza la página de pago de Mastercard Payment Gateway (Hosted Checkout), se ofrecerá automáticamente PayPal como opción de pago a sus pagadores si your payment service provider ha configurado el vínculo de adquirente de PayPal en su perfil de negocio. Para conocer más detalles, consulte Pagos mediante explorador a través de la integración de Hosted Checkout.

PayPal como opción de pago en su página de pago

Puede agregar PayPal como opción de pago en su página de pago si está integrado a la versión 50 o superior de la API. Debe enviar la solicitud Initiate Browser Payment desde su aplicación del lado del servidor para iniciar la interacción de PayPal.

Se redirige al pagador desde su sitio a PayPal para que inicie sesión y complete los detalles del pago. Para obtener más detalles, consulte PayPal por medio de Direct Payment.

PayPal por medio de Direct Payment

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 obtener más detalles, consulte Pagos mediante explorador por medio de integración de Direct Payment.

• sourceOfFunds.type = PAYPAL
• browserPayment.operation = AUTHORIZE o PAY
  

  Con PayPal, los fondos se pueden mantener durante 3 días (período de tramitación) 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 de 3 días, puede utilizar la operación Update Authorization o iniciar por medio de Merchant Administration.

  Por defecto, su cuenta de negocio de PayPal se configura solo para capturas simples. Si desea cambiar la configuración para respaldar varias capturas, contáctese con PayPal.

  Referencia de API de campo Operación [REST][NVP]

• browserPayment.paypal.paymentConfirmation

  Cuando inicie un pago con PayPal, debe especificar si desea que el pagador confirme el pago en PayPal o en su sitio.

  Referencia de API de campo Confirmación de pago [REST][NVP]

  Si confirma con el proveedor (PayPal), PayPal muestra el botón "Pagar ahora", lo que permite que el pagador confirme el pago en PayPal antes de ser redirigido a su sitio. Debe enviar una solicitud de Retrieve Transaction a Mastercard Payment Gateway para determinar si el pago se ha realizado correctamente o no.

  Si confirma en su sitio, PayPal muestra el botón "Continuar", lo que permite que el pagador sea redirigido a su sitio 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 su sitio, 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:

  • la dirección de correo electrónico de la cuenta PayPal del pagador;
  • el nombre del titular de la cuenta en la cuenta PayPal del pagador;
  • el ID del pagador asociado con la cuenta de PayPal del pagador;
  • los detalles de la dirección de envío.

  Solicitud de ejemplo

       {
          "apiOperation":"CONFIRM_BROWSER_PAYMENT",
          "order":{
             "amount":"4.20",
             "currency":"USD"
          }
       }
                

• Mostrar/Anular dirección de envío [Opcional]

  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 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 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 PayPal. Si elige recopilar la dirección de envío del pagador en su sitio 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.

  Debe usar la dirección de envío incluida en la respuesta de la transacción en el caso de que el pagador haya cambiado la dirección de envío en PayPal. Tenga en cuenta que PayPal valida la ciudad, el estado y las combinaciones de código postal para las direcciones de envío estadounidenses.
• Detalles de producto de línea [Opcional]

  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.

Cómo interpretar el resultado de la transacción

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.

Actualizaciones de autorización

Puede actualizar el período de tramitación de la autorización o aumentar los montos de autorización para transacciones de autorización de PayPal válidas, utilizando la operación Update Authorization o mediante Merchant Administration. Para esto, your payment service provider debe habilitar el privilegio "Update Authorization" en su perfil del negocio. Para obtener más información, consulte Update Authorization.

Se recomienda que actualice una autorización después de los 3 días iniciales (período de tramitación) para asegurarse de que los fondos sigan disponibles. Un pago reautorizado tiene un nuevo período de tramitación de 3 días. El período de tramitación de 3 días se puede actualizar como máximo dentro del período de validez de 29 días.

Se puede actualizar una autorización una vez para un máximo del 115 % o 75 USD del monto autorizado originalmente.

Capturas, reembolsos y anulaciones

Para los pagos con PayPal, puede capturar el monto autorizado de manera parcial o total del monto autorizado originalmente utilizando la operación Capture o por medio de Merchant Administration.

Puede reembolsar de manera parcial o total pagos procesados por medio de PayPal para transacciones Pay y Capture. Puede enviar solicitudes de reembolso utilizando la operación Refund o mediante Merchant Administration.

Puede anular cualquier transacción autorizada si los intentos de captura han fallado o puede reembolsar una transacción Pay para revertir el pago. Puede enviar la solicitud de Void o Refund utilizando la operación API, Void y Refund o a través de Merchant Administration.

Pagos pendientes

El motor de pagos puede devolver el estado de PENDIENTE en la respuesta de la 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.

Acuerdo de facturación y pagos recurrentes

Si utiliza Finalizar pedido con PayPal o Pagar con PayPal, puede configurar un acuerdo de facturación para un pagador, lo que permite iniciar una transacción de referencia (pagos por suscripción/recurrentes o a demanda) sobre este acuerdo de facturación sin consentimiento adicional del pagador. Para obtener más información, consulte Acuerdo de facturación y pagos recurrentes.

Configurar su integración de PayPal

Para procesar transacciones a través de PayPal, debe otorgar permiso al motor de pagos para enviar solicitudes de transacciones a PayPal en su nombre. Para otorgar permiso a terceros, debe iniciar sesión en el portal de Merchant Administration. En la página de configuración de PayPal, puede ver los vínculos de adquirente del negocio de PayPal que your payment service provider configuró para usted. Si no ha otorgado permiso al tercero en el vínculo de adquirente, el campo ID de cuenta permanece vacío. Por lo tanto, debe otorgar permiso al motor de pagos para que este pueda realizar llamadas de API en su nombre.

Mejor protección para el vendedor

Puede enviar datos adicionales del pagador en la solicitud Initiate Browser Payment y en las solicitudes Pay o Authorize posteriores, después de realizar el Tokenize Browser Payment para permitir que PayPal realice una evaluación de riesgos de la transacción antes de que esta se procese.

PayPal utiliza los datos de los siguientes campos para realizar una evaluación de la administración de riesgos previa a la transacción:

• device.fingerprint: identificador único para el dispositivo que se puede generar utilizando la biblioteca Javascript de PayPal FraudNet. Esto permite a PayPal realizar una evaluación de riesgos de la transacción.
• risk.custom: en este campo puede proporcionar datos adicionales sobre el pago. Debe tener un acuerdo con PayPal sobre los valores que desea proporcionar. Por ejemplo, risk.custom.headOfficeLocation=Londres RU.
• sourceOfFunds.token: el token que identifica los detalles del acuerdo de facturación (recibidos de PayPal) en el motor de pagos. Puede utilizar este ID de token para los pagos únicos y recurrentes. Para obtener más información, consulte Acuerdo de facturación y pagos recurrentes.
  Para el pago directo, la sourceOfFunds es Paypal.

Reembolso excesivo

Los reembolsos excesivos deben estar habilitados en el sitio de PayPal. Puede capturar el monto de exceso autorizado por medio de la solicitud Capture o por medio de Merchant Administration.

Se permite una captura en exceso de hasta el 115 % de la transacción autorizada original. Puede devolver de manera parcial o total los pagos en exceso procesados por medio de PayPal para las transacciones Pay y Capture.

Puede enviar solicitudes de reembolso utilizando la operación Refund o mediante Merchant Administration.

Para un reembolso excesivo, incluya un monto que supere el monto de la transacción original. Para reembolsar en exceso del monto capturado, asegúrese de estar habilitado para los reembolsos excesivos en su perfil de negocio de PayPal.

Si su perfil de PayPal está habilitado para los reembolsos excesivos, asegúrese de configurar su perfil de negocio de Mastercard Payment Gateway para dichos reembolsos.

Prueba de su integración

El Mastercard Payment Gateway proporciona un emulador de PayPal que permite probar su integración para usar la funcionalidad de PayPal a través del motor de pagos.