Ir a contenido
Crea una cuenta
 o
inicia sesión
Logotipo de la documentación de Stripe
/
Crear cuenta
Iniciar sesión
ResumenActualiza tu integración
Pagos por Internet
ResumenEncuentra tu caso de usoManaged Payments
Métodos de pago
Interfaces de pago
Escenarios de pago
Pagos en persona
Otros productos de Stripe

Guía de migración de Checkout

Cómo migrar a las últimas integraciones de Stripe.

Copia la página

La versión heredada de Checkout presentaba a los clientes un cuadro de diálogo para recopilar los datos de tarjeta y devolvía un token o una fuente a tu sitio web. En cambio, Payment Links y la nueva versión de Checkout son páginas de pagos inteligentes alojadas por Stripe que crean pagos o suscripciones. Ambas integraciones aceptan Apple Pay, Google Pay, 3D Secure dinámico, Connect, reutilización de Clientes existentes y muchas otras funciones. También puedes comparar otras integraciones de pago si Payment Links o Checkout no se ajustan a tu caso de uso.

Cosas a tener en cuenta

Si usas los SDK de Stripe, actualiza a la última versión.

Elige tu modelo de negocio

Para migrar desde la versión heredada de Checkout, sigue la guía que mejor represente tu modelo de negocio. Cada guía recomienda una ruta de integración junto con un código de ejemplo.

Al seguir la guía de migración correspondiente, también puedes consultar la tabla de conversión para obtener un mapeo de parámetros y opciones de configuración específicos.

Catálogo de productos y precios dinámicos

Si vendes productos para los que determinas importes o ítems de factura dinámicos (p. ej., porque tienes un gran catálogo de productos o donaciones), consulta cómo aceptar pagos puntuales.

Es posible que hayas utilizado la versión heredada de Checkout para crear un token o una fuente en el cliente y que lo hayas pasado a tu servidor para crear un cargo. La versión actual de Checkout invierte este flujo: tú creas una sesión en tu servidor y rediriges a tu cliente a Checkout, que después le redirige a tu aplicación tras el pago.

Antes

Con la versión heredada de Checkout, mostrabas el importe y la descripción dinámicos y recopilabas los datos de la tarjeta del cliente.

client.html
<form action="/purchase" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Custom t-shirt"
    data-description="Your custom designed t-shirt"
    data-amount="{{ORDER_AMOUNT}}"
    data-currency="usd">
  </script>
</form>

A continuación, enviabas el token o la fuente resultante a tu servidor y efectuabas el cargo.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="customer@example.com" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "description"="Custom t-shirt" \
  -d "amount"="{{ORDER_AMOUNT}}" \
  -d "currency"="usd"

Después

Añade 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 Checkout Session.

checkout.html
<html>
  <head>
    <title>Buy cool new product</title>
  </head>
  <body>
    <!-- Use action="/create-checkout-session.php" if your server is PHP based. -->
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

Una Checkout Session es la representación programática de lo que ve tu cliente cuando se le redirecciona al formulario de pago. Puedes configurarla con opciones como las siguientes:

Incluye una success_url con la URL de una página en tu sitio web a la que se redirige al cliente después de que complete el pago.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"="Custom t-shirt" \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

Después de crear una sesión de Checkout, redirige al cliente a la URL devuelta en la respuesta. Si necesitas completar los productos comprados después del pago, consulta Completar Checkout y Enlace de Pago.

Suscripciones dinámicas

Si ofreces servicios de suscripción determinados de forma dinámica o necesitas compatibilidad para otras funciones avanzadas, consulta configurar una suscripción.

Es posible que hayas utilizado la versión heredada de Checkout para crear un token o una fuente en el cliente y que lo hayas pasado a tu servidor para crear un cliente y una suscripción. La versión actual de Checkout invierte este flujo: primero creas una sesión en tu servidor y rediriges a tu cliente a Checkout, que después le redirige a tu aplicación si se realiza correctamente.

Antes

Con la versión heredada de Checkout, mostrabas los datos de la suscripción y recopilabas los datos de la tarjeta del cliente.

