Ir a contenido
Crea una cuenta
o
inicia sesión
Logotipo de la documentación de Stripe
/
Pregúntale a la IA
Crear cuenta
Iniciar sesión
Empezar
Pagos
Ingresos
Plataformas y marketplaces
Gestión del dinero
Recursos para desarrolladores
Resumen
Acerca de Stripe Payments
Actualiza tu integración
Análisis de pagos
Pagos por Internet
ResumenEncuentra tu caso de usoManaged Payments
Utiliza Payment Links
Crear una página del proceso de compra
Desarrolla una integración avanzada
Desarrolla una integración en la aplicación
Métodos de pago
Añadir métodos de pago
    Resumen
    Opciones de integración de los métodos de pago
    Gestiona los métodos de pago predeterminados en el Dashboard
    Tipos de método de pago
    Tarjetas
    Pagar con el saldo de Stripe
    Criptomonedas
    Adeudos bancarios
    Redireccionamientos bancarios
    Transferencias bancarias
    Transferencias de crédito (Sources)
    Compra ahora y paga después
      Affirm
      Afterpay / Clearpay
        Aceptar un pago
        Mensajes del sitio
      Alma
      Billie
      Capchase Pay
      Klarna
      Kriya
      Mondu
      Pago en factura
      Scalapay
      SeQura
      Sunbit
      Zip
    Pagos en tiempo real
    Vales
    Monederos
    Habilitar métodos de pago locales por país
    Métodos de pago personalizados
Gestiona los métodos de pago
Proceso de compra más rápido con Link
Interfaces de pago
Payment Links
Checkout
Elements para la web
Elements en la aplicación
Escenarios de pago
Administrar múltiples divisas
Flujos de pagos personalizados
Capacidad adquirente flexible
Orquestación
Pagos en persona
Terminal
Más allá de los pagos
Constituye tu empresa
Criptomonedas
Financial Connections
Climate
InicioPagosAdd payment methodsBuy now, pay laterAfterpay / Clearpay

Acepta un pago de Afterpay o Clearpay

Descubre cómo aceptar Afterpay (también conocido como Clearpay en Reino Unido), un método de pago en EE. UU., CA, Reino Unido, AU y NZ.

Precaución

Stripe presenta automáticamente a tus clientes las opciones de método de pago evaluando su divisa, sus restricciones en cuanto al método de pago y otros parámetros. Te recomendamos que configures tus métodos de pago desde el Dashboard de Stripe siguiendo las instrucciones en Acepta un pago.

Si quieres seguir configurando manualmente los métodos de pago que tus clientes verán en Checkout, usa esta guía. De lo contrario, actualiza tu integración para configurar los métodos de pago en el Dashboard.

Afterpay es un método de pago de uso único y de notificación inmediata que requiere que el cliente autentique su pago. Se redirige a los clientes al sitio web de Afterpay, donde aceptan las condiciones del plan de pago en cuotas. Cuando el cliente acepta las condiciones, Afterpay se asegura de que los fondos estén disponibles para el cliente y transfiere los fondos a tu cuenta de Stripe. El cliente paga a Afterpay directamente a lo largo del tiempo.

Nota

Antes de iniciar la integración, asegúrate de que tu cuenta sea apta para Afterpay. Para ello, accede a la configuración de los métodos de pago.

Determina la compatibilidad

Ubicación geográfica del cliente: Australia, Canada, New Zealand, UK, US

Divisas aceptadas: aud, cad, nzd, gbp, usd

Divisas de pago: aud, cad, nzd, gbp, usd

Modo de pago: Yes

Modo de configuración: No

Modo de suscripción: No

Una sesión de Checkout debe cumplir con todas las condiciones para aceptar pagos con Afterpay:

  • Solo puedes utilizar partidas puntuales (no se aceptan planes de suscripción recurrentes).
  • Debes expresar los Prices en tu divisa nacional.

Aceptar un pago

Nota

Esta guía se basa en la integración fundamental de aceptar un pago en Checkout.

Utiliza esta guía para saber cómo activar Afterpay: muestra las diferencias entre aceptar un pago con tarjeta y utilizar Afterpay.

Habilitar Afterpay como método de pago

Al crear una nueva Checkout Session, debes:

  1. Añadir afterpay_clearpay a la lista de payment_method_types.
  2. Asegurarte de que todos tus line_items usen la divisa de tu país.
  3. Te recomendamos recolectar las direcciones de envío añadiendo tu país a shipping_address_collection[allowed_countries]. Si no quieres recolectar direcciones de envío con Checkout, también puedes proporcionar la dirección de envío usando payment_intent_data[shipping]. Hacerlo ayuda con las tasas de aceptación de préstamos.
