# Apple 개발자 계정

마치면 Apple Developer Program 계정이 생기고, App Store Connect API 키가 allob 에 연결돼요. 개인 계정은 1~2일, 조직(법인) 계정은 D-U-N-S 까지 2~4주 걸려요.

계정 하나로 앱을 여러 개 올려요. 같은 사업자의 두 번째 앱부터는 이 할 일이 이미 끝나 있어요.

## 시작하기 전에

- **Apple 계정** — 2단계 인증을 켜고, 이름은 **법적 실명**이어야 해요(별명·상호는 안 돼요). 이름 바꾸기는 에이전트가 해요.
- **연회비** — 연 US$99 를 현지 통화로 내요. 원화 금액은 가입 화면에서 확인해요.
- **신원 정보** — 실명, 실제 주소(사서함 안 돼요), 전화. 에이전트가 사업자 정보 카드에서 읽어 채워요.
- **법인이면 D-U-N-S 번호** — [사업자 등록·판매 준비](/docs/journey-kr-business)의 D-U-N-S 할 일을 먼저 끝내요.

App Store Connect 연결은 계정에 한 번 넣고 제품마다 앱을 골라 써요. 연결할 때 allob 이 실제로 접속해 앱 목록을 가져와 확인하고, 가입·API 키 할 일은 이 연결로 끝난 것을 확인해요.

:::prompt
이 allob 사업 가이드를 읽고, 내 사업에 해당하는 할 일만 골라 진행해 줘: https://allob.app/docs/journey-apple-dev.md
1. allob business view 와 allob path view --business 로 내 사업 모양(사업자 형태·돈 버는 방식·파는 나라)을 먼저 확인해.
2. 해당하지 않는 할 일은 왜 아닌지 한 줄로 알려 주고 allob step skip <id> --reason "…" 으로 넘겨.
3. 해당하는 할 일은 allob step view <id> 의 안내대로 하고, 끝나면 allob step done <id> --note "끝났다는 증거" 를 불러.
4. 본인 인증·서명·결제·약관 동의처럼 사람만 하는 곳에서는 멈추고 무엇을 누르면 되는지 알려 줘.
5. 되돌리기 어려운 답(과세 유형·계정 유형 등)은 내 폰으로 확인 요청이 와 — 명령이 보여 준 승인 링크를 알려 주고, 기다리는 동안 다른 할 일로 넘어가.
:::

## 계정 유형 고르기 {#dev.apple.type}

Apple 개발자 계정을 개인으로 만들지, 조직(법인)으로 만들지 정해요.

