Aceptar un pago

Activa Link en tu configuración de método de pago para permitir que tus clientes guarden y reutilicen de forma segura su información de pago mediante el botón de proceso de compra rápida con un solo clic de Link.

Pasa el correo electrónico de tu cliente al Payment Element móvil

Link autentica a un cliente utilizando su dirección de correo electrónico. Stripe recomienda completar previamente la mayor cantidad de información posible para optimizar el proceso de compra.

Para completar previamente el nombre, la dirección de correo electrónico y el número de teléfono del cliente, proporciona a defaultBillingDetails la información de tu cliente después de inicializar PaymentSheet.Configuration.

var configuration = PaymentSheet.Configuration()
configuration.defaultBillingDetails.name = "Jenny Rosen"
configuration.defaultBillingDetails.email = "jenny.rosen@example.com"
configuration.defaultBillingDetails.phone = "888-888-8888"

Regístrate para obtener un ID de comerciante de Apple

Obtén un ID de comerciante Apple registrándote para obtener un nuevo identificador en el sitio web de Apple para desarrolladores.

Rellena el formulario incluyendo una descripción y el identificador. La descripción es solo para ti y podrás modificarla después. Stripe te recomienda que uses como identificador el nombre de tu aplicación (por ejemplo, merchant.com.{{YOUR_APP_NAME}}).

Crear un nuevo certificado de Apple Pay

Crea un certificado para que tu aplicación cifre los datos de pago.

Ve a Configuración de certificados de iOS en el Dashboard, haz clic en Añadir aplicación nueva y sigue las indicaciones.

Descarga un archivo de petición de firma de certificado (CSR) para obtener un certificado seguro de Apple que te permita utilizar Apple Pay.

Se debe usar un archivo CSR para emitir un certificado de manera exacta. Si cambias tu ID de comerciante de Apple, debes ir a la Configuración de certificados de iOS en el Dashboard para obtener un CSR y un certificado nuevos.

Integrar con Xcode

Añade la funcionalidad Apple Pay a tu aplicación. En Xcode, abre la configuración del proyecto, selecciona la pestaña Firma y funcionalidades y añade la funcionalidad Apple Pay. Aquí, es posible que se te pida que inicies sesión en tu cuenta de desarrollador. Selecciona el ID de comerciante que creaste antes, y tu aplicación estará lista para aceptar Apple Pay.

Habilita la funcionalidad Apple Pay en Xcode

Añadir Apple Pay

var configuration = PaymentSheet.Configuration()
configuration.applePay = .init(
  merchantId: "merchant.com.your_app_name",
  merchantCountryCode: "US"
)

Seguimiento de pedidos

Para añadir información de seguimiento de pedidos en iOS 16 o versiones posteriores, configura un authorizationResultHandler en tu PaymentSheet.ApplePayConfiguration.Handlers. Stripe llama a tu implementación después de que se haya efectivizado el pago, pero antes de que iOS descarte la hoja de Apple Pay.

En la implementación de authorizationResultHandler, obtén los detalles del pedido del servidor para el pedido completado. Añade los detalles al PKPaymentAuthorizationResult proporcionado y llama al controlador de finalización proporcionado.

Para obtener más información sobre el seguimiento de pedidos, consulta Documentación de Apple sobre los pedidos por monedero.

let customHandlers = PaymentSheet.ApplePayConfiguration.Handlers(
    authorizationResultHandler: { result, completion in
        // Fetch the order details from your service
        MyAPIClient.shared.fetchOrderDetails(orderID: orderID) { myOrderDetails
            result.orderDetails = PKPaymentOrderDetails(
                orderTypeIdentifier: myOrderDetails.orderTypeIdentifier, // "com.myapp.order"
                orderIdentifier: myOrderDetails.orderIdentifier, // "ABC123-AAAA-1111"
                webServiceURL: myOrderDetails.webServiceURL, // "https://my-backend.example.com/apple-order-tracking-backend"
                authenticationToken: myOrderDetails.authenticationToken) // "abc123"
            // Call the completion block on the main queue with your modified PKPaymentAuthorizationResult
            completion(result)
        }
    }
)
var configuration = PaymentSheet.Configuration()
configuration.applePay = .init(merchantId: "merchant.com.your_app_name",
                               merchantCountryCode: "US",
                               customHandlers: customHandlers)

Para habilitar el soporte para el escáner de tarjetas, establece la NSCameraUsageDescription (Privacidad - Descripción del uso de la cámara) en la Info.plist de tu aplicación, y proporciona un motivo para acceder a la cámara (por ejemplo, “Escanear tarjetas”). Los dispositivos con iOS 13 o superior pueden escanear tarjetas.

Para habilitar los pagos con adeudo ACH, debes incluir StripeFinancialConnections como dependencia a tu aplicación.

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.

Todo lo que se quieras personalizar se configura mediante el objeto PaymentSheet.Configuration.

Aspecto

Personaliza los colores y las fuentes, entre otros elementos, para que coincidan con el aspecto de tu aplicación mediante la API Appearance.

Diseño del método de pago

Configura el diseño de los métodos de pago en la hoja usando paymentMethodLayout. Puedes mostrarlos horizontalmente, verticalmente o dejar que Stripe optimice el diseño automáticamente.

var configuration = PaymentSheet.Configuration()
configuration.paymentMethodLayout = .automatic

Recopilar direcciones de usuarios

Recolecta las direcciones de envío o facturación locales e internacionales de tus clientes usando el Address Element.