Ruby
Stripe::Checkout::Session.create({ mode: 'payment', payment_method_types: ['card'], payment_method_types: ['card', 'afterpay_clearpay'], line_items: [{ price_data: { currency: 'usd', product_data: { name: 'T-shirt', }, # Make sure the total amount fits within Afterpay transaction amount limits: # https://stripe.com/docs/payments/afterpay-clearpay#collection-schedule unit_amount: 2000, }, quantity: 1, }], shipping_address_collection: { # Shipping address is optional but recommended to pass in # Specify which shipping countries Checkout should provide as options for shipping locations allowed_countries: ['AU', 'CA', 'GB', 'NZ', 'US'], }, # If you already have the shipping address, provide it in payment_intent_data: # payment_intent_data: { # shipping: { # name: 'Jenny Rosen', # address: { # line1: '1234 Main Street', # city: 'San Francisco', # state: 'CA', # country: 'US', # postal_code: '94111', # }, # }, # }, success_url: 'https://example.com/success', cancel_url: 'https://example.com/cancel', })

Completa tus pedidos

Usa un método como los webhooks para gestionar la ejecución del pedido, en lugar de esperar a que tu cliente vuelva a la página de estado del pago.

Los siguientes eventos se envían cuando el estado del pago cambia:

Nombre del eventoDescripciónPróximos pasos
checkout.session.completedEl cliente ha autorizado correctamente el pago al enviar el formulario del proceso de finalización de compra.Esperar hasta asegurarte de si el pago se ha realizado correctamente o no.
payment_intent.succeededEl pago del cliente se ha efectuado satisfactoriamente. El PaymentIntent pasa a succeeded.Suministrar los bienes o servicios que el cliente ha comprado.
payment_intent.payment_failedSe ha rechazado el pago del cliente o ha fallado por alguna otra razón. El PaymentIntent vuelve al estado requires_payment_method.Enviar un correo electrónico al cliente para pedirle que haga un nuevo pedido.

Obtén más información sobre completar pedidos.

Prueba tu integración

Al probar tu integración de Checkout, selecciona Afterpay como método de pago y haz clic en el botón Pagar.

Para probar tu integración de Afterpay con las claves de la API en modo de prueba, consulta la página de redireccionamiento. Puedes probar el caso de pago satisfactorio autenticando el pago en la página de redireccionamiento. El PaymentIntent pasará de requires_action a succeeded.

Para probar el caso en el que el usuario no pueda autenticarse, utiliza las claves de la API en modo de prueba y consulta la página de redireccionamiento. En la página de redireccionamiento, haz clic en Error en el pago en modo de prueba. El PaymentIntent pasará de requires_action a requires_payment_method.

Para la captura manual de PaymentIntents en modo de prueba, el PaymentIntent no capturado vencerá automáticamente 10 minutos después de la autorización satisfactoria.

Pagos fallidos

Afterpay tiene en cuenta varios factores a la hora de decidir si acepta o rechaza una transacción (por ejemplo, el tiempo que el comprador lleva utilizando Afterpay, el importe pendiente de pago del cliente, el valor del pedido actual).

Siempre debes presentar más opciones de pago como card en el flujo del proceso de compra, ya que los pagos con Afterpay tiene una tasa de rechazos superior que muchos métodos de pago. En estos casos, el PaymentMethod se separa y el estado del objeto PaymentIntent pasa automáticamente a requires_payment_method.

Para un PaymentIntent de Afterpay con un estado de requires_action, los clientes deben efectivizar el pago en el transcurso de las 3 horas posteriores a redirigirles al sitio de Afterpay (esto no se aplica a los pagos rechazados). Si no realiza ninguna acción en el transcurso de 3 horas, el PaymentMethod se separa y el estado del objeto del PaymentIntent pasa automáticamente a requires_payment_method.

En estos casos, informa a tus clientes que deben intentarlo de nuevo con una opción de pago diferente de tu flujo de proceso de compra.

Códigos de error

Estos son algunos códigos de error comunes y las correspondientes acciones recomendadas:

Código de errorAcción recomendada
payment_intent_payment_attempt_failedUn error genérico indica que el proceso de compra de Afterpay ha fallado. También puede tratarse de un rechazo que no aparece como código de error de rechazo.
payment_method_provider_declineAfterpay ha rechazado el pago del cliente. Como siguiente paso, el cliente debe contactarse con Afterpay para obtener más información.
payment_intent_payment_attempt_expiredEl cliente nunca efectivizó el pago en la página del proceso de compra de Afterpay y la sesión de pago ha caducado. Stripe caduca automáticamente los Payment Intents que no se hayan autorizado correctamente 3 horas después de la creación del proceso de compra inicial.
payment_method_not_availableAfterpay ha experimentado un error relacionado con el servicio y no puede completar la solicitud. Vuelve a intentarlo más tarde.
amount_too_smallIntroduce un importe dentro de los límites de transacciones predeterminados de Afterpay para el país.
amount_too_largeIntroduce un importe dentro de los límites de transacciones predeterminados de Afterpay para el país.

Véase también

  • Más información sobre Afterpay
  • Cumplimiento de Checkout
  • Personaliza Checkout
¿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