Apple App Store 설정

다음이 필요하며 약 5분이 걸립니다.

• App Store Connect에 대한 Admin 또는 Account Holder 접근 권한.
• App Store Connect API 키. 이것으로 세 가지 값을 얻습니다. Issuer ID, Key ID, 그리고 .p8 개인 키 파일.

Apple에 업로드되는 파일은 없으며, 앱 바이너리에도 변경이 가해지지 않습니다.

Issuer ID, Key ID, .p8 파일은 모두 App Store Connect의 같은 곳에서 나옵니다.

1. App Store Connect에 로그인해 Users and Access를 열고, Integrations 탭을 선택한 뒤 왼쪽 Keys 섹션에서 In-App Purchase를 고릅니다.
2. 페이지 상단에 표시된 Issuer ID를 복사합니다. 이는 계정 전체에서 공통인 단일 값으로, 생성하는 모든 키가 공유합니다.
3. Active 옆의 + 버튼을 클릭해 새 키를 생성합니다. 이름을 Refund Sensor로 하고 Access를 Admin으로 설정한 뒤 Generate를 클릭합니다.
4. 새 키에서 Key ID를 복사한 다음, 키 행을 클릭해 .p8 파일을 Download합니다. Apple은 다운로드를 한 번만 허용하므로 안전한 곳에 보관하세요.

Refund Sensor에서 Add app을 열고 Apple App Store를 선택합니다. Issuer ID와 Key ID를 붙여넣고 .p8 파일을 업로드한 뒤 Continue를 클릭합니다. 저희는 Apple로 키를 검증하고 저장 전에 AES-256-GCM으로 저장 시 암호화합니다. 이후에는 다시 표시되지 않으며 로그에도 노출되지 않습니다.

키가 검증되면 Refund Sensor는 App Store Connect 계정에서 볼 수 있는 모든 앱을 가져옵니다. 이름이나 번들 ID로 검색해 방어할 앱을 선택하고 Connect를 클릭합니다. 연결된 각 앱은 고유한 webhook URL을 받습니다.

이것이 마지막 단계이며 연결 후 앱마다 한 번 수행합니다. Apple은 서버 알림을 단일 URL로 보냅니다.

1. Refund Sensor에서 앱의 webhook URL을 복사합니다(연결된 앱 카드에 표시됩니다).
2. App Store Connect에서 해당 앱의 App Information 페이지를 열고 App Store Server Notifications까지 스크롤합니다.
3. Production Server URL의 Set Up URL을 클릭해 URL을 붙여넣고 저장합니다. 그런 다음 Sandbox Server URL에도 똑같이 해서 테스트와 실서비스 트래픽이 모두 Refund Sensor에 도달하도록 합니다.

연결된 각 앱에는 저희가 생성해 Refund Sensor의 카드에 표시하는 고유 URL이 있습니다. 직접 입력하지 말고 거기서 복사하세요.

Apple은 서버 알림 URL을 하나만 허용하며, 구독 플랫폼이 이미 그것을 쓰고 있다면 교체하지 마세요. 대신 그 플랫폼이 각 원본 Apple 알림의 사본을 Refund Sensor webhook URL로 전달하도록 설정하면 둘 다 계속 동작합니다. RevenueCat, Adapty, Apphud의 정확한 단계는 알림 전달을 참고하세요.

Refund Sensor는 실제 이벤트에 대응하기 전에 Apple의 알림을 받을 수 있는지 먼저 확인합니다. 연결이 확인되기 전까지 라이브 이벤트는 기록되지만 대응하지 않으므로, 절반만 끝난 설정이 실수로 응답을 보내는 일은 없습니다.