Integrando Apple Pay en tu aplicación de comercio electrónico Ios

Paso 3: Permite la capacidad de pago de Apple en Xcode

Abra su proyecto en Xcode y vaya a la pestaña Signing & Capabilities. Haga clic en el botón de plus para agregar una nueva capacidad y seleccione Apple Pay. Xcode actualizará automáticamente su archivo de derechos para incluir el derecho de Apple Pay. Agregue su ID de mercante en la sección de Apple Pay de la configuración de la capacidad. Si tiene múltiples IDs de mercader para diferentes entidades de negocios, puede enumerar todos ellos, pero su código debe referenciar el correcto para cada solicitud de pago.

Paso 4: Importar PassKit y crear una solicitud de pago

El marco PassKit proporciona todas las clases necesarias para la integración de Apple Pay. Importe PassKit en su controlador de vista de salida. Cree un objeto PKPaymentRequest y configure sus propiedades. Establecer el identificador de comerciantes para que coincida con el registrado en el Portal de Desarrolladores. Especifique las redes de pago compatibles como Visa, Mastercard, Amex y Discover. Define las capacidades de comerciante; al menos incluya .capability3DS para apoyar los artículos de pago total de tres puntos de pago

Aquí hay un ejemplo práctico de configurar una solicitud de pago:

import PassKit

let paymentRequest = PKPaymentRequest()
paymentRequest.merchantIdentifier = "merchant.com.yourcompany.app"
paymentRequest.supportedNetworks = [.amex, .masterCard, .visa, .discover]
paymentRequest.merchantCapabilities = [.capability3DS, .capabilityEMV]
paymentRequest.countryCode = "US"
paymentRequest.currencyCode = "USD"

let item1 = PKPaymentSummaryItem(label: "Product Name", amount: NSDecimalNumber(string: "49.99"))
let tax = PKPaymentSummaryItem(label: "Tax", amount: NSDecimalNumber(string: "4.50"))
let shipping = PKPaymentSummaryItem(label: "Shipping", amount: NSDecimalNumber(string: "5.99"))
let total = PKPaymentSummaryItem(label: "Your Store Name", amount: NSDecimalNumber(string: "60.48"))
paymentRequest.paymentSummaryItems = [item1, tax, shipping, total]

Paso 5: Presentar la hoja de pago de Apple

Después de configurar la solicitud de pago, compruebe si el dispositivo del usuario admite Apple Pay y si tienen alguna tarjeta elegible. Use PKPaymentAuthorizationViewController para presentar la hoja de pago. Se trata de una interfaz de usuario proporcionada por el sistema que mantiene la apariencia y la sensación de Apple Pay familiar. Presente de forma modulada sobre la pantalla de checkout. El controlador de visión maneja la selección de tarjetas, entrada de dirección de envío, y la auten biométrica en su nombre.

Para comprobar el soporte del dispositivo y presentar la hoja:

if PKPaymentAuthorizationViewController.canMakePayments(usingNetworks: paymentRequest.supportedNetworks) {
 let authorizationVC = PKPaymentAuthorizationViewController(paymentRequest: paymentRequest)
 authorizationVC?.delegate = self
 present(authorizationVC, animated: true, completion: nil)
} else {
 // Fallback to manual card entry or show a message
}

Paso 6: Autorización de pago de mango

Implementar el PKPaymentAuthorizationViewControllerDelegar métodos para manejar el resultado de pago. El delegado recibe un pago token después de una autorización exitosa. Extraiga los datos de ficha y envíelo a su servidor de backend. Su servidor luego envía el token a su procesador de pago para la creación de cargo. Después de que se confirme el cargo, desactive la hoja de pago y actualice el método de confirmación de su aplicación.

Aplicación de los métodos principales de delegación:

func paymentAuthorizationViewController(_ controller: PKPaymentAuthorizationViewController, didAuthorizePayment payment: PKPayment, handler completion: @escaping (PKPaymentAuthorizationResult) -> Void) {
 let token = payment.token
 // Send token to your backend for processing
 // On success, call completion with .success
 // On failure, call completion with .failure
 completion(PKPaymentAuthorizationResult(status: .success, errors: nil))
}

Paso 7: Configurar las opciones de envío y facturación

Apple Pay admite la selección de direcciones de envío dinámicas y actualizaciones de métodos de envío. Puede configurar métodos de envío en la solicitud de pago e implementar métodos de delegado que recalculan los totales cuando el usuario cambia su dirección de envío o selecciona una opción de envío diferente. Esto proporciona una experiencia de checkout en tiempo real sin exigir al usuario que abandone la hoja de Apple Pay. Para la lógica de envío compleja, llame a su API de backend para calcular las tarifas basadas en la dirección del usuario y el contenido de su carrito.

Paso 8: Prueba con el entorno de la caja de arena

Apple proporciona un entorno de caja de arena para probar Apple Pay sin dinero real. Cree una cuenta de prueba de sandbox en el Portal de Desarrolladores de Apple. Utilice los números de tarjetas de prueba proporcionados por Apple para simular diferentes tipos de tarjetas y escenarios. Instale su aplicación con un certificado de desarrollo en un dispositivo físico. Verifique que la hoja de pago aparece correctamente, que todas las opciones de red se muestran, que los cálculos de envío funcionan, y que la autorización tiene éxito.

Integrando con Su Backend y Directus

Enviar fichas de pago a su servidor

Después de recibir el token de pago de Apple Pay, su aplicación iOS necesita transmitirlo a su servidor de backend de forma segura. Utilice HTTPS con la autenticación adecuada. El token contiene un objeto de datos de pago opaco que su procesador de pagos descifrará. Su servidor debe validar el token, crear una carga usando el SDK de su procesador, y devolver un éxito o respuesta de fallo.