Nombre con el que aparecerá el comerciante

Configura merchantDisplayName para especificar el nombre de empresa que quieres que vea el cliente. De forma predeterminada, este es el nombre de tu aplicación.

var configuration = PaymentSheet.Configuration()
configuration.merchantDisplayName = "My app, Inc."

Modo oscuro

PaymentSheet se adapta automáticamente a la configuración de aspecto de todo el sistema del usuario (modo claro y modo oscuro). Si tu aplicación no acepta el modo oscuro, puedes establecer el estilo en modo alwaysLight o alwaysDark.

var configuration = PaymentSheet.Configuration()
configuration.style = .alwaysLight

Datos de facturación predeterminados

Para establecer los valores predeterminados para los datos de facturación recopilados en la hoja de pago, configura la propiedad defaultBillingDetails. Los campos de la PaymentSheet se rellenan automáticamente con los valores que proporcionas.

var configuration = PaymentSheet.Configuration()
configuration.defaultBillingDetails.address.country = "US"
configuration.defaultBillingDetails.email = "foo@bar.com"

Recopilación de los datos de facturación

Utiliza billingDetailsCollectionConfiguration para especificar cómo deseas recopilar los detalles de facturación en la hoja de pago.

Puedes recopilar el nombre, el correo electrónico, el número de teléfono y la dirección del cliente.

Si solo quieres los datos de facturación requeridos por el método de pago, establece billingDetailsCollectionConfiguration.attachDefaultsToPaymentMethod como verdadero. En ese caso, los PaymentSheet.Configuration.defaultBillingDetails se establecen como los detalles de facturación del método de pago.

Si quieres recolectar detalles de facturación adicionales que no son necesariamente requeridos por el método de pago, establece billingDetailsCollectionConfiguration.attachDefaultsToPaymentMethod como falso. En ese caso, los detalles de facturación recolectados a través de la PaymentSheet se establecen como los detalles de facturación del método de pago.

var configuration = PaymentSheet.Configuration()
configuration.defaultBillingDetails.email = "foo@bar.com"
configuration.billingDetailsCollectionConfiguration.name = .always
configuration.billingDetailsCollectionConfiguration.email = .never
configuration.billingDetailsCollectionConfiguration.address = .full
configuration.billingDetailsCollectionConfiguration.attachDefaultsToPaymentMethod = true

PaymentSheet almacena cierta información localmente para recordar si un usuario ha utilizado Link dentro de una aplicación. Para borrar el estado interno de PaymentSheet, llama al método PaymentSheet.resetCustomer() cuando tu usuario cierra sesión.

import UIKit
import StripePaymentSheet

class MyViewController: UIViewController {

  @objc
  func didTapLogoutButton() {
    PaymentSheet.resetCustomer()
    // Other logout logic required by your app
  }

}

Puedes presentar la hoja de pago para recopilar solo los datos del método de pago y después llamar al método confirm para completar el pago en la interfaz de usuario de tu aplicación. Esto resulta útil si tienes un botón de compra personalizado o solicitas pasos adicionales después de que se recopilen los datos de pago.

Efectiviza el pago en la interfaz de usuario de tu aplicación

PaymentSheet.FlowController.create(paymentIntentClientSecret: paymentIntentClientSecret, configuration: configuration) { [weak self] result in
  switch result {
  case .failure(let error):
    print(error)
  case .success(let paymentSheetFlowController):
    self?.paymentSheetFlowController = paymentSheetFlowController
    // Update your UI using paymentSheetFlowController.paymentOption
  }
}

paymentSheetFlowController.presentPaymentOptions(from: self) {
  // Update your UI using paymentSheetFlowController.paymentOption
}

paymentSheetFlowController.confirm(from: self) { paymentResult in
  // MARK: Handle the payment result
  switch paymentResult {
  case .completed:
    print("Payment complete!")
  case .canceled:
    print("Canceled!")
  case .failed(let error):
    print(error)
  }
}

Establecer allowsDelayedPaymentMethods en true permite utilizar métodos de pago de notificación diferida como cuentas bancarias de EE. UU. Para estos métodos de pago, el estado final del pago no se conoce cuando se completa la PaymentSheet, sino que se efectúa correctamente o con errores más tarde. Si aceptas este tipo de métodos de pago, infórmale al cliente de que su pedido está confirmado y solo complétalo (por ejemplo, envía el producto) cuando el pago se haya realizado correctamente.

Las siguientes instrucciones para volver a recolectar el CVC de una tarjeta guardada durante la confirmación del PaymentIntent suponen que tu integración incluye lo siguiente:

• Crear PaymentIntents antes de recolectar los datos de pago

Actualizar parámetros de la creación de la intención

Para volver a recolectar el CVC al confirmar el pago, incluye require_cvc_recollection durante la creación del PaymentIntent.

# Create a Customer (use an existing Customer ID if this is a returning customer)
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -X "POST"

# Create an Ephemeral Key for the Customer
curl https://api.stripe.com/v1/ephemeral_keys \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -H "Stripe-Version: 2025-09-30.clover" \
  -X "POST" \
  -d "customer"="{{CUSTOMER_ID}}" \

# Create a PaymentIntent
curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -X "POST" \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "amount"=1099 \
  -d "currency"="eur" \
  -d "payment_method_options[card][require_cvc_recollection]"=true \
  # In the latest version of the API, specifying the `automatic_payment_methods` parameter
  # is optional because Stripe enables its functionality by default.
  -d "automatic_payment_methods[enabled]"=true \