Crea cargos y envíos de fondos separados

Inscribirse para obtener un ID de comerciante Apple

Obtén un ID de comerciante Apple solicitando un nuevo identificador en el sitio web de desarrolladores de Apple.

Completa el formulario con una descripción y el identificador. La descripción es para tus registros y se puede modificar en el futuro. Stripe recomienda usar el nombre de tu aplicación como identificador (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 Agregar nueva aplicación y sigue la guía.

Descarga un archivo de solicitud 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 exactamente un certificado. Si cambias tu ID de comerciante de Apple, debes ir a la Configuración de certificados de iOS en el Dashboard para obtener una nueva CSR y un nuevo certificado.

Integrarse con Xcode

Agrega la funcionalidad Apple Pay a tu aplicación. En Xcode, abre la configuración del proyecto, selecciona la pestaña Firma y funcionalidades y agrega la funcionalidad Apple Pay. En este paso, quizá se te solicite iniciar 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.

Habilitar la funcionalidad Apple Pay en Xcode

Agregar Apple Pay

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

Seguimiento de pedidos

Para agregar información de seguimiento de pedidos en iOS 16 o posterior, configura un authorizationResultHandler en tu PaymentSheet.ApplePayConfiguration.Handlers. Stripe llamará a tu implementación después de que se efectivice el pago, pero antes de que iOS descarte la hoja de Apple Pay.

En la implementación de authorizationResultHandler, puedes obtener los datos del pedido del servidor para el pedido completado. Agrega los datos al PKPaymentAuthorizationResult proporcionado y llama al controlador de finalización proporcionado.

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

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)

A fin de habilitar el soporte para escaneo de tarjetas, establece NSCameraUsageDescription (Privacidad - Descripción del uso de la cámara) en el Info.plist de tu aplicación y especifica el motivo por el que se necesita acceder a la cámara (por ejemplo, “Para escanear tarjetas”). Los dispositivos con iOS 13 o posterior aceptan el escaneo de tarjetas.

Todo lo que se quiera personalizar se configura usando el objeto PaymentSheet.Configuration.

Appearance

Personaliza los colores y las fuentes, entre otros elementos, para que combinen 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 de manera automática.

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

Recopilar las direcciones de los usuarios

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

Nombre de pantalla para el comerciante

Especifica un nombre de empresa que vea el cliente configurando merchantDisplayName. De manera 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 admite el modo oscuro, puedes definir 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

Usa billingDetailsCollectionConfiguration para especificar cómo deseas recopilar los datos 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 en true. En ese caso, PaymentSheet.Configuration.defaultBillingDetails se establece como los datos de facturación del método de pago.

Si quieres recopilar datos de facturación adicionales que no son necesariamente requeridos por el método de pago, establece billingDetailsCollectionConfiguration.attachDefaultsToPaymentMethod en false. En ese caso, los datos de facturación recopilados mediante la PaymentSheet se establecen como los datos 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

Puedes presentar la hoja de pago para recopilar solo los datos del método de pago y luego 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 recopilar los datos del pago.

Completa 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)
  }
}

Si el PaymentSheetResult es .completed, infórmale al usuario (por ejemplo, mostrándole una pantalla de confirmación del pedido).

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

Ve a Administrar métodos de pago para cuentas conectadas en el Dashboard para configurar qué métodos de pago aceptan tus cuentas conectadas. Los cambios en la configuración predeterminada se aplican a todas las cuentas conectadas nuevas y existentes.

Consulta los siguientes recursos para obtener información sobre los métodos de pago:

• Guía de métodos de pago para ayudarte a elegir los métodos de pago correctos para tu plataforma.
• Funcionalidades de cuenta para asegurarte de que los métodos de pago que elegiste funcionen en tus cuentas conectadas.
• Consulta las tablas de admisibilidad de métodos de pago y de productos para asegurarte de que los métodos de pago elegidos funcionen para tus productos y flujos de pago de Stripe.

Para cada método de pago, puedes seleccionar una de las siguientes opciones desplegables:

Opciones de métodos de pago

Si realizas un cambio en un método de pago, debes hacer clic en Revisar cambios en la barra inferior de la pantalla y en Guardar y aplicar para actualizar tus cuentas conectadas.

Cuadro de diálogo Guardar

Permite que las cuentas conectadas gestionen los métodos de pago

Stripe recomienda permitir que tus cuentas conectadas personalicen sus propios métodos de pago. Esta opción le permite a cada cuenta conectada con acceso al Dashboard de Stripe ver y actualizar página Métodos de pago. Solo los propietarios de las cuentas conectadas pueden personalizar sus métodos de pago. El Dashboard de Stripe muestra el conjunto de métodos de pago predeterminados que aplicaste a todas las cuentas conectadas nuevas y existentes. Tus cuentas conectadas pueden anular estos valores predeterminados, excluyendo los métodos de pago que hayas bloqueado.

Marca la casilla de verificación Personalización de la cuenta para habilitar esta opción. Debes hacer clic en Revisar cambios en la barra inferior de la pantalla y luego seleccionar Guardar y aplicar para actualizar esta configuración.

Casilla de verificación de personalización de la cuenta

Capacidades de métodos de pago

Para permitir que tus cuentas conectadas acepten métodos de pago adicionales, debes asegurarte de que sus cuentas conectadas tengan funcionalidades activas para cada método de pago. La mayoría de los métodos de pago tienen los mismos requisitos de verificación que la funcionalidad card_payments, con algunas restricciones y excepciones. La tabla de funcionalidades de métodos de pago enumera los métodos de pago que requieren verificación adicional de las tarjetas.