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.
Aceptar Afterpay en tu aplicación consiste en mostrar una vista web para que el cliente autentique su pago. A continuación, el cliente vuelve a tu aplicación y puedes confirmar automáticamente si el pago se ha efectuado correctamente o ha dado error.
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.
Configurar StripeLado del servidorLado del cliente
Primero, necesitas una cuenta de Stripe. Inscríbete ahora.
Lado del servidor
Esta integración necesita puntos de conexión en tu servidor que se comuniquen con la API de Stripe. Usa las bibliotecas oficiales para acceder a la API de Stripe desde tu servidor:
Lado del cliente
El SDK para Android de Stripe es de código abierto y está completamente documentado.
Para instalar el SDK, añade stripe-android
al bloque dependencies
de tu archivo app/build.gradle:
Nota
Para conocer detalles de la última versión y de versiones anteriores del SDK, consulta la página Versiones de GitHub. Para recibir una notificación cuando se publique una nueva versión, mira las versiones del repositorio.
Configura el SDK con tu clave publicable de Stripe para que pueda hacer solicitudes a la API de Stripe, así como en tu subclase Application
:
Nota
Usa las claves de prueba durante las pruebas y las tareas de desarrollo, y las claves del modo activo cuando publiques tu aplicación.
Los ejemplos de Stripe también utilizan OkHttp y GSON para hacer solicitudes HTTP a un servidor.
Crea un PaymentIntentLado del servidorLado del cliente
Un PaymentIntent es un objeto que representa tu intención de cobrarle a un cliente y hace el seguimiento del ciclo de vida del proceso de pago en cada etapa.
Lado del servidor
Primero, crea un PaymentIntent
en tu servidor y especifica el importe que hay que cobrar y la divisa. Si ya tienes una integración que utiliza la API Payment Intents, añade afterpay_
a la lista de tipos de métodos de pago para tu PaymentIntent
.
Opciones de métodos de pago adicionales
Puedes especificar un parámetro reference
opcional en las opciones del método de pago para tu PaymentIntent
que establece un identificador de pedido interno para el pago. Aunque esto no suele ser visible ni para la empresa ni para el consumidor, el equipo de soporte interno de Afterpay puede acceder a él durante las solicitudes de soporte manuales. El identificador tiene un límite de 128 caracteres y solo puede contener letras, dígitos, guiones bajos, barras diagonales inversas y guiones.
Lado del cliente
El PaymentIntent devuelto incluye un secreto de cliente que puede utilizar el lado del cliente para completar el proceso de pago de forma segura en lugar de especificar el objeto PaymentIntent completo. En el lado del cliente, solicita un PaymentIntent desde tu servidor y almacena el secreto de cliente.
Recopila los datos del método de pagoLado del cliente
Afterpay requiere que los datos de facturación estén presentes para que el pago se efectúe correctamente. En tu aplicación, recolecta los datos de facturación necesarios del cliente:
- Nombre completo (nombre y apellido)
- Dirección de correo electrónico
- Dirección de facturación completa
Crea un PaymentMethodCreateParams con estos datos.
Además, aunque no se requieren datos de envío, pueden ayudar a mejorar las tasas de autenticación. Para recolectar los datos de envío, debes recolectar del cliente la siguiente información:
- Nombre completo
- Dirección de envío completa
Crea un ConfirmPaymentIntentParams.Shipping con estos datos.
Envía el pago a StripeLado del cliente
Recupera el secreto de cliente del PaymentIntent que creaste en el paso 2 y llama al método de confirmación del PaymentLauncher. Esto presenta una vista web donde el cliente puede completar el pago en el sitio web o en la aplicación de su banco. Después, se llama a onActivityResult con el resultado del pago.
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. |