필요한 것
| 필드 | 하는 일 |
|---|---|
| Client ID | API 호출에서 당신의 PayPal 앱을 식별합니다. secret과 짝지어집니다. |
| Client secret | API 인증의 비밀 절반. Client ID와 함께 주문을 만듭니다. 비밀. |
| Webhook ID | PayPal이 서명하는 웹훅을 식별해, 각 전달을 검증할 수 있게 합니다. |
| Success URL / Cancel URL | 구매자가 결제 후 또는 빠져나간 뒤 도착하는 곳. |
각 필드를 요청하는 이유
Client ID
API 호출에서 당신의 PayPal 앱을 식별합니다. Client secret과 짝지어질 때만 작동합니다.
Client secret
API 인증의 비공개 절반. Client ID와 함께 주문을 만들게 해, 결제가 당신의 계정을 통해 실행됩니다.
Webhook ID
웹훅이 진짜 PayPal에서 온 것임을 확인하는 방법: PayPal은 각 웹훅을 ID로 식별하며, 우리는 그것으로 PayPal에 특정 메시지가 진짜인지 직접 묻습니다. 그것이 누구든 "결제됨" 이벤트를 위조하는 것을 막습니다.
Success and Cancel URL
단순한 설정: 구매자가 결제 후 또는 빠져나간 뒤 도착하는 곳. 비밀이 아닙니다.
설정
- PayPal 개발자 대시보드 열기
developer.paypal.com에 로그인하세요. PayPal은 가짜 비즈니스 계정과 구매자가 있는 무료 샌드박스를 제공하므로 실제 돈 없이 테스트할 수 있습니다. 이 가이드는 샌드박스 기준으로 설명합니다. 라이브 흐름도 동일하며, Sandbox / Live 토글(왼쪽 상단)만 전환하고 PayPal for Business 계정을 사용하면 됩니다. 대시보드에서 Apps & Credentials를 여세요.
PayPal Developer → Apps & Credentials - 앱 만들기
API 자격 정보 페이지에서 Sandbox 토글이 선택되어 있는지 확인한 뒤, 앱 만들기(오른쪽 상단)를 클릭하세요.
PayPal → Apps & Credentials → 앱 만들기 - 이름 입력 및 판매자 선택하기
앱 이름(예: "Coin Moebius")을 입력하고, 유형은 판매자로 그대로 두고, 샌드박스 비즈니스 계정을 선택한 뒤 앱 만들기를 클릭하세요.
PayPal → 앱 만들기 - Client ID와 Client secret 복사하기
PayPal이 새 앱을 엽니다. Client ID를 복사하고, 비밀 키를 표시해 복사하세요. (API 자격 정보 목록의 기본 애플리케이션 행에서도 둘 다 복사할 수 있습니다.) 저장해 두세요.
1. PayPal → API 자격 정보 → 목록의 내 앱 2. PayPal → 내 앱 → Client ID 및 Secret Client secret은 비밀이며 비밀번호처럼 취급하세요. 샌드박스 앱과 라이브 앱은 각자의 쌍을 가지므로 혼용하지 마세요.
- 웹훅 추가하기
앱 페이지를 아래로 스크롤해 Sandbox Webhooks 섹션에서 웹훅 추가를 클릭하세요. Webhook URL 필드에 프로젝트의 PayPal 웹훅 주소(아래)를 붙여넣으세요. 그런 다음 Coin Moebius가 수신하는 이벤트를 선택하고 저장하세요.
- 일회성 결제: CHECKOUT.ORDER.APPROVED, PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.DENIED, PAYMENT.CAPTURE.DECLINED, PAYMENT.CAPTURE.REFUNDED, PAYMENT.CAPTURE.REVERSED, CUSTOMER.DISPUTE.CREATED.
- 구독(구독 판매 시만 해당): BILLING.SUBSCRIPTION.ACTIVATED, BILLING.SUBSCRIPTION.UPDATED, BILLING.SUBSCRIPTION.CANCELLED, BILLING.SUBSCRIPTION.PAYMENT.FAILED, PAYMENT.SALE.COMPLETED. 정기 결제를 사용하지 않으면 건너뛰세요.
- 빠르게 진행하시나요? 상단의 모든 이벤트(와일드카드)를 선택해도 됩니다. 사용하지 않는 것은 무시합니다.
https://api.coinmoebius.com/webhook/paypal/<your project id>PayPal → 내 앱 → 웹훅 추가 프로젝트 ID는 Coin Moebius 대시보드의 프로젝트 이름 아래에 있습니다. 위 주소에 입력하세요. 연결된 제공업체 카드(마지막 단계)에도 같은 URL이 표시됩니다.
- Webhook ID 복사하기
이제 Sandbox Webhooks 목록에 웹훅이 표시됩니다. 옆에 표시된 Webhook ID를 복사하세요. 이것으로 Coin Moebius가 PayPal에 각 웹훅의 진위 여부를 확인합니다. 샌드박스와 라이브에 별도의 웹훅을 등록하세요.
PayPal → 내 앱 → Sandbox Webhooks → Webhook ID - Coin Moebius로 돌아와 제공업체 추가 → PayPal
프로젝트에서 제공업체 탭을 열고, 제공업체 추가를 클릭하고, 서비스 연결을 선택한 뒤 PayPal을 고르세요. Success URL과 Cancel URL을 설정하세요. 샌드박스 자격 정보로 테스트하시나요? Test(선택) 탭에서 Client ID, Client secret, Webhook ID를 붙여넣은 뒤 저장을 클릭하세요. 바로 라이브로 시작하시나요? Live 탭을 사용하세요. Test 그룹은 전부 아니면 전무입니다. 세 필드 모두이거나 하나도 없거나.
Coin Moebius → 제공업체 추가 → PayPal - 연결 완료
이제 제공업체 탭에 PayPal이 연결 날짜와 함께 표시됩니다(샌드박스 자격 정보 사용 시 TEST 태그 표시). 카드에는 PayPal에 붙여넣은 것과 동일한 웹훅 URL과 편집 및 연결 해제 버튼이 있습니다.
Coin Moebius → 제공업체 → PayPal (연결됨) - 샌드박스 구매자로 테스트하기
테스트 결제를 진행하려면 샌드박스 구매자 로그인이 필요합니다. PayPal에서 테스트 도구 → 샌드박스 계정을 열어 가짜 비즈니스 계정과 개인 계정을 확인하세요.
PayPal → 테스트 도구 → 샌드박스 계정 - 구매자 로그인 정보 확인하기
개인(구매자) 계정을 열어 로그인 정보를 확인하세요: 샌드박스 URL, 이메일, 비밀번호가 표시됩니다. 테스트 결제 시 sandbox.paypal.com에 해당 정보로 로그인하세요. 실제 돈은 움직이지 않습니다.
PayPal → 샌드박스 계정 → 로그인 정보
연결한 후
정식 오픈 전에 테스트 결제를 한 번 실행하세요:
- 상품을 만들고 Environment를 Testing으로 설정하세요. 그러면 상품이 당신의 샌드박스 자격 정보로 실행되어, 돈을 움직이지 않고 전체 주문을 넣을 수 있습니다. (샌드박스 세트를 건너뛰었다면 Testing 상품이 라이브로 폴백되니, 먼저 추가하세요.)
- 당신의 프로젝트를 가리키는 페이지(로컬 HTML 파일도 됩니다)에 구매 버튼을 두세요.
- 샌드박스 구매자 계정으로 결제해 결제를 완료하세요.
- 거래 탭을 여세요. Testing 태그가 붙은 새 행이 나타납니다. 상태가 succeeded에 도달하면, 당신의 자격 정보와 웹훅이 둘 다 처음부터 끝까지 작동하는 것입니다.
실제 결제 준비가 되면 상품 Environment를 Live로 전환하세요.
문제 해결
Verify로 시작하세요. 대시보드에서 Verify(또는 샌드박스의 경우 Verify test credentials)를 클릭해 클라이언트 자격 정보를 확인하세요.
Verify가 실패합니다.
Client ID와 Client secret을 다시 복사하세요. 샌드박스 앱과 라이브 앱은 다른 쌍을 가지므로 섞지 마세요.
결제는 완료되는데 주문이 대기 상태로 남습니다.
Webhook ID는 클라이언트 자격 정보와 같은 앱 및 환경에서 와야 합니다. 라이브 자격 정보에는 라이브 webhook id가 필요합니다. 웹훅 URL이 일치하는지 확인하세요.
처음부터 끝까지 확인하기.
PayPal Developer Dashboard → Webhooks Simulator: 샘플 이벤트를 당신의 웹훅 URL로 보낸 뒤, 주문이 업데이트되는 것을 지켜보세요.
알아두면 좋은 것
시크릿 교체. 새 client secret을 언제든 생성한 뒤 붙여넣으세요. 비밀 필드는 편집 시 비어 있습니다.
질문이 있으신가요? Join our Discord