client.html
<form action="/subscribe" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Gold Tier"
    data-description="Monthly subscription with 30 days trial"
    data-amount="2000"
    data-label="Subscribe">
  </script>
</form>

A continuación, enviabas el token o la fuente resultante a tu servidor para crear un cliente y una suscripción.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="customer@example.com" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/subscriptions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "items[0][price]"="{PRICE_ID}" \
  -d "trial_period_days"=30

Después

Añade 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 Checkout Session.

checkout.html
<html>
  <head>
    <title>Subscribe to cool new service</title>
  </head>
  <body>
    <!-- Use action="/create-checkout-session.php" if your server is PHP based. -->
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Subscribe</button>
    </form>
  </body>
</html>

Una Checkout Session es la representación programática de lo que ve tu cliente cuando se le redirecciona al formulario de pago. Puedes configurarla con opciones como las siguientes:

Incluye una success_url con la URL de una página en tu sitio web a la que se redirige al cliente después de que complete el pago.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=1 \
  -d "subscription_data[trial_period_days]"=30 \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success"

Después de crear una Checkout Session, redirige al cliente a la URL devuelta en la respuesta. El cliente será redirigido a la success_url una vez que se hayan creado el cliente y la suscripción. Si necesitas completar los servicios adquiridos después del pago, consulta Completar los pagos de Checkout y Payment Link.

Plataformas y marketplaces Connect

Si tienes una plataforma o marketplace de Connect y realizas pagos con cuentas conectadas, considera la posibilidad de usar la versión actual de Checkout.

El siguiente ejemplo muestra el uso de la API Checkout Sessions para procesar un cargo directo. También puedes usar Checkout y Connect con cargos indirectos y cargos y envíos de fondos separados.

Antes

Con la antigua versión de Checkout, recopilabas los datos de tarjeta de tu cliente del lado del cliente.

client.html
<form action="/purchase" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Food Marketplace"
    data-description="10 cucumbers from Roger's Farm"
    data-amount="2000">
  </script>
</form>

A continuación, enviabas el token o la fuente resultante a tu servidor y efectuabas el cargo en nombre de la cuenta conectada.

Command Line
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "source"="{{TOKEN_ID}}" \
  -d "description"="10 cucumbers from Roger\"s Farm" \
  -d "amount"=2000 \
  -d "currency"="usd" \
  -d "application_fee_amount"=200 \
  -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}"

Después

Añade 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 Checkout Session.

checkout.html
<html>
  <head>
    <title>Roger's Farm</title>
  </head>
  <body>
    <!-- Use action="/create-checkout-session.php" if your server is PHP based. -->
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

Una Checkout Session es la representación programática de lo que ve tu cliente cuando se le redirecciona al formulario de pago. Puedes configurarla con opciones como las siguientes:

Incluye una success_url con la URL de una página en tu sitio web a la que se redirige al cliente después de que complete el pago.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "line_items[0][price_data][currency]"=usd \
  --data-urlencode "line_items[0][price_data][product_data][name]"="Cucumbers from Roger's Farm" \
  -d "line_items[0][price_data][unit_amount]"=200 \
  -d "line_items[0][quantity]"=10 \
  -d "payment_intent_data[application_fee_amount]"=200 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

Después de crear una sesión de Checkout, redirige al cliente a la URL devuelta en la respuesta. Si necesitas completar los bienes o servicios adquiridos después del pago, consulta Completar los pagos de Checkout y Payment Link.

Cómo guardar métodos de pago para un uso futuro

Si ofreces servicios que no cobran a los clientes de inmediato, consulta configuración de pagos futuros.

Es posible que hayas utilizado la versión heredada de Checkout para crear un token o una fuente en el cliente y que lo hayas pasado a tu servidor para guardarlo para su uso posterior. La versión actual de Checkout invierte este flujo: primero creas una sesión en tu servidor, y rediriges a tu cliente a Checkout, que después le redirige a tu aplicación si se realiza correctamente.

Antes

Con la versión heredada de Checkout, mostrabas los datos del cargo y recopilabas los datos de la tarjeta del cliente.

