Capacitor 앱에서 새로운 애플 지침을 따르는 Stripe 결제 링크 구현

2025년 5월 1일부터, 애플은 에픽 v. 애플 사례 판결에 따라 앱 스토어 리뷰 지침을 크게 변경했습니다. 이 변경 사항은 미국의 앱 개발자들이 디지털 상품과 서비스에 대한 외부 결제 방법에 대한 링크를 제공할 수 있도록 허용하며, 애플의 인앱 구매 시스템에 대한 대안을 열어줍니다. Epic v. Apple case. These changes specifically allow app developers in the United States to link out to external payment methods for digital goods and services, opening up alternatives to Apple’s in-app purchase system.

The Epic Battle That Changed Mobile Payments Forever

이 순간에 이르기까지의 길은 오랜 시간 동안 논쟁의 여지가 많았습니다. 2020년 8월 에픽 게임즈가 개발한 인기 게임인 포트나이트의 개발자 에픽 게임즈가 애플의 앱 스토어 지침을 위반하기 위해 직접 결제 옵션을 구현했습니다. 이로 인해 애플은 포트나이트를 앱 스토어에서 제거하고 에픽은 애플의 iOS 앱 배포 및 인앱 결제에 대한 통제를 주장하는 소송을 제기했습니다.

법적 분쟁, 항소, 반항소가 수년 동안 계속되었습니다. 최종적으로 법원은 iOS 앱 배포 및 인앱 결제에 대한 애플의 통제를 주장하는 소송에서 승소했습니다. 앱 스토어 생태계의 경제 모델은 2008년부터 시작된 이래로 기본적인 금융 모델로 운영되어 왔습니다.

최종 판결 - 더 이상 항소할 수 없음

이 판결이 특히 중요하다는 것은 Apple의 항소가 2025년 초에 미국 대법원에서 기각되었기 때문입니다. 이로 인해 하급 법원의 판결이 법률의 원칙으로 확립되었습니다. 따라서 개발자는 Apple이 이 결정에 대한 추가 법적 도전을 통해 이 결정이 뒤집히지 않는다는 자신감으로 외부 결제 방법을 구현할 수 있습니다.

법률에 의해 보장되는 평등

중요한 것은 Apple이 외부 결제 방법을 사용하는 앱에 대해 차별할 수 없다는 판결입니다. 법원은 Apple이 다음과 같은 것을 금지했습니다:

애플이 외부 결제 방법을 사용하는 앱에 추가 요금을 부과하거나 추가 요구 사항을 부과하는 경우
애플의 IAP 시스템을 exclusivley 사용하는 앱에 선호하는 검색 결과 또는 특징을 제공하는 경우
외부 결제 경험을 애플의 시스템보다 불리하게 만드는 기술적 조치를 취하는 경우
고객 정보를 기본적으로 제공하는 것 이상의 부담스러운 공개 요구 사항을 부과하는 경우

이러한 명확한 보호 조치가 있으므로 개발자는 스트라이프 또는 다른 외부 결제 제공자와 협력할 수 있으며, 애플의 은밀한 복수 또는 차별로부터 자유로울 수 있습니다. 플레이어 필드가 법적으로 평준화되었으며, 애플은 앱의 결제 방법 선택에 관계없이 모든 앱을 동일하게 다루어야 합니다.

이 판결은 애플의 벽으로 둘러싸인 정원 접근 방식에 대한 가장重大한 도전 중 하나를 대표하며, 모바일 앱 수익화가 어떻게 작동해야 하는지에 대한 전환점을 표시합니다. 개발자들이 오랫동안 애플의 30% 수수료 (소규모 사업체의 경우 15%)에 대해 불만을 표명해 왔는데, 이 판결은 더 높은 수익 마진과 고객 경험에 대한 더 많은 통제를 제공하는 길을 열어줍니다.

스트라이프를 사용하는 대신 애플의 인앱 구매를 사용하는 경우의 금융 이익

