Checkout.ApplePayButton을 사용해 Apple Pay로 실물 상품이나 오프라인 서비스에 대한 일회성 결제를 받으세요. Whop은 Apple의 15–30% 인앱 구매 수수료 대신 2.7% + $0.30으로 결제를 처리합니다.
만들 것
- 네이티브 Apple Pay 버튼이 있는 상품 상세 화면
- 성공, 실패, 취소를 처리하는 구매 흐름
- 실물 상품을 위한 Whop 대시보드의 변형 구성
사전 요구 사항
- WhopCheckout SDK 설치하기
iap:read범위의 API 키. API 키 만들기를 참고하세요- 일회성 변형이 있는 Whop 상품(5단계 참고)
1단계: SDK 구성하기
앱 실행 시 SDK를 초기화하세요. 일회성 실물 상품에는 호환성 속성planMappings가 필요하지 않습니다. 이 속성은 구독에서 StoreKit으로 대체할 때만 사용됩니다.
2단계: Apple Pay 버튼 추가하기
상품 뷰에 Checkout.ApplePayButton을 넣으세요. 이 컴포넌트는 Human Interface Guidelines를 준수하는 Apple의 공식 Apple Pay 버튼을 렌더링하며, 사용자 지정 스타일 버튼으로 대체할 수 없습니다.
사용자가 취소하면
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 문서

