Ir a contenido
Crea una cuenta o inicia sesión
Logotipo de la documentación de Stripe
/
Crear cuentaIniciar sesión
ResumenActualiza tu integración
Pagos por Internet
ResumenEncuentra tu caso de usoUsa Managed Payments
Métodos de pago
Interfaces de pago
Escenarios de pago
Pagos en persona
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.

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 Stripe
Lado del servidor
Lado 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:

Command Line
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# Available as a gem
sudo gem install stripe
Gemfile
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Lado del cliente

El SDK para iOS de Stripe es de código abierto, está plenamente documentado y es compatible con aplicaciones que admiten iOS 13 o posterior.

Para instalar el SDK, sigue estos pasos:

  1. En Xcode, elige Archivo > Añadir dependencias de paquetes… e introduce https://github.com/stripe/stripe-ios-spm como la URL del repositorio.
  2. Selecciona el número de versión más reciente en nuestra página de versiones.
  3. Añade el producto StripePaymentsUI al objetivo de tu aplicación.

Nota

Para obtener más información sobre la versión más reciente y sobre versiones anteriores del SDK, consulta la página Versiones en GitHub. Para recibir notificaciones cuando se publica una nueva versión, consulta las versiones del repositorio.

Configura el SDK con tu clave publicable de Stripe al iniciar la aplicación para que tu aplicación haga solicitudes a la API de Stripe.

AppDelegate.swift
Swift
Objective-C
No results
import UIKit
import StripePaymentsUI

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        StripeAPI.defaultPublishableKey = 
"pk_test_TYooMQauvdEDq54NiTphI7jx"

        // do any other necessary launch configuration
        return true
    }
}

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.

Crea un PaymentIntent
Lado del servidor
Lado 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_clearpay a la lista de tipos de métodos de pago para tu PaymentIntent.

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=1099 \
  -d "currency"="usd" \
  -d "payment_method_types[]"="afterpay_clearpay"

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.

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=1099 \
  -d "currency"="usd" \
  -d "payment_method_types[]"="afterpay_clearpay" \
  -d "payment_method_options[afterpay_clearpay][reference]"="order_123"

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.

Swift
Objective C
No results
import UIKit
import StripePayments

class CheckoutViewController: UIViewController {
  var paymentIntentClientSecret: String?

  func startCheckout() {
      // Request a PaymentIntent from your server and store its client secret
  }
}

Recopila los datos del método de pago
Lado 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 objeto STPPaymentMethodParams 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 STPPaymentIntentShippingDetailsAddressParams con estos datos.

Swift
Objective C
No results
// Billing details
let billingDetails = STPPaymentMethodBillingDetails()
billingDetails.name = "Jane Doe"
billingDetails.email = "email@email.com"
let billingAddress = STPPaymentMethodAddress()
billingAddress.line1 = "510 Townsend St."
billingAddress.postalCode = "94102"
billingAddress.country = "US"
billingDetails.address = billingAddress

// Afterpay PaymentMethod params
let afterpayParams = STPPaymentMethodParams(afterpayClearpay: STPPaymentMethodAfterpayClearpayParams(),
                                                                             billingDetails: billingDetails,
                                                                             metadata: nil)

// Shipping details
// Shipping details are optional but recommended to pass in.
let shippingAddress = STPPaymentIntentShippingDetailsAddressParams(line1: "510 Townsend St.")
shippingAddress.country = "US"
shippingAddress.postalCode = "94102"
let shippingDetails = STPPaymentIntentShippingDetailsParams(address: shippingAddress, name: "Jane Doe")

Envía el pago a Stripe
Lado del cliente

Recupera el secreto de cliente del PaymentIntent que creaste en el paso 2 y llama al método STPPaymentHandler confirmPayment:. Esto presenta una vista web donde el cliente puede completar el pago, después de lo cual se llama al bloque de finalización con el resultado del pago.

Swift
Objective C
No results
let paymentIntentParams = STPPaymentIntentParams(clientSecret: paymentIntentClientSecret)
paymentIntentParams.paymentMethodParams = afterpayParams
// Shipping details are optional but recommended to pass in.
paymentIntentParams.shipping = shippingDetails

STPPaymentHandler.shared().confirmPayment(paymentIntentParams, with: self) { (handlerStatus, paymentIntent, error) in
    switch handlerStatus {
    case .succeeded:
        // Payment succeeded

    case .canceled:
        // Payment was canceled

    case .failed:
        // Payment failed

    @unknown default:
        fatalError()
    }
}