이 변화의 금융적 영향은 개발자에게 다음과 같은 결과를 가져옵니다.

결제 처리 수수료의 감소애플은 일반적으로 인앱 구매에 대해 30%의 수수료를 부과하며 (소규모 사업체의 경우 15%), 스트라이프의 수수료는 거래당 약 2.9% + $0.30입니다. 이 차이는 수익 마진이 크게 증가할 수 있습니다.
빠른 지불: Apple에서, 일반적으로 45-90일 동안 자금을 받을 수 있습니다. 반면, Stripe은 2-3일 이내에 2-3일 이내에 고객의 은행 계좌에 입금합니다.
Simplified Refund Process: Apple의 복잡한 환불 시스템 대신 Stripe의 대시보드를 통해 환불을 직접 처리할 수 있습니다.

이러한 비용 절감 및 향상된 현금 흐름은 특히 작은 개발자 및 기업에게 게임 체이저일 수 있습니다.

이 기사에서는 Capacitor 앱에서 이러한 새로운 규칙을 활용하고 Apple의 업데이트된 지침에 따라 준수하는 데 필요한 Capacitor 앱에서 Stripe Payment Links를 구현하는 방법을 살펴보겠습니다. 업데이트된 지침.

이 구현은 Stripe의 공식 문서에서 Payment Links에 대한 설명을 기반으로 하며 __CAPGO_KEEP_0__ 앱에 적합하게 수정되었습니다., adapted specifically for Capacitor apps.

업데이트된 App Store Review Guidelines에서는 개발자가 디지털 상품 및 구독과 관련하여 사용자를 외부 웹사이트로 안내할 수 있도록 허용합니다. 이 변경은 현재 미국 App Store에서만 적용됩니다.

중요한 이해 요약:

key points to understand:

You can now link to external payment options for digital goods within your app
This only applies to apps in the U.S. App Store
You must still comply with Apple’s disclosure requirements
You remain responsible for all customer support and refund handling

Capacitor 앱에서 Stripe 결제 링크를 설정하는 방법

기술적인 구현에 대해 자세히 알아보겠습니다:

1단계: Stripe 대시보드에서 결제 링크를 생성하세요

먼저 Stripe 대시보드에서 결제 링크를 생성하세요:

Stripe 대시보드의 결제 링크 섹션으로 이동하세요
새 결제 링크를 생성하려면 '+' 버튼을 클릭하세요
상품 또는 구독 정보를 정의하세요
결제 후 설정에서 '결제 확인 페이지를 표시하지 않음'을 선택하세요
universal 링크를 성공 URL로 설정하세요 (이것은 나중에 설정할 것입니다)
결제 링크를 생성하기 위해 "Create Link"를 클릭하세요

2단계: Capacitor 앱에서 universal 링크 설정

결제 완료 후 사용자를 앱으로 되돌리기 위해 universal 링크를 구성하세요:

Create an apple-app-site-association __CAPGO_KEEP_0__ 도메인에

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appIDs": ["YOURTEAMID.com.yourdomain.yourapp"],
        "components": [
          {
            "/": "/checkout_redirect*",
            "comment": "Matches any URL whose path starts with /checkout_redirect"
          }
        ]
      }
    ]
  }
}

이 파일을 https://yourdomain.com/.well-known/apple-app-site-association
이 파일이 올바른 MIME 타입으로 제공되는지 확인하세요 application/json
Capacitor 앱을 universal 링크를 처리하도록 구성하려면 올바른 권한을 추가하세요. 먼저, capacitor.config.ts:

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  // Your existing app configuration (appId, appName, etc.)
  plugins: {
    Geolocation: {
      // Request precise location access on iOS
      iosLocationAccuracy: 'reduced'
    }
  }
};

export default config;

