Ir a contenido
Crea una cuenta
 o
Inicia sesión
Logotipo de Stripe Docs
/
Crear una cuenta
Iniciar sesión
Resumen
Billing
ResumenAcerca de las API de facturación
Suscripciones
Impuesto
Resumen
Elaboración de informes
ResumenInformes para varias cuentas
Datos
ResumenEsquema

Configurar una suscripción con PayPal

Obtén información sobre cómo crear y cobrar una suscripción con PayPal y Checkout.

Usa esta guía para configurar una suscripción mediante PayPal y Checkout.

Una sesión de Checkout representa los datos de la intención de compra de un cliente. Crea una sesión de Checkout cuando un cliente quiera iniciar una suscripción. Después de redirigir a un cliente a una sesión de Checkout, Stripe le presentará un formulario de pago en el que podrá completar su compra. Una vez completada, Stripe lo redirigirá a tu sitio.

Precaución

Para comenzar a aceptar suscripciones de PayPal en Stripe, los pagos recurrentes con PayPal deben estar habilitados en el Dashboard.

Configurar Stripe
Lado del servidor

Primero, necesitas una cuenta de Stripe. Inscríbete ahora.

Usa nuestras bibliotecas oficiales para acceder a la API de Stripe desde tu aplicación:

Command Line
Ruby
Python
PHP
Java
Node
Go
.NET
No results
# Available as a gem
sudo gem install stripe
Gemfile
Ruby
Python
PHP
Java
Node
Go
.NET
No results
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Crear productos y precios recurrentes

Precaución

La API Prices unifica el modo en que se modelan las compras únicas y las suscripciones en Stripe. Se siguen admitiendo las integraciones existentes que no usan la API Prices. Sin embargo, algunas funcionalidades de Checkout solo admiten Prices. Consulta la guía de migración para actualizar a la API Prices.

Para usar Checkout, primero debes crear un producto y un precio. Los diferentes bienes físicos o niveles de servicio deben representarse mediante productos. El valor de cada producto está representado por uno o varios precios.

Puedes crear, por ejemplo, un producto que tenga cuatro precios: USD 10/mes, USD 100/año, EUR 9/mes y EUR 90/año. Esto te permite cambiar y agregar precios sin necesidad de cambiar los detalles del producto subyacente. Puedes crear un producto y precio con la API o a través del Dashboard de Stripe.

Si tu precio se determina en el momento de la compra (por ejemplo, el cliente establece un importe de donación), o si prefieres no crear precios de manera anticipada, puedes crear precios alineados al momento de crear la sesión de Checkout.

Antes de empezar a configurar productos, asegúrate de que estás en un entorno de prueba. Luego, define los bienes y servicios que planeas vender. Para crear un nuevo producto y precio:

  • Entra en la sección Productos del Dashboard
  • Haz click en Agregar producto
  • Selecciona “Recurrente” al establecer el precio
  • Configura el plan de precios

Puedes definir múltiples planes de precios con diferentes parámetros para cada producto recurrente. Cada precio tiene un ID generado que puedes usar como referencia durante el proceso de finalización de compra.

Nota

Los productos creados en un entorno de prueba se pueden copiar al modo activo para que no tengas que volver a crearlos. En la vista detallada de productos del Dashboard, haz clic en Copia a modo activo en la esquina superior derecha. Solo puedes hacerlo una vez por cada producto creado en un entorno de prueba. Las siguientes actualizaciones del producto de prueba no se reflejan en el producto real.

Crear una sesión de Checkout
Lado del cliente
Lado del servidor

Agrega un botón de finalización de compra en tu sitio web que llame a un punto de conexión del lado del servidor para crear una sesión de Checkout.

index.html
<html>
  <head>
    <title>Checkout</title>
  </head>
  <body>
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

