2026년 App Store 외부 구매 링크
앱 심사 가이드라인 3.1.1은 여전히 App Store 앱 내에서 판매되는 디지털 상품과 서비스에 인앱 결제를 사용하도록 요구합니다. 그러나 예외 목록은 다시 늘어났고, 2026년에는 규정을 준수하는 앱이 고객을 자체 결제 페이지로 안내할 수 있는 세 가지 방법이 있습니다. 가이드라인 3.1.1(a)의 현행 문구는 이를 명확히 밝힙니다. 개발자는 자사가 소유하거나 유지 책임이 있는 웹사이트로 연결되는 링크를 앱에 제공하기 위해 권한을 신청할 수 있으며, 미국 퍼블리셔에게 가장 중요한 문장은 "미국 스토어프론트 앱에서는 버튼, 외부 링크 또는 기타 행동 유도 요소를 포함하기 위해 이러한 권한이 필요하지 않습니다"입니다. 다른 모든 스토어프론트에서는 동일 가이드라인이 앱과 메타데이터에 인앱 결제 이외의 구매 수단으로 고객을 유도하는 버튼, 외부 링크 또는 기타 행동 유도 요소를 포함할 수 없다고 명시합니다.
한 줄 요약: 미국 스토어프런트에는 어떤 자격도 필요하지 않습니다. com.apple.developer.storekit.external-purchase-link 자격은 Apple이 외부 링크를 허용하는 iOS/iPadOS 스토어프런트를 대상으로 하며, 더 최근에 도입된 맞춤 구매 링크 자격은 지역 단위로 적용되어 EU 국가 코드에 브라질과 일본이 추가되었습니다. ExternalPurchaseLink는 런타임에서 해당 사항이 적용되는지 알려주고, eligibleURLs와 open(url:)가 실제로 링크를 엽니다. 그리고 반환되는 모든 토큰은 External Purchase Server API를 통해 보고해야 합니다.
1단계 — 앱이 세 가지 경로 중 어디에 해당하는지 파악하기
첫 번째 경로는 미국 스토어프런트입니다. 별도 권한 없이 외부 링크가 허용되며, 가이드라인에도 명시되어 있습니다. 두 번째 경로는 com.apple.developer.storekit.external-purchase-link, 즉 StoreKit 외부 구매 링크 권한입니다. Apple의 요약에 따르면 이 권한은 "자격을 갖춘 앱이 앱 이용자를 외부 구매를 위한 웹사이트로 안내하는 링크를 포함할 수 있도록" 하며, 권한 계약은 해당 링크를 인앱 아이템의 구매 위치와 방법, 그리고 상대적으로 더 낮은 가격에 제공될 수 있다는 사실을 알리는 용도로 제한합니다. 세 번째 경로는 com.apple.developer.storekit.custom-purchase-link.allowed-regions입니다. 이 권한은 "자격을 갖춘 앱이 특정 지역에서 앱 내 또는 웹사이트를 통해 외부 구매를 제공할 수 있도록" 하며, 값은 불리언이 아니라 두 자리 ISO-3166-1 코드 배열입니다. 문서에 따르면 허용되는 맞춤 구매 링크 지역에는 브라질(br), 일본(jp)과 EU 국가 코드인 오스트리아, 벨기에, 불가리아, 크로아티아, 키프로스, 체코, 덴마크, 에스토니아, 핀란드, 프랑스, 독일, 그리스, 헝가리, 아일랜드, 이탈리아, 라트비아, 리투아니아, 룩셈부르크, 몰타, 네덜란드, 폴란드, 포르투갈, 루마니아, 슬로바키아, 슬로베니아, 스페인, 스웨덴이 포함됩니다.
코드를 작성하기 전에 실제로 출시하는 스토어프론트를 나열하세요. 스토어프론트 경계를 무시한 단일 글로벌 링크는 이 기능이 심사 거절로 이어지는 가장 흔한 원인입니다.
2단계 — 서명 프로파일에 권한 적용하기
권한 부여는 앱 스토어 등록정보가 아니라 개발자 계정 단위로 이루어지며, Apple은 그 제한을 명확히 밝힙니다. 해당 권한은 "특정 스토어프런트의 iOS 또는 iPadOS App Store에서만 사용하도록 제한됩니다." 계정이 StoreKit External Purchase Link 권한을 받으면, Xcode에서 프로젝트의 .entitlements 파일을 열고 com.apple.developer.storekit.external-purchase-link 키를 추가한 뒤 값을 true로 설정하여 앱에 적용합니다. 지역 범위 변형의 경우 키는 com.apple.developer.storekit.custom-purchase-link.allowed-regions이며, 값은 해당 기능을 제공하려는 소문자 국가 코드의 배열입니다. Apple의 표현에 따르면 이는 "Apple이 맞춤 구매 링크 옵션을 지원하는 지역만 포함해야 합니다."
권한은 프로비저닝 프로파일에 연결되므로, 실제 순서는 다음과 같습니다. 요청하고, 권한이 나타날 때까지 기다린 뒤, 프로파일을 다시 생성하고, 재서명한 다음 업로드합니다. 이전 프로파일로 서명한 빌드는 링크를 열 수 없으며, 이 실패는 빌드 시점이 아니라 런타임에 나타납니다.
3단계 — Info.plist에서 대상 URL 구성하기
두 개의 프로퍼티 리스트 키가 핵심 역할을 하며, 어느 쪽을 선택하느냐에 따라 호출할 API가 결정됩니다. SKExternalPurchaseLink는 키가 소문자 ISO 3166-1 alpha-2 국가 코드인 딕셔너리로, 국가 코드당 하나의 목적지 URL을 가집니다. Apple에는 유효한 코드가 나열되어 있습니다. EU 회원국 27개국에 아이슬란드(is), 노르웨이(no), 러시아(ru)를 더한 목록입니다. SKExternalPurchaseMultiLink는 멀티링크 변형으로, 딕셔너리 구조는 같지만 각 국가 코드가 1~5개의 목적지 URL로 이루어진 배열에 매핑됩니다.
모든 대상 URL은 네 가지 조건을 충족해야 하며, 네 번째 조건을 많은 사람이 놓칩니다. HTTPS 스킴을 사용하고, 유효한 절대 URL이어야 하며, 쿼리 파라미터가 없어야 하고, ASCII 문자 1,000자 이하여야 합니다. 여기에 더해 Apple는 "속성 목록 키에 제공한 대상 URL은 항상 앱 심사에 제출하는 앱 바이너리의 값과 일치해야 합니다"라고 명시합니다. 즉 URL은 사실상 심사 제출물의 일부이며, 이를 변경하는 것은 설정 수정이 아니라 릴리스입니다.
MultiLink는 모든 개발자에게 제공되지 않습니다. Apple에 설명된 대로 앱이 StoreKit External Purchase Link 권한 요건을 충족하면 국가 코드별로 하나 이상의 링크를 제공할 수 있고, 그렇지 않으면 국가 코드별로 정확히 하나의 링크만 제공할 수 있습니다.
4단계 — 화면을 그리기 전에 canOpen으로 UI를 제어하세요
canOpen은 "현재 App Store 스토어프런트에서 이 앱이 설정된 외부 구매 링크를 정상적으로 열 수 있는가?"에 답하는 불리언입니다. Apple는 세 가지 조건이 모두 충족되어야 한다고 명시합니다. 현재 스토어프런트가 외부 구매를 허용하고 해당 사용자가 외부 구매 자격이 있어야 하며, 앱이 com.apple.developer.storekit.custom-purchase-link.allowed-regions 또는 com.apple.developer.storekit.external-purchase-link 권한을 설정해야 하고, 앱이 현재 스토어프런트에 대한 링크를 설정해야 합니다. 그 외의 경우는 false입니다. App Store 스토어프런트가 변경되지 않는 한 다시 확인할 필요가 없으므로, 앱 실행 시 한 번만 평가해 그 결과로 페이월 UI를 구성할 수 있습니다. 값이 false일 때 문서화된 대체 방법은 canMakePayments를 확인하고 인앱 결제를 유지하는 것입니다.
5단계 — 링크 열기: open() 또는 open(url:)
링크를 하나만 구성한 경우 ExternalPurchaseLink.open()을 호출합니다. 멀티 링크 키를 사용하는 경우 eligibleURLs(현재 스토어프런트에 대해 앱이 구성한 링크 배열)를 읽고, 버튼 탭처럼 이용자의 명확한 상호작용에 반응하여 선택한 링크로 open(url:)을 호출합니다. Apple은 eligibleURLs가 세 가지 상황에서 nil로 반환된다고 명확히 밝힙니다. 스토어프런트가 외부 구매를 허용하지 않거나 이용자가 자격이 없는 경우, 권한이 없는 경우, 현재 스토어프런트에 구성된 링크가 없는 경우입니다. nil이면서 SKExternalPurchaseLink가 구성되어 있으면 canOpen으로 대체하고, nil이면서 구성된 링크가 없으면 canMakePayments로 대체합니다.
open(url:)은 비동기 방식이며, 앱이 외부 구매 링크를 표시할지 사용자가 선택할 수 있는 이어서 진행 시트를 띄웁니다. 이 메서드는 시트가 표시되기 전에 반환되며, 권한이 없거나, 해당 스토어프런트에 설정된 링크가 없거나, 스토어프런트가 외부 구매를 지원하지 않거나, 사용자가 자격이 없거나, 네트워크 또는 시스템 오류가 발생하면 StoreKitError를 던질 수 있습니다. 사용자가 계속 진행하기로 선택하면 StoreKit이 기본 브라우저에서 URL을 열고 외부 구매 토큰과 앱의 번들 ID를 덧붙입니다. 바로 이 토큰 때문에 보고 단계가 필요한 것입니다.
6단계 — External Purchase Server API를 통해 모든 토큰을 보고하세요
External Purchase Server API는 자체 서버에서 호출하는 REST API로, "외부 구매 토큰과 토큰에 연결된 고객 거래를 보고"하는 데 사용합니다. 이 지침은 선택 사항이 아니며 성공한 판매로 한정되지도 않습니다. 거래로 이어지지 않은 토큰을 포함해 모든 토큰을 보고해야 합니다. 구체적으로 Apple는 보고가 필요한 네 가지 경우를 제시합니다. 고객이 하나 이상의 거래를 완료했을 때의 항목이 있는 토큰, 고객이 거래를 완료하지 않았을 때의 항목이 없는 토큰, 기록에 없는 토큰에 대해 App Store 서버 알림이 도착했을 때의 미인식 토큰, 그리고 중복된 ACQUISITION 및 SERVICES 토큰입니다. 인증에는 App Store Connect에서 생성한 API 키로 만든 JSON 웹 토큰을 사용합니다.
이미 App Store Server Notifications V2를 운영 중이라면 리포팅 파이프라인이 자연스러운 연결 지점입니다. 알림으로 토큰 존재를 확인하고, 스토어에서 거래를 기록하며, External Purchase Server API 리포트로 순환을 완성합니다.
7단계 — 스토어프런트 경계를 항상 염두에 두기
위의 모든 내용은 가이드라인과 권한 부여 조항에 반복되는 한 문장으로 제한됩니다. 권한 부여는 특정 스토어프론트의 iOS 또는 iPadOS App Store로 한정되며, 미국 외 스토어프론트에서는 앱과 메타데이터에 인앱 결제 외의 구매 수단으로 고객을 유도하는 버튼, 외부 링크 또는 기타 행동 유도 요소를 포함할 수 없습니다. 이 경계는 메타데이터에도 적용됩니다. 링크가 허용되지 않는 스토어프론트에서 외부 결제 화면을 보여주는 스크린샷은 마케팅 선택이 아니라 심사 거절 위험입니다.
한 번 더 짚어볼 함정
- 쿼리 파라미터는 금지됩니다. 목적지 URL에 붙은 추적 파라미터는 문서화된 URL 규칙을 위반합니다. 어트리뷰션을 담당하는 것은 StoreKit이 추가하는 토큰입니다.
- 권한은 서버 설정이 아니라 서명 기능입니다. 부여된 권한 없이 키를
.entitlements에 추가하면 해당 권한을 사용할 수 없는 프로파일이 생성됩니다. - URL은 항상 바이너리와 일치해야 합니다. 릴리스 없이 새 목적지 URL만 작성하는 것은 Apple 문서가 선호가 아닌 요구 사항으로 규정한 불일치입니다.
- MultiLink 자격을 충족하지 않는 한 국가당 링크는 하나입니다. 링크를 하나만 허용하는 스토어프런트에 URL 다섯 개를 배열하면 심사에서 문제가 됩니다.
- 미국 전용 앱은 아무것도 필요 없습니다. 등록정보가 미국 전용이라면 가이드라인 3.1.1(a)가 이미 외부 링크를 허용하므로, 필요 없는 프로필 기능을 만들지 마세요.
시작점
스토어프론트 목록을 적고 각각을 US, 권한 부여 지역, 맞춤 구매 링크 지역, 해당 없음 중 하나로 표시한 다음, 게이트를 한 번만 구현하세요. canOpen(다중 링크의 경우 eligibleURLs)을 확인하고, true를 반환할 때만 컨트롤을 노출하며, 나머지 모든 사용자에게는 인앱 결제를 기본 경로로 남겨 두면 됩니다. 출시 후에도 이 기능이 컴플라이언스를 유지하는지를 결정하는 것은 서버의 토큰 처리입니다.
개발자 계정을 대규모로 운영하시나요? 운영 업무를 저희가 처리합니다.
메시지를 접수했습니다. 24시간 이내에 답변드리겠습니다.
← 수정으로 돌아가기