Xcode 프로젝트에 Associated Domains 권한을 추가하세요:
- Xcode 프로젝트를 열어
- 앱 목표를 선택하세요
- ‘인증 및 기능성’으로 이동하세요.
- ‘+ 기능성’ 클릭하고 ‘연관된 도메인’을 선택하세요.
- 추가 applinks:yourdomain.com

3단계: fallback 페이지 만들기

fallback 페이지를 만들려면 redirect URL에서 처리할 수 있는 앱이 설치되지 않은 경우를 대비하세요:

<!DOCTYPE html>
<html>
<head>
  <title>Redirecting...</title>
  <meta http-equiv="refresh" content="0;url=https://yourdomain.com/app-download">
</head>
<body>
  <p>Redirecting to download page...</p>
</body>
</html>

4단계: Capacitor 앱에 결제 버튼을 Implement하세요.

앱에 결제 버튼을 추가하세요:

import { Capacitor } from '@capacitor/core';

export async function openPaymentLink(userEmail, userId) {
  // Use your actual Stripe payment link
  const baseUrl = 'https://buy.stripe.com/your_payment_link';
  
  // Add URL parameters to customize the experience
  const params = new URLSearchParams({
    prefilled_email: encodeURIComponent(userEmail),
    client_reference_id: userId
  });

  const fullUrl = `${baseUrl}?${params.toString()}`;
  
  // Simple window.open works in both web and Capacitor
  // Using _blank opens in Safari on iOS which is important for users with saved Stripe Link credentials
  window.open(fullUrl, '_blank');
}

사파리 중요성결제 링크를 사파리(via )로 열면( )인앱 브라우저보다 유용합니다. 사용자가 이전에 스티프 링크와 결제 정보를 저장한 경우, 자동으로 인증 정보가 제공되기 때문에, 사용자가 다시 신용 카드 정보를 입력하지 않아도 체크아웃 경험을 더 편리하게 할 수 있습니다. 이는 사용자가 신용 카드 정보를 다시 입력하지 않아도 되는 체크아웃 경험을 제공하여, 사용자 탈출률을 크게 줄일 수 있습니다. window.open5단계: 앱에서 Universal Links를 처리하세요.

앱을 구성하여 사용자가 다시 리다이렉트 될 때 Universal Links를 처리하세요:

5단계: 앱에서 Universal Links를 처리하세요.

첫 번째로 App 플러그인을 설치하세요:

npm install @capacitor/app

App 플러그인을 앱에 등록하세요:

import { App } from '@capacitor/app';

// In your initialization code
App.addListener('appUrlOpen', (event) => {
  // Example URL: https://yourdomain.com/checkout_redirect?session_id=cs_test_...
  const url = new URL(event.url);
  
  if (url.pathname.startsWith('/checkout_redirect')) {
    // Extract any parameters you need
    const params = new URLSearchParams(url.search);
    const sessionId = params.get('session_id');
    
    // Handle successful payment
    if (sessionId) {
      // Verify the payment on your server if needed
      verifyPayment(sessionId);
      
      // Update UI to reflect successful purchase
      updatePurchaseStatus(true);
    }
  }
});

async function verifyPayment(sessionId) {
  // Call your backend to verify the payment
  // This is optional if you're relying on webhooks
}

function updatePurchaseStatus(success) {
  // Update your app UI to reflect purchase status
}

6단계: 주문 완료를 위한 웹훅 설정

마지막으로, 서버에서 성공적인 결제를 처리하는 웹훅을 구성하세요:

// Using Express.js as an example
const express = require('express');
const stripe = require('stripe')('sk_test_your_stripe_secret_key');
const app = express();