Crea una sesión de Checkout con la ID de un precio existente. Asegúrate de que el modo esté configurado en subscription y de especificar al menos un precio recurrente. Puedes agregar precios únicos además de los precios recurrentes. Después de crear la sesión de Checkout, redirige a tu cliente a la URL devuelta en la respuesta.

Command Line
cURL
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[]"="paypal" \
  -d "line_items[][price]"=
{{PRICE_ID}}
 \
  -d "line_items[][quantity]"=1 \
  -d "mode"="subscription" \
  -d "success_url"="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d "cancel_url"="https://example.com/cancel" \

Cuando tu cliente completa correctamente el pago, se lo redirige a la success_url, una página de tu sitio web que le informa al cliente que su pago se efectuó correctamente. Muestra el ID de sesión en tu página de confirmación incluyendo la variable de plantilla {CHECKOUT_SESSION_ID} en la success_url como se muestra en el ejemplo anterior.

Cuando tu cliente hace click en tu logotipo en una sesión de Checkout sin completar el pago, Checkout lo redirige nuevamente a tu sitio web, a la cancel_url. Por lo general, esta es la página de tu sitio web que el cliente vio antes de ser redirigido a Checkout.

Las sesiones de Checkout vencen 24 horas después de su creación de forma predeterminada.

Precaución

No te bases solo en el redireccionamiento a la success_url para detectar el inicio del pago, ya que:

  • Algunos usuarios maliciosos podrían acceder directamente a la success_url y tener acceso a los bienes o servicios sin pagar.
  • Los clientes no siempre llegan a la success_url después de un pago correcto, posiblemente porque cierran la pestaña del navegador antes de ser redirigidos.

Confirmar que el pago se efectuó correctamente

Nota

Cuando un comprador confirma correctamente una suscripción en Stripe usando PayPal, se le envía un recibo de parte de Stripe y PayPal.

Cuando tu cliente completa correctamente el pago, se lo redirige a la URL que especificaste como success_url. Por lo general, esta es una página de tu sitio web que le informa al cliente que su pago se efectuó correctamente.

Usa el Dashboard, un webhook personalizado o un plugin de un tercero para administrar los eventos posteriores al pago, como enviar un correo electrónico para confirmar el pedido al cliente, registrar la venta en una base de datos o iniciar el flujo de envío.

Los pagos efectuados correctamente aparecen en la lista de pagos del Dashboard. Al hacer clic en un pago, se te dirigirá a la página de información del pago. La sección Resumen de la compra contiene información de facturación y la lista de artículos comprados, que puedes usar para completar el pedido manualmente.

Resumen de Checkout

Nota

Stripe puede ayudar a que te mantengas actualizado respecto de los pagos entrantes mediante notificaciones por correo electrónico cada vez que un cliente efectúa un pago correctamente. Usa el Dashboard para configurar notificaciones de correo electrónico.

Puedes usar plugins como Zapier para automatizar la actualización de tus sistemas de cumplimiento de pedidos con información de los pagos de Stripe.

Veamos algunos ejemplos de automatización que se basan en plugins:

  • Cómo actualizar planillas utilizadas para el seguimiento de pedidos en respuesta a los pagos efectuados correctamente
  • Cómo actualizar los sistemas de gestión de inventario en respuesta a los pagos efectuados correctamente
  • Cómo activar las notificaciones a los equipos internos de servicio al cliente que usen correo electrónico o aplicaciones de chat

Probar la integración

Prueba tu integración con PayPal con tus claves de API de prueba al visualizar la página de redireccionamiento. Puedes probar el caso de pago exitoso al autenticar el pago en la página de redireccionamiento. El PaymentIntent pasará de requires_action a succeeded.

Para probar el caso en el que falla la autenticación del usuario, usa tus claves de API de prueba y visualiza la página de redireccionamiento. En la página de redireccionamiento, haz click en Error en el pago de prueba. El Paymentintent hará la transición de requires_action a requires_payment_method.

Consulta también

¿Te fue útil esta página?
SíNo