OpcionalAñade partidas al PaymentIntent

Opcionalmente, puedes aceptar los datos de la partida para proporcionar más señales de riesgo a Afterpay. Actualmente, esta función está disponible en versión beta privada. Si quieres solicitar acceso a dicha función, contáctanos.

OpcionalSepara la autorización y la captura

A diferencia de la autorización y captura separadas para los pagos con tarjeta, Afterpay cobra al cliente la primera cuota del pago en el momento de la autorización. Tienes hasta 13 días después de la autorización para capturar el resto del pago. Si no registras el pago en este período, el cliente recibirá el reembolso de la primera cuota y no se le cobrará ninguna otra. En estos casos, Stripe también cancela el PaymentIntent y envía un evento payment_intent.canceled.

Si sabes que no puedes capturar el pago, te recomendamos que canceles el PaymentIntent en lugar de esperar a que transcurra el plazo de 13 días. La cancelación proactiva del PaymentIntent reembolsa inmediatamente la primera cuota a tu cliente, evitando cualquier confusión sobre los cargos en su extracto.

  • Indicarle a Stripe que autorice solamente

    • Para indicar que quieres separar la autorización y la captura, establece capture_method en manual al crear el PaymentIntent. Este parámetro le indica a Stripe que solo debe autorizar el importe en la cuenta del cliente de Afterpay.

    Command Line
    curl
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    curl https://api.stripe.com/v1/payment_intents \
  -u 
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :     \
  -d "amount"=1099 \
  -d "currency"="usd" \
  -d "payment_method_types[]"="afterpay_clearpay" \
  -d "capture_method"="manual" \
  -d "shipping[name]"="Jenny Rosen" \
  -d "shipping[address][line1]"="1234 Main Street" \
  -d "shipping[address][city]"="San Francisco" \
  -d "shipping[address][state]"="CA" \
  -d "shipping[address][country]"="US" \
  -d "shipping[address][postal_code]"=94111

    Una vez que la autorización se realiza correctamente, Stripe envía un evento payment_intent.amount_capturable_updated. Consulta nuestra guía de eventos para obtener ayuda.

  • Capturar los fondos

    • Una vez que la autorización se realiza correctamente, el estado del PaymentIntent pasa a requires_capture. Para capturar los fondos autorizados, realiza una petición de captura del PaymentIntent. De forma predeterminada, se captura el importe total autorizado; no puedes capturar más de ese importe, pero sí menos.

    Command Line
    cURL
    Stripe CLI
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    curl https://api.stripe.com/v1/payment_intents/
    {{PAYMENT_INTENT_ID}}
    /capture     \
  -u "
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :"     \
  -d amount_to_capture=750

    Opcional Cancela la autorización

    Si necesitas cancelar una autorización, puedes cancelar el PaymentIntent.

    OpcionalGestiona eventos posteriores al pago

    Stripe envía un evento payment_intent.succeeded cuando se completa el pago. Utiliza el Dashboard, un webhook personalizado o una solución de socio para recibir estos eventos y ejecutar acciones como, por ejemplo, enviar un correo electrónico para confirmar el pedido al cliente, registrar la venta en una base de datos o iniciar el flujo de tareas de envío.

    Escucha estos eventos en lugar de esperar una devolución de llamada del cliente. Por su parte, el cliente puede cerrar la ventana del navegador o salir de la aplicación antes de que se ejecute la devolución de llamada y los clientes malintencionados podrían manipular la respuesta. Configurar tu integración para escuchar eventos asincrónicos también te ayudará a aceptar más métodos de pago en el futuro. Obtén más información sobre las diferencias entre todos los métodos de pago aceptados.

    • Gestiona eventos manualmente en el Dashboard

      Utiliza el Dashboard para ver tus pagos de prueba en el Dashboard, enviar recibos por correo electrónico, gestionar pagos o reintentar pagos fallidos.

    • Crea un webhook personalizado

      Crea un webhook personalizado para escuchar eventos y crear flujos de pago asíncronos personalizados. Prueba y depura tu integración de webhooks de forma local con la CLI de Stripe.

    • Integra una aplicación prediseñada

      Gestiona eventos empresariales comunes, como la automatización o la comercialización y ventas, integrando una aplicación asociada.

    OpcionalPrueba la integración de Afterpay

    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.
    ¿Te ha sido útil la página?
    SíNo