Ir a contenido
Crea una cuenta o inicia sesión
Logotipo de la documentación de Stripe
/
Crear cuentaIniciar sesión
ResumenAceptar un pagoActualiza tu integración
Pagos por Internet
ResumenEncuentra tu caso de usoUsa Managed PaymentsPagos recurrentes
Pagos en persona
Métodos de pago
Aspectos básicos de las operaciones de pago
Saldos y plazos de liquidaciónRecibosReembolsos y cancelaciones
Integraciones avanzadas
Más allá de los pagos

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 puede presentar automáticamente los métodos de pago pertinentes a tus clientes evaluando la moneda, las restricciones de los métodos de pago y otros parámetros.

  • Sigue la guía Aceptar un pago para crear una integración de Checkout que utilice métodos de pago dinámicos.
  • Si no quieres utilizar métodos de pago dinámicos, sigue los pasos que se indican a continuación para configurar manualmente los métodos de pago en tu integración de Checkout.

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.

Esta guía te explica cómo habilitar Afterpay y muestra las diferencias entre aceptar pagos mediante métodos de pago dinámicos y configurar manualmente los métodos de pago.

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. Asegúrate de que todos tus line_items utilicen tu divisa nacional y de que el importe total no supere los límites de importe de las transacciones de Afterpay.
  3. Opcionalmente, especifica en qué países Checkout permite realizar envíos a través de shipping_address_collection[allowed_countries].
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=afterpay_clearpay \
  -d "shipping_address_collection[allowed_countries][0]"=AU \
  -d "shipping_address_collection[allowed_countries][1]"=CA \
  -d "shipping_address_collection[allowed_countries][2]"=GB \
  -d "shipping_address_collection[allowed_countries][3]"=NZ \
  -d "shipping_address_collection[allowed_countries][4]"=US \
  --data-urlencode success_url="https://example.com/success"

Si no quieres recopilar las direcciones de envío con Checkout, también puedes proporcionar la dirección de envío con payment_intent_data[shipping]. Hacerlo ayuda a mejorar las tasas de aceptación de préstamos.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_intent_data[shipping][name]"="Jenny Rosen" \
  -d "payment_intent_data[shipping][address][line1]"="1234 Main Street" \
  -d "payment_intent_data[shipping][address][city]"="San Francisco" \
  -d "payment_intent_data[shipping][address][state]"=CA \
  -d "payment_intent_data[shipping][address][country]"=US \
  -d "payment_intent_data[shipping][address][postal_code]"=94111 \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=afterpay_clearpay \
  --data-urlencode success_url="https://example.com/success"

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 no completó el pago en la página Afterpay del proceso de compra, y la sesión de pago ha caducado. Los PaymentIntents de Stripe caducan automáticamente si no se autorizan correctamente transcurridas 3 horas desde el inicio del proceso de compra.
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.

También podría interesarte...