// Use raw body parser for webhook signature verification
app.post('/webhook', express.raw({type: 'application/json'}), async (req, res) => {
  const sig = req.headers['stripe-signature'];
  const webhookSecret = 'whsec_your_webhook_secret';
  
  let event;
  
  try {
    event = stripe.webhooks.constructEvent(req.body, sig, webhookSecret);
  } catch (err) {
    console.log(`Webhook Error: ${err.message}`);
    return res.status(400).send(`Webhook Error: ${err.message}`);
  }
  
  // Handle the checkout.session.completed event
  if (event.type === 'checkout.session.completed') {
    const session = event.data.object;
    
    // Retrieve client_reference_id (your user ID)
    const userId = session.client_reference_id;
    
    // Grant access to the purchased content
    await grantAccess(userId, session.id);
  }
  
  res.status(200).send();
});

async function grantAccess(userId, sessionId) {
  // Your logic to grant access to the purchased content
  // This could be updating a database, sending a notification, etc.
}

app.listen(3000, () => console.log('Webhook server running on port 3000'));

안드로이드 호환성

우리는 분명히 말할 것입니다: 에픽 v. 애플 판결은 모바일 결제 환경을根本적으로 바꾸었습니다. iOS 앱에 직접적인 영향을 미치는 것은 물론, Android 개발자들이 외부 결제 방법을 사용해 왔던 것을 강화시켰습니다.

Android 개발자들은 이제 외부 결제 솔루션을 완벽한 자신감으로 implement할 수 있습니다. 애플 판결에 의해 설정된 전례는 개발자들이 플랫폼을 막론하고 잠재적인 미래 제한으로부터 보호합니다. 이 법적 판결은 많은 Android 개발자들이 이미 몇 년 동안 수행해 왔던 것과 동일한 것을 확인했습니다 - 낮은 수수료의 대안 결제 옵션을 제공합니다.

구글 플레이 스토어는 항상 애플보다 외부 결제 방법에 대한 제한이 적었으며, 법적 전례가established되었으므로, Stripe 또는 다른 외부 결제 제공자들을 Android 앱에 implement하는 데 virtually의 위험이 없습니다. 이러한 implement를 진행할 수 있는 것은, 법적 기반에 서 있는 것을 알기 때문입니다.

iOS에 대해 설명한 implement는 Android 기기에도 거의 동일하게 작동합니다. 구글 플레이 스토어는 외부 결제 방법에 대한 제한이 없기 때문에, Stripe Payment Links 접근법을 사용할 수 있습니다. disclosure dialog를 필요로 하지 않습니다.

deep linking을 처리하기 위해(안드로이드에서는 universal links와 동일한 개념입니다), 다음을 수행해야 합니다:

App Link 설정을 AndroidManifest.xml redirect URL을 처리하는
App Link을 .well-known/assetlinks.json 파일에 앱의 정보를 입력하세요.
same appUrlOpen listener logic을 사용하여 성공적인 결제를 처리하세요.

Capacitor의 아름다움은 플랫폼별 설정을 구현한 후 실제 결제 흐름이 code 동일한 플랫폼 간에 유지되는 것입니다.

결제 UI 만들기

Here’s an example of a payment button component in Vue that you can add to your Capacitor app:

<template>
  <div class="payment-container">
    <div class="pricing-card">
      <h2 class="mb-4 text-xl font-bold">{{ product.name }}</h2>
      <p class="mb-6 text-gray-600">{{ product.description }}</p>
      <div class="mb-6 price-tag">
        <span class="text-2xl font-bold">${{ product.price }}</span>
        <span v-if="product.isSubscription" class="text-sm text-gray-500">/month</span>
      </div>
      <button 
        @click="handlePayment" 
        class="py-3 w-full font-medium text-white bg-indigo-600 rounded-lg transition-colors hover:bg-indigo-700"
      >
        Purchase Now
      </button>
    </div>
  </div>
</template>

<script setup>
import { ref } from 'vue';
import { Dialog } from '@capacitor/dialog';

const props = defineProps({
  product: {
    type: Object,
    required: true
  },
  userEmail: {
    type: String,
    default: ''
  },
  userId: {
    type: String,
    required: true
  }
});

const isLoading = ref(false);