client.html
<form action="/subscribe" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Cleaning Service"
    data-description="Charged after your home is spotless"
    data-amount="2000">
  </script>
</form>

A continuación, enviabas el token o la fuente resultante a tu servidor para, en última instancia, crear un cargo.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="customer@example.com" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "description"="Cleaning service" \
  -d "amount"="{{ORDER_AMOUNT}}" \
  -d "currency"="usd"

Después

Añade 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 Checkout Session.

checkout.html
<html>
  <head>
    <title>Cleaning service</title>
  </head>
  <body>
    <!-- Use action="/create-checkout-session.php" if your server is PHP based. -->
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Subscribe</button>
    </form>
  </body>
</html>

Una Checkout Session es la representación programática de lo que ve tu cliente cuando se le redirecciona al formulario de pago. Puedes configurarla con opciones como las siguientes:

Incluye una success_url con la URL de una página de tu sitio web a la que se redirige al cliente después de completar la configuración del pago.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d mode=setup \
  --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}"

Después de crear una Checkout Session, redirige al cliente a la URL devuelta en la respuesta para recopilar los datos del método de pago. El cliente será redirigido a success_url una vez completado el flujo. Cuando tengas todo listo para cobrar un pago, recupera el SetupIntent de la Checkout Session y úsalo para preparar la transacción.

Catálogo simple de productos con precios fijos

Si vendes productos con precios fijos (como camisetas o libros electrónicos), consulta la guía en enlaces de pago. Es posible que hayas utilizado la versión heredada de Checkout para crear un token o una fuente en el cliente, y que lo hayas pasado a tu servidor para crear un cargo.

Antes

Con la versión heredada de Checkout, mostrabas el importe y la descripción y recopilabas los datos de la tarjeta del cliente.

client.html
<form action="/pay" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="T-shirt"
    data-description="Comfortable cotton t-shirt"
    data-amount="500"
    data-currency="usd">
  </script>
</form>

A continuación, enviabas el token o la fuente resultante a tu servidor para crear un cliente y un cargo.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="{{STRIPE_EMAIL}}" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "description"="T-shirt" \
  -d "amount"=500 \
  -d "currency"="usd"

Después

Crea un Product y un Price que representen la partida. El siguiente ejemplo crea el producto en línea. También puedes crear estos objetos en el Dashboard.

Command Line
curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d unit_amount=500 \
  -d "product_data[name]"=T-shirt

Crea un Payment Link en el Dashboard utilizando el Product y el Price. Después de crear el enlace, haz clic en el botón Comprar para configurar el diseño y generar el código que puedes copiar y pegar en tu sitio web.

index.html
<body>
  <h1>Purchase your new kit</h1>
  <!-- Paste your embed code script here. -->
  <script
    async
    src="https://js.stripe.com/v3/buy-button.js">
  </script>
  <stripe-buy-button
    buy-button-id=
'{{BUY_BUTTON_ID}}'

    publishable-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

  >
  </stripe-buy-button>
</body>

Suscripciones simples

Si ofreces un servicio de suscripción sencillo (como el acceso mensual al software), consulta la guía en enlaces de pago. Es posible que hayas utilizado la versión heredada de Checkout para crear un token o una fuente en el cliente y que lo hayas pasado a tu servidor para crear un cliente y una suscripción.

Antes

Con la versión heredada de Checkout, mostrabas los datos de la suscripción y recopilabas los datos de la tarjeta del cliente.

client.html
<form action="/subscribe" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Gold Tier"
    data-description="Monthly subscription"
    data-amount="2000"
    data-currency="usd"
    data-label="Subscribe">
  </script>
</form>

A continuación, enviabas el token o la fuente resultante a tu servidor para crear un cliente y una suscripción.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="{{STRIPE_EMAIL}}" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/subscriptions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "items[][price]"="{PRICE_ID}" \
  -d "items[][quantity]"=1

Después

Crea un Product y un Price que representen la suscripción. El siguiente ejemplo crea el producto en línea. También puedes crear estos objetos en el Dashboard.

Command Line
curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d unit_amount=2000 \
  -d "recurring[interval]"=month \
  -d "product_data[name]"="Gold Tier"