Apple 은 개인사업자·1인 사업을 개인으로 받고, 조직 계정은 **법인**만 받아요([가입 안내](https://developer.apple.com/programs/enroll/)). 그래서 사업자 형태를 개인사업자(또는 아직 없음)로 답했다면 allob 이 "개인"으로 답해 둬요.

| 조건 | 고를 길 | 그 길의 대가 |
|---|---|---|
| 한국 개인사업자(1인 사업)예요 | **개인** | 판매자 이름이 **본인 실명**으로 나와요. D-U-N-S 는 필요 없어요 |
| 상호를 판매자 이름으로 쓰고 싶어요 | 법인을 세운 뒤 조직 | 조직 계정은 법인만 받아요. 상호(DBA)·가명 사업·지점은 안 돼요. 개인사업자로 D-U-N-S 를 받아도 "법인이 아님" 오류가 나요 |
| 법인이 있어요 | 조직 | 법인 이름의 D-U-N-S, 회사 도메인 웹사이트·메일이 필요해요. **법인이면 D-U-N-S 가 먼저예요**(사업자 등록·판매 준비의 D-U-N-S 할 일, 1~2주) |
| 개인으로 시작했는데 나중에 법인을 세웠어요 | 개인 → 조직 전환 요청 | 요청자는 그 법인의 창업자여야 하고 D-U-N-S 가 필요해요. 앱·계약·세금 양식이 옮겨 가는 방식은 **확인 필요** |

:::warning
⚠ 나중에 바꾸기 어려워요. 조직으로 옮기려면 법인·D-U-N-S·전환 요청이 필요해요. 상호 표시가 꼭 필요한지, 법인을 세울 계획이 있는지 먼저 생각해 봐요. 개인사업자로 조직 계정을 시도하려면 먼저 Apple 에 문의해요.
:::

:::tip 끝났는지 확인
계정 유형이 정해졌어요. 개인사업자면 allob 이 "개인"으로 답한 것으로 끝나요. 법인이면 에이전트가 "조직"으로 답하고, 되돌리기 어려운 답이라 운영자가 폰(알림이나 링크)에서 승인해 끝내요.
:::

개인사업자면 할 일이 없어요. 법인이면 폰으로 온 확인 요청(또는 에이전트가 알려 준 링크)을 열어 \"조직\"이 맞는지 보고 승인해요.
## Apple Developer Program 가입하기 {#dev.apple.enroll}

Apple Developer Program 에 가입하고 연회비를 내요. App Store Connect 연결이 확인을 통과하면 allob 이 끝남으로 바꿔요.

1. Apple 계정 이름을 법적 실명으로 바꾸고 2단계 인증을 켜요.
2. [Apple Developer 가입](https://developer.apple.com/programs/enroll/)에서 개인으로 가입하고 실명·주소·전화를 넣은 뒤 결제해요.
3. 1~2일 안에 확인 메일이 오면 [App Store Connect](https://appstoreconnect.apple.com) 에 들어가요.
4. 계약 화면에서 "무료 앱 계약"이 활성인지 봐요. 유료 앱·인앱·구독 계약과 한국 전자상거래법 연락처는 [App Store 돈 받기](/docs/journey-apple-payouts)에서 해요. 개인 계정의 판매자 이름은 실명으로 나와요.
5. 운영자를 TestFlight 내부 테스터로 넣어 둬요. 새 빌드가 올라오면 바로 받아요.

:::tip
가입용 메일과 공개 지원 메일은 처음부터 나눠요. 가입용(개발 메일)은 콘솔·계정에, 공개 지원 메일은 스토어 연락처에만 써요.
:::

:::tip 끝났는지 확인
App Store Connect 에 들어가지고, 무료 앱 계약이 활성이에요. allob 은 App Store Connect 연결(`appstore`)이 확인을 통과하면 이 할 일을 끝난 것으로 봐요 — API 키 할 일을 끝내면 같이 끝나요.
:::

- Apple 계정 로그인(2단계 인증)과 본인 확인을 해요.
- 사용권 계약 동의 — 본인 이름의 개인 계정인지, 연회비가 자동 갱신되는지 보고 동의해요.
- 결제 — 금액이 연 US$99(현지 통화)인지 보고 결제해요.
## App Store Connect API 키 연결하기 {#dev.apple.asc-key}

App Store Connect 팀 API 키를 만들어 allob 에 연결해요. 연결이 확인을 통과하면 allob 이 끝남으로 바꿔요.

이 키로 에이전트와 allob 이 앱 목록·빌드·등록정보·심사 상태를 읽고 바꿔요. 클라우드 배포 서명에도 써요. 계정에 한 번 연결하고 제품마다 앱을 골라 써요.

1. App Store Connect → 사용자 및 액세스 → 통합 → 팀 키 → 새 키를 눌러요.
2. 권한은 Admin 으로 해요(클라우드 배포 서명·앱 정보 수정용).
3. Issuer ID·Key ID 를 적고 키 파일을 받아요.
4. 받자마자 allob 에 연결하고 파일은 지워요.

:::warning
⚠ 키 파일(`.p8`)은 **한 번만** 받을 수 있어요. 잃어버리면 새 키를 만들고 옛 키는 폐기해야 해요.
:::

:::tip 끝났는지 확인
`allob connection add appstore` 가 확인을 통과하고 앱 목록을 가져와요. allob 이 이 연결로 자동으로 확인해요.
:::

App Store Connect 로그인만 해 주세요. 키 만들기와 연결은 에이전트가 끝까지 해요. 결과는 allob 연결 화면에서 볼 수 있어요.
## EU 거래자 여부 고르기 {#payout.apple.dsa-status}

EU 디지털서비스법(DSA)에 따라 EU 에서 거래자(trader)로 팔지, 비거래자로 둘지 정해요.

고르지 않으면 EU App Store 에서 앱이 내려가요([Apple 안내](https://developer.apple.com/news/?id=einwn76m)).

| 조건 | 고를 길 | 그 길의 대가 |
|---|---|---|
| 유료 앱·인앱·구독·광고로 돈을 버는 앱을 EU 에 내요 | 거래자 | 이름·주소·**전화**·이메일이 EU 제품 페이지에 공개돼요. 이메일 인증과 증명 서류(사업자등록증명) 심사가 있어요 |
| 돈을 벌지 않는 개인 앱이에요 | 비거래자 | 공개 정보가 없어요. 수익을 내기 시작하면 바꿔요 |

:::tip 끝났는지 확인
App Store Connect → 비즈니스 → 규정 준수에서 거래자 여부를 골랐고, allob 에 같은 답을 적었어요.
:::

거래자면 전화번호가 EU 에 공개돼요. 에이전트가 개인 휴대폰 번호를 공개해도 되는지 물으면 답해 주세요.
## EU 거래자 정보 넣기 {#payout.apple.dsa}

거래자로 정했으면 공개 연락처와 증명 서류를 넣고 심사를 기다려요.

심사가 몇 주 걸리니 일찍 시작해요. 자세한 요건은 [Apple DSA 거래자 요건](https://developer.apple.com/help/app-store-connect/manage-compliance-information/manage-european-union-digital-services-act-trader-requirements/)에 있어요.

1. App Store Connect → 비즈니스 → 규정 준수 → DSA 거래자 정보를 열어요.
2. 공개 이름·주소·전화·이메일을 넣어요. 공개되니 공개용 주소를 써요([공개할 정보 정하기](/docs/journey-kr-business#legal.address-level)).
3. 이메일 인증을 해요(공개 메일함으로 온 확인).
4. 증명 서류로 사업자등록증명을 올리고 제출해요.

:::tip 끝났는지 확인
거래자 상태가 "확인됨"이에요. 증거는 상태와 확인된 날을 적은 메모예요.
:::

이메일 인증 — 공개 메일함에 온 Apple 확인 메일을 열어 인증해요.

## 자주 걸리는 함정

| 증상 | 원인·해결 |
|---|---|
| 가입 승인이 늦어져요 | Apple 계정 이름이 별명·상호예요 → 법적 실명으로 바꿔요 |
| 조직 가입이 "법인이 아님"으로 막혀요 | D&B 에 개인사업으로 등록돼 있어요 → 개인으로 가입해요 |
| `.p8` 키를 잃어버렸어요 | 다시 받을 수 없어요 → 새 키를 만들고 옛 키는 폐기해요 |
| 가입 메일·공개 메일이 섞였어요 | 처음부터 가입용과 공개 지원 메일을 나눠요 |

:::details 파는 곳에 따라 더 챙길 것
- **EU 에 팔아요** — DSA 거래자 신고가 필요해요. 거래자면 전화·주소가 EU 제품 페이지에 공개돼요(위 EU 거래자 할 일).
:::

## 출처

공식 안내와 마지막으로 맞춰 본 날: 2026-10-18

- [Apple Developer Program 가입 안내](https://developer.apple.com/programs/enroll/)
- [Apple D-U-N-S 도움말](https://developer.apple.com/help/account/membership/D-U-N-S/)
- [Apple D-U-N-S 조회 도구](https://developer.apple.com/enroll/duns-lookup/)
- [Apple EU 거래자 상태가 없는 앱은 내려가요](https://developer.apple.com/news/?id=einwn76m)
- [Apple DSA 거래자 요건 관리](https://developer.apple.com/help/app-store-connect/manage-compliance-information/manage-european-union-digital-services-act-trader-requirements/)
