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
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:
- Añadir
afterpay_
a la lista declearpay payment_
.method_ types - Asegurarte de que todos tus
line_
usen la divisa de tu país.items - Te recomendamos recolectar las direcciones de envío añadiendo tu país a
shipping_
. Si no quieres recolectar direcciones de envío con Checkout, también puedes proporcionar la dirección de envío usandoaddress_ collection[allowed_ countries] payment_
. Hacerlo ayuda con las tasas de aceptación de préstamos.intent_ data[shipping]
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 evento | Descripción | Próximos pasos |
---|---|---|
checkout.session.completed | El 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.succeeded | El 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_failed | Se ha rechazado el pago del cliente o ha fallado por alguna otra razón. El PaymentIntent vuelve al estado requires_ . | 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_
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_
a requires_
.
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_
.
Para un PaymentIntent de Afterpay con un estado de requires_
, 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_
.
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 error | Acción recomendada |
---|---|
payment_ | Un 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_ | Afterpay ha rechazado el pago del cliente. Como siguiente paso, el cliente debe contactarse con Afterpay para obtener más información. |
payment_ | El 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_ | Afterpay ha experimentado un error relacionado con el servicio y no puede completar la solicitud. Vuelve a intentarlo más tarde. |
amount_ | Introduce un importe dentro de los límites de transacciones predeterminados de Afterpay para el país. |
amount_ | Introduce un importe dentro de los límites de transacciones predeterminados de Afterpay para el país. |