Crea un Payment Link en el Dashboard utilizando el Product y el Price. Después de crear el enlace, haz clic en el botón Comprar para configurar el diseño y generar el código que puedes copiar y pegar en tu sitio web.

index.html
<body>
  <h1>Purchase your new kit</h1>
  <!-- Paste your embed code script here. -->
  <script
    async
    src="https://js.stripe.com/v3/buy-button.js">
  </script>
  <stripe-buy-button
    buy-button-id=
'{{BUY_BUTTON_ID}}'

    publishable-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

  >
  </stripe-buy-button>
</body>

Conversión de parámetros

La versión actual de Checkout es compatible con la mayoría de las funciones de la versión heredada. Sin embargo, no comparten la misma API. La tabla siguiente muestra los parámetros y las opciones de configuración entre la versión heredada y la versión actual. Para obtener una lista completa de las opciones de configuración, consulta Checkout Sessions.

Versión heredadaVersión actualConsejos de integración
allowRememberMeNo compatibleReutiliza los clientes existentes especificando el parámetro customer al crear una sesión de Checkout. También puedes habilitar Link para que tus clientes puedan guardar y reutilizar de forma segura su información de pago.
amountSe calcula automáticamente como la suma de los importes de todos los line_itemsEl importe total corresponde a la suma de las partidas de factura especificadas en Checkout.
billingAddressSession.billing_address_collectionCheckout recopila automáticamente la dirección de facturación cuando es obligatorio a efectos de la prevención del fraude o conforme a la normativa. Establece este parámetro en required para recopilar siempre la dirección de facturación.
closedcancel_urlCuando un cliente quiere cerrar Checkout, debe cerrar la pestaña del navegador o ir a cancel_url.
currencySession.currency
descriptionSession.line_items.description o product.descriptionSi especificas un precio, Checkout muestra una descripción generada automáticamente sobre la frecuencia con la que se producen los pagos. Si especificas Session.line_items, Checkout muestra el name de cada partida.
emailSession.customer_emailSi ya conoces el correo electrónico de tu cliente, puedes rellenarlo previamente con customer_email al crear la sesión de Checkout.

image

Imagen de marca de la empresa: carga el logotipo o icono de tu empresa en el Dashboard.

Imágenes del producto: Especifica imágenes para cada partida con product.images.

Checkout utiliza imágenes específicas para la marca de tu empresa y para los productos que vendes. Checkout muestra el logotipo de tu empresa de forma predeterminada y cambia al icono de tu empresa junto con el nombre de tu empresa.

keyParámetro que ya no se especifica en Checkout
localeSession.localePuedes especificar una compatible configuración regional al crear una Checkout Session.
nameproduct.name para precios especificados en Session.line_itemsSi especificas un precio, Checkout le muestra al cliente el nombre del producto asociado con ese precio y cliente. Si especificas Session.line_items, Checkout muestra el name de cada ítem de factura.
panelLabelsubmit_typeCheckout personaliza el texto del botón automáticamente en función de los artículos que vendes. Para personalizar el texto del botón para pagos puntuales, utiliza submit_type.
shippingAddresssession.shipping_address_collectionRecopila los datos de la dirección de envío especificando una matriz de allowed_countries a los que quieres hacer envíos.
token o sourcesuccess_urlYa no hay una devolución de llamada en JavaScript al completarse el pago. Como tu cliente paga en otra página, establece la success_url a la que redirigirás al cliente después de que haya completado el pago.
zipCodeRecopilado automáticamente por CheckoutCheckout recopila automáticamente el código postal cuando es obligatorio a efectos de la prevención del fraude o conforme a la normativa.

Véase también

¿Te ha sido útil la página?
SíNo
¿Necesitas ayuda? Ponte en contacto con el equipo de soporte.
Únete a nuestro programa de acceso anticipado.
Echa un vistazo a nuestro registro de cambios.
¿Tienes alguna pregunta? Ponte en contacto con el equipo de ventas.
¿LLM? Lee llms.txt.
Con tecnología de Markdoc