# Apple Pay Permite a los clientes hacer pagos en forma segura con Apple Pay en su iPhone, iPad o Apple Watch. Consulta la [documentación sobre compatibilidad](https://support.apple.com/en-us/HT208531) de Apple para saber cuáles con los dispositivos compatibles con Apple Pay. Apple Pay es compatible con la mayoría de los productos y funciones de Stripe. Los usuarios de Stripe pueden aceptar [Apple Pay](https://stripe.com/apple-pay) en aplicaciones iOS en iOS 9 y versiones posteriores, y en la web en Safari a partir de iOS 10 o macOS Sierra. No hay comisiones adicionales por procesar pagos con Apple Pay, y las [tarifas](https://stripe.com/pricing/local-payment-methods#apple-pay) son las mismas que para otras transacciones con tarjeta. Apple Pay está a disposición de los titulares de tarjeta de bancos que lo aceptan en países admitidos. Para obtener más información, consulta la documentación de Apple sobre los [bancos participantes](https://support.apple.com/en-us/ht204916). #### Propiedades del método de pago - **Ubicaciones de los clientes** En todo el mundo, excepto India - **Moneda de pago** Ver [monedas de pago aceptadas](https://docs.stripe.com/currencies.md#presentment-currencies) - **Confirmación del pago** Iniciada por el cliente - **Familia de métodos de pago** Cartera - **Pagos recurrentes** [Sí](https://docs.stripe.com/apple-pay.md#recurring-payments) - **Plazo de transferencia** Se aplica el plazo de transferencia estándar - **Soporte de Connect** Si - **Soporte para disputas** [Sí](https://docs.stripe.com/apple-pay/disputes-refunds.md#disputed-payments) - **Compatibilidad de la captura manual** Si - **Reembolsos/reembolsos parciales** [Sí/Sí](https://docs.stripe.com/apple-pay/disputes-refunds.md#refunds) #### Ubicaciones de la empresa Las cuentas de Stripe de todo el mundo, excepto de la India, pueden aceptar pagos de Apple Pay en moneda local. #### Soporte de productos - Connect - Checkout1 - Payment Links - Elements - Subscriptions - Invoicing 1Cuando el [ui_mode](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-ui_mode) del proceso de compra es `embedded_page`, solo se admite la versión 17 o una posterior de Safari e iOS. ## Flujo de pago A continuación, se presenta una demostración del flujo de pago de Apple Pay desde la página del proceso de compra: ![Animación de flujo de pagos de Apple Pay que muestra la página de confirmación de compra de Stripe, el botón de Apple Pay y el cuadro de diálogo de confirmación en modo de prueba.](https://b.stripecdn.com/docs-statics-srv/assets/apple-pay.3447ce2deeaab40d6d231eed4dc34644.gif) ## Elegibilidad para compras dentro de la aplicación con Apple Pay En esta guía, se explica cómo configurar tu aplicación a fin de aceptar Apple Pay directamente para bienes físicos, servicios y otros artículos elegibles. Stripe procesa estos pagos y tú solo pagas las [comisiones de procesamiento](https://stripe.com/pricing) de Stripe. Para productos, contenido y suscripciones digitales vendidos en Estados Unidos o en el Espacio Económico Europeo (EEE), tu aplicación puede aceptar Apple Pay mediante una página de pagos externa. Puedes usar las siguientes interfaces de pago: - [Stripe Checkout](https://docs.stripe.com/mobile/digital-goods/checkout.md) - [Elements para la Web](https://docs.stripe.com/mobile/digital-goods/custom-checkout.md) - [Payment Links](https://docs.stripe.com/mobile/digital-goods/payment-links.md) (ideal para cantidades limitadas de productos y precios) En otras regiones, tu aplicación no puede aceptar Apple Pay para productos digitales, contenido o suscripciones. ## Aceptar Apple Pay Stripe ofrece diversos métodos para agregar Apple Pay como método de pago. Para obtener detalles de la integración, selecciona el método que prefieras: # iOS con React Native Puedes usar el Stripe [React Native SDK](https://github.com/stripe/stripe-react-native), para aceptar Apple Pay y pagos tradicionales con tarjeta de crédito. Antes de empezar, debes inscribirte en el [Apple Developer Program](https://developer.apple.com/programs/) y [configurar Stripe en tu servidor y en tu aplicación](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=mobile&platform=react-native#react-native-setup). Luego, sigue estos pasos: 1. [Inscribirse para obtener un ID de comerciante Apple](https://docs.stripe.com/apple-pay.md#merchantid) 1. [Crear un nuevo certificado de Apple Pay](https://docs.stripe.com/apple-pay.md#csr) 1. [Integrarse con Xcode](https://docs.stripe.com/apple-pay.md#xcode-pay) 1. [Definir tu ID de comerciante Apple en StripeProvider](https://docs.stripe.com/apple-pay.md#set-merchantid) 1. [Verificar si se acepta Apple Pay](https://docs.stripe.com/apple-pay.md#check-if-apple-pay-supported) 1. [Presentar la hoja de pago](https://docs.stripe.com/apple-pay.md#present-payment-sheet) 1. [Enviar el pago a Stripe](https://docs.stripe.com/apple-pay.md#handle-payment) > Si usas React Native y Expo, Expo Go no admite Apple Pay. Para usar Apple Pay con Expo, debes crear una [versión de desarrollo](https://docs.expo.dev/get-started/set-up-your-environment/?mode=development-build&platform=ios). Si ya tienes un proyecto de Expo Go, puedes [migrarlo a una versión de desarrollo](https://docs.expo.dev/develop/development-builds/expo-go-to-dev-build/). ## Inscribirse para obtener un ID de comerciante Apple Obtén un ID de comerciante Apple [solicitando un nuevo identificador](https://developer.apple.com/account/resources/identifiers/add/merchant) 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](https://dashboard.stripe.com/settings/ios_certificates) 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](https://dashboard.stripe.com/settings/ios_certificates) 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. ![](https://b.stripecdn.com/docs-statics-srv/assets/xcode.a701d4c1922d19985e9c614a6f105bf1.png) Habilitar la funcionalidad Apple Pay en Xcode ## Definir tu ID de comerciante Apple en StripeProvider En el componente `StripeProvider`, especifica el ID de comerciante Apple que solicitaste con éxito: ```jsx import { StripeProvider } from '@stripe/stripe-react-native'; function App() { return ( {/* Your app code here */} ); } ``` ## Verificar si se acepta Apple Pay Antes de mostrar Apple Pay como opción de pago en tu aplicación, determina si el dispositivo del usuario acepta Apple Pay y si tiene una tarjeta añadida en su billetera: ```jsx import { PlatformPayButton, isPlatformPaySupported } from '@stripe/stripe-react-native'; function PaymentScreen() { const [isApplePaySupported, setIsApplePaySupported] = useState(false); useEffect(() => { (async function () { setIsApplePaySupported(await isPlatformPaySupported()); })(); }, [isPlatformPaySupported]); // ... const pay = async () => { // ... }; // ... return ( {isApplePaySupported && ( )} ); } ``` ## Crear el Payment Intent ### Lado del servidor Crea un punto de conexión que genere un PaymentIntent con un atributo [iamount](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-amount) y [currency](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-currency). Decide cuánto cobrar siempre del lado del servidor, un entorno de confianza, no del lado del cliente. Esto impide que clientes malintencionados puedan elegir sus propios precios. #### curl ```bash curl https://api.stripe.com/v1/payment_intents \ -u <>: \ -d "amount"=1099 \ -d "currency"="usd" ``` ### Lado del cliente Crea un método que solicite un PaymentIntent desde tu servidor: ```jsx function PaymentScreen() { // ... const fetchPaymentIntentClientSecret = async () => { const response = await fetch(`${API_URL}/create-payment-intent`, { method: 'POST', headers: { 'Content-Type': 'application/json', }, body: JSON.stringify({ some: 'value', }), }); const { clientSecret } = await response.json(); return clientSecret; }; // ... } ``` ### Resolución de problemas Si estás viendo errores de la API de Stripe al intentar crear tokens, lo más probable es que tengas un problema con tu certificado de Apple Pay. Deberás generar un nuevo certificado y subirlo a Stripe, como se describe en esta página. Asegúrate de usar una solicitud de firma de certificado (CSR) obtenida de tu Dashboard y no una que hayas generado tú. Xcode a menudo almacena en caché incorrectamente los certificados antiguos, por lo que además de generar un nuevo certificado, Stripe también recomienda crear un nuevo ID de comerciante de Apple. Si recibes el error: > No has agregado tu cuenta de comerciante de Apple a Stripe es probable que tu aplicación esté enviando datos encriptados con un CSR/Certificado anterior (que no sea de Stripe). Asegúrate de que todos los certificados generados por CSR que no sean de Stripe se revoquen en tu ID de comerciante de Apple. Si esto no resuelve el problema, elimina el ID del comerciante en tu cuenta de Apple y vuelve a crearlo. Luego, crea un nuevo certificado basado en la misma CSR (proporcionada por Stripe) que se utilizó anteriormente. No es necesario que cargues este nuevo certificado en Stripe. Cuando termines, activa y desactiva las Credenciales de Apple Pay en tu aplicación para asegurarte de que se actualicen correctamente. ## Presentar la hoja de pago En tu [`PlatformPayButton`](https://stripe.dev/stripe-react-native/api-reference/index.html#PlatformPayButton) `onPress` prop, llama a `confirmPlatformPayPayment` para abrir una hoja de Apple Pay. Para mostrar las partidas del carrito del cliente en la hoja de pago, pasa las partidas como argumento. La partida final debe representar a tu empresa y al total. Aparece en la hoja con la palabra «Paga a» antepuesta (por ejemplo, «Paga a iHats, Inc. USD 50»). > No incluyas ninguna acción compleja o asíncrona en el código que maneja la acción del cliente antes de mostrar la hoja de pago. Si la acción del usuario no invoca directamente la hoja de pago, Apple Pay arroja un error. ```jsx import { confirmPlatformPayPayment } from '@stripe/stripe-react-native'; function PaymentScreen() { // ... see above const pay = async () => { const clientSecret = await fetchPaymentIntentClientSecret() const { error, paymentIntent } = await confirmPlatformPayPayment( clientSecret, { applePay: { cartItems: [ { label: 'Example item name', amount: '14.00', paymentType: PlatformPay.PaymentType.Immediate, }, { label: 'Tax', amount: '1.60', paymentType: PlatformPay.PaymentType.Immediate, }, { label: 'iHats, Inc.', amount: '15.60', paymentType: PlatformPay.PaymentType.Immediate, }, ], merchantCountryCode: 'US', currencyCode: 'USD', requiredShippingAddressFields: [ PlatformPay.ContactField.PostalAddress, ], requiredBillingContactFields: [PlatformPay.ContactField.PhoneNumber], }, } ); if (error) { // handle error } else { Alert.alert('Success', 'Check the logs for payment intent details.'); console.log(JSON.stringify(paymentIntent, null, 2)); } }; // ... see above } ``` ## Optional: Crear un método de pago [Lado del cliente] Si confirmas el pago en tu servidor, puedes usar Apple Pay solo para recopilar un `PaymentMethod` , en lugar de para confirmar el pago. Para hacerlo, llama al método `createPlatformPayPaymentMethod`: ```javascript import {PlatformPayButton, isPlatformPaySupported, createPlatformPayPaymentMethod} from '@stripe/stripe-react-native'; function PaymentScreen() { const [isApplePaySupported, setIsApplePaySupported] = useState(false); useEffect(() => { (async function () { setIsApplePaySupported(await isPlatformPaySupported()); })(); }, [isPlatformPaySupported]); const createPaymentMethod = async () => { const { error, paymentMethod } = await createPlatformPayPaymentMethod({ applePay: { cartItems: [ { label: 'Example item name', amount: '14.00', paymentType: PlatformPay.PaymentType.Immediate, }, { label: 'Total', amount: '12.75', paymentType: PlatformPay.PaymentType.Immediate, }, ], merchantCountryCode: 'US', currencyCode: 'USD', }, }); if (error) { Alert.alert(error.code, error.message); return; } else if (paymentMethod) { Alert.alert( 'Success', `The payment method was created successfully. paymentMethodId: ${paymentMethod.id}` ); } }; return ( {isApplePaySupported && ( )} ); } ``` ## Optional: Pagos recurrentes [Lado del cliente] En iOS 16 o versiones posteriores, puedes adoptar [tokens de comerciante](https://developer.apple.com/apple-pay/merchant-tokens/) estableciendo el campo `request` en el objeto de parámetros `applePay` de `confirmPlatformPayPayment()` y `confirmPlatformPaySetupIntent`. ```js await confirmPlatformPayPayment( clientSecret, { applePay: { // Make sure to include the rest of the necessary fields request: { type: PlatformPay.PaymentRequestType.Recurring, description: 'String describing my payment', managementUrl: 'www..com', billing: { paymentType: PlatformPay.PaymentType.Recurring, intervalUnit: PlatformPay.IntervalUnit.Month, intervalCount: 3, label: 'My label', amount: '39.00', }, }, }, } ); ``` Para obtener más información sobre cómo usar los pagos recurrentes con Apple Pay, consulta [Documentación de PassKit de Apple](https://developer.apple.com/documentation/passkit/pkpaymentrequest). ## Optional: Seguimiento de pedidos [Lado del cliente] Para adoptar [seguimiento de pedidos](https://developer.apple.com/design/human-interface-guidelines/technologies/wallet/designing-order-tracking) en iOS 16 o versiones posteriores, usa la devolución de llamada `setOrderTracking` para el componente `PlatformPayButton`. En tu implementación: 1. Obtén los detalles del pedido de su servidor para el pedido finalizado. 1. Llama al controlador de finalización proporcionado en `setOrderTracking` con los resultados de tu servidor. ```jsx { const { orderIdentifier, orderType, authToken, webServiceUrl } = fetchOrderDetailsFromMyBackend(); completion(orderIdentifier, orderType, authToken, webServiceUrl); }} /> ``` Para obtener más información sobre el seguimiento de pedidos, consulta la [Documentación sobre pedidos de billetera de Apple](https://developer.apple.com/documentation/walletorders). ## Prueba Apple Pay Para probar Apple Pay, debes usar un número de tarjeta de crédito real y tus [claves de API](https://docs.stripe.com/keys.md) de prueba. Stripe reconoce que estás en modo de prueba y te devuelve un token de tarjeta de prueba correcto para que puedas realizar pagos de prueba con una tarjeta activa sin realizarle cargos. No puedes guardar [tarjetas de prueba de Stripe](https://docs.stripe.com/testing.md#use-test-cards) ni [tarjetas de prueba de Apple Pay](https://developer.apple.com/apple-pay/sandbox-testing/) en carteras de Apple Pay para probar esta aplicación. ## See also - [Integración iOS](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=mobile&platform=ios) - [Apple Pay en la web](https://docs.stripe.com/elements/express-checkout-element.md) - [Prácticas recomendadas de Apple Pay](https://docs.stripe.com/apple-pay/best-practices.md)