async function showExternalPaymentDisclosure() {
  const { value } = await Dialog.confirm({
    title: 'Leaving App for Payment',
    message: 'You are about to leave this app to make a payment. Apple is not responsible for the privacy or security of payments that are not made through the App Store. All payment-related issues, including refunds, must be handled by our support team.',
    okButtonTitle: 'Continue',
    cancelButtonTitle: 'Cancel'
  });
  
  return value;
}

async function openPaymentLink() {
  // Use your actual Stripe payment link
  const baseUrl = 'https://buy.stripe.com/your_payment_link';
  
  // Add URL parameters to customize the experience
  const params = new URLSearchParams({
    prefilled_email: encodeURIComponent(props.userEmail),
    client_reference_id: props.userId
  });

  const fullUrl = `${baseUrl}?${params.toString()}`;
  
  // Simple window.open works in both web and Capacitor
  // Using _blank opens in Safari on iOS which is important for users with saved Stripe Link credentials
  window.open(fullUrl, '_blank');
}

async function handlePayment() {
  isLoading.value = true;
  try {
    // Only show the disclosure on iOS
    if (window.Capacitor?.getPlatform() === 'ios') {
      const userConfirmed = await showExternalPaymentDisclosure();
      if (!userConfirmed) return;
    }
    
    await openPaymentLink();
  } catch (error) {
    console.error('Payment error:', error);
    await Dialog.alert({
      title: 'Payment Error',
      message: 'There was an error initiating the payment. Please try again.'
    });
  } finally {
    isLoading.value = false;
  }
}
</script>

다양한 지역을 처리하는 방법

새로운 애플 지침은 미국 앱 스토어에만 적용되므로 사용자 지역을 감지하고 적절한 결제 방법을 적용하는 전략이 필요합니다. IP 지리 정보를 사용하는 더 신뢰할 수 있는 방법입니다.

import { Capacitor } from '@capacitor/core';

async function determinePaymentMethod() {
  // Always use Stripe for Android
  if (Capacitor.getPlatform() !== 'ios') {
    return 'external';
  }
  
  try {
    // Use a geolocation service to determine user's country
    const response = await fetch('https://ipapi.co/json/');
    const locationData = await response.json();
    
    // Check if the user is in the United States
    if (locationData.country_code === 'US') {
      return 'external'; // Can use Stripe Payment Links
    } else {
      return 'iap'; // Must use In-App Purchases
    }
  } catch (error) {
    console.error('Error detecting region:', error);
    return 'iap'; // Default to IAP to be safe
  }
}

export async function processPayment(product, userEmail, userId) {
  const paymentMethod = await determinePaymentMethod();
  
  if (paymentMethod === 'external') {
    // Use Stripe Payment Links
    await initiateExternalPayment(userEmail, userId);
  } else {
    // Use Apple's In-App Purchase
    await initiateInAppPurchase(product.appleProductId);
  }
}

이 방법은 무료 ipapi.co IP 주소에 따라 사용자의 국가를 결정하는 서비스입니다. MaxMind와 같은 다른 위치 서비스를 사용하거나, 보안을 위해 서버 측에서 이 체크를 구현할 수도 있습니다.

주의:IP 기반의 위치 정보는 항상 100% 정확하지 않습니다. mission-critical 애플리케이션의 경우, 여러 감지 방법을 사용하거나 사용자에게 지역을 수동으로 선택하도록 허용하는 것을 고려해 보세요.

더 정확한 위치 감지에 대한 Capacitor 플러그인

더 정확한 위치 감지를 위해, Capacitor Geolocation 플러그인과 @capgo/capacitor-nativegeocoder를 사용하여 사용자의 국가를 더 높은 정확도로 결정할 수 있습니다.

필요한 플러그인을 설치하세요.

npm install @capacitor/geolocation @capgo/capacitor-nativegeocoder