Datos de la Orden de Cuaderno en Directus

Directus le permite definir colecciones personalizadas que coincidan con su modelo de datos de comercio electrónico. Cree colecciones para pedidos, artículos de pedido y pagos. Cuando una transacción se completa, su backend escribe los datos de pedido a Directus a través de su API de REST o GraphQL. Puede almacenar metadatos específicos de Apple Pay como la red de pago utilizada, los últimos cuatro dígitos del número de cuenta del dispositivo, y el ID de transacción.

Manejo de Webhooks de los procesadores de pago

La mayoría de los procesadores de pago envían webhooks para notificar a su backend sobre eventos tales como los éxitos de carga, fallos y reembolsos. Su backend debe manejar estos juegos web y actualizar los correspondientes registros de pedidos en Directus. Por ejemplo, cuando se reembolsa un cargo, su administrador de Webhook actualiza el estado de pedido para reembolsar en Directus. Esto mantiene su sistema sincronizado con el estado del procesador de pago.

Consideraciones avanzadas

Apoyo a múltiples curvas y locales

Si su aplicación de comercio electrónico funciona en varios países, configura la solicitud de pago con el código de país y código de divisas adecuado basado en la configuración de ubicación o tienda del usuario. Apple Pay admite más de 60 países y regiones. Asegúrese de que su procesador de pagos puede manejar las monedas que usted planea aceptar. Pruebe cada combinación local a fondo para evitar fallos de comprobación debido a restricciones regionales.

Actualización de los precios del producto en tiempo real

Los precios del producto pueden cambiar debido a promociones, fluctuaciones de divisas o ajustes de inventario. Desde Directus sirve como su fuente de contenido y datos, su aplicación hace que los precios actuales del producto antes de presentar la hoja de Apple Pay. Esto evita situaciones en las que el usuario ve un precio en el catálogo de productos y un precio diferente al checkout. Implementa un mecanismo de actualización que sincroniza los últimos totales del carrito cada vez que el usuario llega a la pantalla de checkout.

Manejo de errores y comentarios de usuarios

Las fallas de pago pueden ocurrir por muchas razones: problemas de red, declive de tarjeta, despilfarros de procesadores o fichas inválidas. Proporcionar mensajes de error claros y factibles en su aplicación. Evite la jerga técnica. Si un pago falla, permita al usuario volver a iniciar Apple Pay o volver a la entrada de la tarjeta manual. Errores de registro en Directus con suficiente detalle para depurar al tiempo.

Estrategia de Pruebas para la Lecturas de Producción

Pruebas de caja de arena

Prueba con varios tipos de tarjetas incluyendo Visa, Mastercard y Amex. Verifica que la hoja de pago muestra los totales correctos y las opciones de envío. Prueba con diferentes dispositivos de Apple y versiones iOS. Confirma que tus métodos de delegado manejan la autorización, cancelación y errores correctamente. Repita las pruebas después de hacer cambios en tu configuración o código de pago.

Pruebas internas de la beta

Antes de publicarse, ejecute pruebas internas de beta con usuarios reales de Apple Pay. Use TestFlight para distribuir la aplicación a un pequeño grupo de testers. Recoge la información sobre el flujo de checkout y monitorea las tasas de éxito de transacción. Compruebe que los datos del pedido popula correctamente en Directus. Verifique que los eventos webhook actualizan los estados del pedido correctamente.

Supervisión de la producción

Después de lanzar Apple Pay, monitorear las métricas de transacción en su panel de procesadores de pagos y en Directus. Rastrear el número de transacciones de Apple Pay, valor promedio de transacción, tasas de fallos y códigos de error. Establecer alertas para los puntos de falla inusuales. Use Análisis Directus para comparar las tasas de conversión entre usuarios de Apple Pay y usuarios que eligen otros métodos de pago.

Pitfalls comunes y cómo evitarlos

Desapareciendo la configuración de identificación de Merchant

Un problema frecuente es un ID comercial incorrecto o faltante en el archivo de derechos o en el código de solicitud de pago. Verifique que la cadena de identificación comercial coincide exactamente con lo que se registró en el Portal de Desarrolladores. Verifique que la capacidad de Apple Pay está habilitada para todos los objetivos de aplicación que lo utilizan.

Implementación de Delegado de Pago Incompleto

Si sus métodos de delegado no se implementan completamente, la hoja de pago no puede desestimar correctamente o la autorización puede colgar. Implementar tanto el manejador de autorización como el método de delegado de despido. Asegúrese de que usted llame al manejador de terminación con un PKPaymentAuthorizationResult válido.

Cuestiones de configuración de red

Apple Pay requiere acceso a la red para verificar la información de la tarjeta del dispositivo y procesar las transacciones. Si su aplicación utiliza un firewall o configuración de redes personalizadas, asegúrese de que el tráfico de Apple Pay no está bloqueado. Prueba en diferentes tipos de red, incluyendo Wi-Fi y celular para confirmar una operación confiable.

Consideraciones finales

Integrar Apple Pay en tu aplicación de comercio electrónico de iOS es una de las mejoras de mayor impacto que puedes hacer para las tasas de conversión móvil. La combinación de velocidad, seguridad y confianza de usuario crea una experiencia de checkout que los usuarios aprecian y vuelven a. Cuando se combina con un backend flexible como Directus, mantienes el control completo sobre tus datos de producto y pedido al tiempo que proporcionas un flujo de pago de clase mundial.