Skip to main content
Checkout.ApplePayButton을 사용해 Apple Pay로 실물 상품이나 오프라인 서비스에 대한 일회성 결제를 받으세요. Whop은 Apple의 15–30% 인앱 구매 수수료 대신 2.7% + $0.30으로 결제를 처리합니다.
웹 판매에는 체크아웃 링크 또는 Checkout 요소를 사용해 195개국에서 100가지 이상의 결제 수단을 지원하세요.
Apple Pay는 디지털 콘텐츠용이 아닙니다. 앱이 실물 상품(굿즈, 음식, 하드웨어)이나 오프라인 서비스(이벤트 티켓, 배달)를 판매하는 경우에만 Checkout.ApplePayButton을 사용하세요. 프리미엄 기능, 구독, 인앱 화폐, 콘텐츠 잠금 해제 같은 디지털 콘텐츠를 판매하는 앱은 StoreKit을 사용해야 합니다. 자세한 내용은 Apple Pay 사용 자격 섹션을 참고하세요.

만들 것

  • 네이티브 Apple Pay 버튼이 있는 상품 상세 화면
  • 성공, 실패, 취소를 처리하는 구매 흐름
  • 실물 상품을 위한 Whop 대시보드의 변형 구성

사전 요구 사항

1단계: SDK 구성하기

앱 실행 시 SDK를 초기화하세요. 일회성 실물 상품에는 호환성 속성 planMappings가 필요하지 않습니다. 이 속성은 구독에서 StoreKit으로 대체할 때만 사용됩니다.
전체 설정과 API 키 보안 참고 사항은 설치 가이드를 참고하세요.

2단계: Apple Pay 버튼 추가하기

상품 뷰에 Checkout.ApplePayButton을 넣으세요. 이 컴포넌트는 Human Interface Guidelines를 준수하는 Apple의 공식 Apple Pay 버튼을 렌더링하며, 사용자 지정 스타일 버튼으로 대체할 수 없습니다.
사용자가 탭하면 네이티브 Apple Pay 시트가 표시됩니다. Face ID 또는 더블 클릭으로 확인하면 결제가 Whop을 통해 처리됩니다.
사용자가 취소하면 onCompletion은 호출되지 않으며 시트만 닫힙니다. 정리 작업은 필요하지 않습니다.

3단계: 버튼 레이블 선택하기

label 매개변수는 버튼의 텍스트를 제어합니다. 동작에 맞는 것을 선택하세요: 전체 목록은 Apple의 PayWithApplePayButtonLabel에서 가져옵니다. 모든 옵션은 Apple 문서를 참고하세요.

4단계: 구매 결과 처리하기

onCompletion은 Result<CheckoutPurchaseResult, Error>를 받습니다. 성공하면 다음을 반환받습니다: 이를 사용해 확인 화면을 표시하거나, 배송을 시작하거나, 자체 기록용으로 영수증을 저장하세요.

5단계: 변형 설정하기

구매 가능한 각 항목에는 Whop 대시보드의 변형이 필요합니다:
1

변형 만들기

대시보드 > Products > 상품 선택 > Variants > Create variant로 이동하세요.
2

일회성으로 설정하기

One-time payment를 선택하고 가격을 설정하세요.
3

(선택 사항) 재고 한도 설정하기

한정 판매의 경우 재고 상한을 설정하세요. 체크아웃이 이를 자동으로 적용하며, 재고가 소진되면 구매가 중단됩니다.
4

변형 ID 복사하기

ID는 plan_ 접두사를 유지합니다. 호환성 매개변수 Checkout.ApplePayButton(planId:)를 통해 전달하세요.

웹훅으로 주문 처리하기

실물 상품의 경우 구매 성공 후 배송을 시작하려면 서버 측 웹훅이 필요합니다. payment.succeeded 이벤트를 수신하세요:
클라이언트 측 onCompletion 콜백은 사용자에게 결제를 확인해 주지만, 주문 처리는 서버가 웹훅으로 처리해야 합니다. 클라이언트에만 의존하지 마세요. 설정 방법은 전체 웹훅 가이드를 참고하세요.

전체 예제

사이즈 선택과 Apple Pay가 있는 최소한의 굿즈 상세 뷰:

다음 단계

웹훅

결제 이벤트를 처리하고 주문 처리를 시작하세요

Apple Pay 사용 자격

앱이 App Store 심사 지침에 따라 자격을 갖추었는지 확인하세요

페이월 만들기

일회성 구매 대신 구독을 판매하세요

API 레퍼런스

전체 SDK 문서