Capacitor 프로젝트에서 플러그인을 구성하세요. 다음을 프로젝트에 추가하세요. capacitor.config.ts:

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  // Your existing app configuration (appId, appName, etc.)
  plugins: {
    Geolocation: {
      // Request precise location access on iOS
      iosLocationAccuracy: 'reduced'
    }
  }
};

export default config;

위치 기반 지역 감지를 구현하세요.

import { Capacitor } from '@capacitor/core';
import { Geolocation } from '@capacitor/geolocation';
import { NativeGeocoder } from '@capgo/capacitor-nativegeocoder';

async function isUserInUSA() {
  try {
    // Request permission first
    const permissionStatus = await Geolocation.requestPermissions();
    
    if (permissionStatus.location === 'granted') {
      // Get current position
      const position = await Geolocation.getCurrentPosition({
        timeout: 10000,
        enableHighAccuracy: false
      });
      
      // Use NativeGeocoder to reverse geocode the coordinates
      const results = await NativeGeocoder.reverseGeocode({
        latitude: position.coords.latitude,
        longitude: position.coords.longitude,
        useLocale: true,
        maxResults: 1
      });
      
      if (results.addresses.length > 0) {
        // Check if the user is in the USA
        return results.addresses[0].countryCode === 'US';
      }
    }
    
    // If we couldn't determine location or permission denied, fall back to IP detection
    return await isUserInUSAByIP();
  } catch (error) {
    console.error('Error detecting location:', error);
    // Fall back to IP detection on error
    return await isUserInUSAByIP();
  }
}

async function isUserInUSAByIP() {
  try {
    const response = await fetch('https://ipapi.co/json/');
    const data = await response.json();
    return data.country_code === 'US';
  } catch (error) {
    console.error('Error detecting IP location:', error);
    return false; // Default to false to be safe
  }
}

export async function determinePaymentMethod() {
  // Always use Stripe for Android
  if (Capacitor.getPlatform() !== 'ios') {
    return 'external';
  }
  
  // Check if user is in the USA
  const isUSA = await isUserInUSA();
  return isUSA ? 'external' : 'iap';
}

export async function processPayment(product, userEmail, userId) {
  const paymentMethod = await determinePaymentMethod();
  
  if (paymentMethod === 'external') {
    // Use Stripe Payment Links
    await initiateExternalPayment(userEmail, userId);
  } else {
    // Use Apple's In-App Purchase
    await initiateInAppPurchase(product.appleProductId);
  }
}

이 구현은 사용자가 물리적으로 미국에 위치한지 여부를 더 정확하게 결정하는 방법을 제공합니다. 먼저 장치의 GPS와 네이티브 지오코더를 사용하여 국가를 결정하려고 시도합니다. 실패(권한 문제 또는 기타 오류)가 발생하면 IP 기반 감지를 사용합니다.

필요한 권한을 프로젝트의 info.plist (iOS)와 AndroidManifest.xml (Android) 파일에 추가하세요.

iOS (ios/App/App/Info.plist):

<key>NSLocationWhenInUseUsageDescription</key>
<string>We need your location to determine which payment method to use based on regional availability.</string>

Android (android/app/src/main/AndroidManifest.xml):

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

이 방법을 사용하면 사용자가 새로운 Apple 지침에 따라 외부 결제 옵션에 적합한지 가장 정확하게 판단할 수 있습니다.

구독 관리

Capacitor 앱에서 구독 관리를 처리하는 방법은 다음과 같습니다.

1. 구독 관리 페이지 만들기

__CAPGO_KEEP_0__ 앱에 구독 관리 페이지를 추가하여 사용자의 활성 구독을 표시합니다.

<template>
  <div class="subscription-manager">
    <div v-if="isLoading" class="loading-indicator">
      Loading subscription data...
    </div>
    
    <div v-else-if="subscription" class="subscription-info">
      <h2 class="mb-4 text-xl font-bold">Your Subscription</h2>
      
      <div class="mb-6 plan-details">
        <p><span class="font-medium">Plan:</span> {{ subscription.planName }}</p>
        <p><span class="font-medium">Status:</span> {{ subscription.status }}</p>
        <p><span class="font-medium">Renews:</span> {{ formatDate(subscription.currentPeriodEnd) }}</p>
      </div>
      
      <button 
        @click="manageSubscription" 
        class="py-3 w-full font-medium text-white bg-indigo-600 rounded-lg transition-colors hover:bg-indigo-700"
      >
        Manage Subscription
      </button>
    </div>
    
    <div v-else class="no-subscription">
      <p class="mb-4">You don't have an active subscription.</p>
      <button 
        @click="goToPricingPage" 
        class="py-3 w-full font-medium text-white bg-indigo-600 rounded-lg transition-colors hover:bg-indigo-700"
      >
        View Plans
      </button>
    </div>
  </div>
</template>

<script setup>
import { ref, onMounted } from 'vue';
import { getUserSubscription } from '../services/subscription';

const subscription = ref(null);
const isLoading = ref(true);

onMounted(async () => {
  try {
    const userData = await getUserSubscription();
    subscription.value = userData.subscription;
  } catch (error) {
    console.error('Failed to load subscription:', error);
  } finally {
    isLoading.value = false;
  }
});

function formatDate(timestamp) {
  return new Date(timestamp * 1000).toLocaleDateString();
}

function manageSubscription() {
  // Open Stripe Customer Portal
  window.open(subscription.value.portalUrl, '_blank');
}

function goToPricingPage() {
  // Navigate to pricing page
  // router.push('/pricing');
}
</script>

2. 구독 관리 고객 포털

Stripe은 구독 관리를 위해 고객 포털을 제공합니다. 서버에서 이 포털에 대한 링크를 생성할 수 있습니다.

// Server-side code (Node.js)
const stripe = require('stripe')('sk_your_stripe_secret_key');

async function createPortalSession(customerId) {
  const session = await stripe.billingPortal.sessions.create({
    customer: customerId,
    return_url: 'https://yourdomain.com/account',
  });
  
  return session.url;
}

애플 스토어 준수

Apple 지침을 준수하기 위해 구현을 확인하려면:

외부 구매에 대한 적절한 고지를 포함해야 합니다.
애플의 정책에 따라 사용자가 앱을 떠나는 알림 시트를 구현하세요.
앱 내에서 구매를 통해 애플의 수수료를 피하려 하지 마세요.
사용자에게 애플이 거래에 책임이 없다는 것을 명확하게 전달하세요.

필요한 알림 시트 구현 예제입니다.

import { Dialog } from '@capacitor/dialog';

async function showExternalPaymentDisclosure() {
  const { value } = await Dialog.confirm({
    title: 'Leaving App for Payment',
    message: 'You are about to leave this app to make a payment. Apple is not responsible for the privacy or security of payments that are not made through the App Store. All payment-related issues, including refunds, must be handled by our support team.',
    okButtonTitle: 'Continue',
    cancelButtonTitle: 'Cancel'
  });
  
  return value;
}

export async function initiateExternalPayment(userEmail, userId) {
  const userConfirmed = await showExternalPaymentDisclosure();
  
  if (userConfirmed) {
    await openPaymentLink(userEmail, userId);
  }
}

구현 테스트

구현 테스트를 하려면:

앱 내에서 결제 버튼을 클릭하여 알림 시트가 표시되고 스티프支付 페이지로 열리는지 확인하세요.
스프링 테스트 카드를 사용하여 테스트 결제를 완료하세요. 4242 4242 4242 4242
결제 후 앱으로 돌아오는지 확인하세요.
웹 훅이 이벤트를 받았는지 확인하세요. checkout.session.completed 결론

__CAPGO_KEEP_0__

iOS 앱에서 디지털 상품에 대한 외부 결제 옵션을 사용할 수 있는 능력은 개발자에게 더 많은 유연성을 제공하는 중요한 변화입니다. 이 변경은 현재 미국 앱 스토어에만 적용되지만 Apple의 내 앱 구매 시스템에 대한 중요한 대안을 제공합니다.

Stripe Payment Links를 사용하여 Capacitor, Apple의 지침을 준수하면서도 단순화된 체크아웃 경험을 빠르게 구현할 수 있습니다. 미국 외부의 사용자에게는 Apple의 내 앱 구매 시스템이 여전히 적용되기 때문에 @capgo/native-purchases StoreKit과 Google Play Billing을 직접 implement합니다. 이 접근 방식은 또한 Stripe의 강력한 결제 인프라, Apple의 내 앱 구매 시스템보다 낮은 처리 수수료 (3% vs 30%), 빠른ayout (일 단위 vs 월 단위)와 같은 이점을 제공합니다.

고객 지원 및 환불 문제를 직접 처리해야 하다는 점을 기억하세요. 이 거래는 Apple의 생태계 외부에서 발생하기 때문입니다.

Capacitor 앱에서 Stripe Payment Links를 구현했나요? 댓글 아래에 경험을 공유해 보세요!

FAQs

Q: 이 접근 방식은 Apple의 지침에 부합합니까?
A: 2025년 5월 1일부터, Apple은 미국 앱 스토어에 배포된 앱에서 디지털 상품과 서비스에 대한 외부 결제 방법에 대한 링크를 포함하는 경우, 미국 앱 스토어에 배포된 앱에서 디지털 상품과 서비스에 대한 외부 결제 방법에 대한 링크를 포함하는 경우, Apple의 지침에 부합합니다.

Q: 외부 결제 방법을 사용할 때 Apple의 수수료를 지불해야 합니까?
A: 아니오, 새로운 규칙의 주요 이점 중 하나는 애플 시스템 외부에서 처리되는 결제는 그에 대한 수수료를 받지 않는다는 것입니다.

Q: 내 회사가 미국에 기반을 두어야 이러한 새로운 규칙을 활용할 수 있나요?
A: 아니오, 앱이 미국 앱 스토어에 등록되어 있고 사용자가 미국에 거주하는 경우에만 외부 결제 방법을 구현할 수 있습니다. 규정은 시장(미국 앱 스토어)과 사용자의 위치에 적용되며, 회사의 위치는 적용되지 않습니다. 따라서 유럽, 아시아, 남미, 또는 어디서든 개발자는 유럽, 아시아, 남미, 또는 어디서든 개발자는 미국 고객에게 스티프 결제 링크를 구현할 수 있습니다.

Q: 미국 밖의 사용자가 외부 결제 옵션을 사용하려고 할 때 어떻게 되나요?
A: 사용자의 지역을 감지하는 기능(기사에서 설명한 것과 같이)을 구현하여 미국 밖의 사용자에게만 외부 결제 옵션을 제공해야 합니다. 다른 지역의 경우에는 애플의 인앱 구매 시스템을 계속 사용해야 합니다.

Q: 물리적 제품이나 서비스를 앱 외부에서 소비하는 경우 사용할 수 있나요?
A: 예, 애플은 항상 물리적 제품이나 서비스를 앱 외부에서 소비하는 경우 외부 결제 방법을 허용했습니다(라이드 셰어링이나 음식 배달과 같은 경우).

Keep going from Stripe Payments in Capacitor:

If you are using Stripe Payments in Capacitor: New Apple Guidelines to plan security and compliance, connect it with Encryption 암호화 구현 세부 정보에 대해 규정 준수 규정 준수 구현 세부 정보에 대해 Capgo 보안 스캐너 Capgo 보안 스캐너의 제품 워크플로에 대해 Capgo 보안 Capgo 보안의 제품 워크플로에 대해 Capgo 신뢰 센터 Capgo 신뢰 센터의 제품 워크플로에 대해

Capacitor에서 Stripe 결제: 새로운 애플 지침