> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumi.new/llms.txt
> Use this file to discover all available pages before exploring further.

# PayPal

> 웹사이트에서 PayPal 결제와 구독을 받으세요.

PayPal 결제는 Lumi 채팅만으로 모두 설정할 수 있습니다. 요청에 PayPal을 명시하고 판매하고 싶은 것을 설명하세요.

* "내 전자책을 PayPal로 \$15 일회성 결제로 살 수 있게 해 줘."
* "PayPal로 청구되는 월 \$9.99 멤버십을 추가해 줘."

PayPal 앱 자격 증명이 있으면 Lumi가 PayPal 비즈니스 계정에서 직접 작업하고 웹사이트에 결제 흐름 전체를 구축합니다.

* **일회성 결제**: 구매자를 PayPal로 보내 결제를 승인받는 PayPal 버튼을 만들고, 완료된 결제를 데이터베이스에 기록합니다.
* **구독**: Lumi가 PayPal 계정에 상품과 구독 플랜을 만들고(이름과 가격이 같은 기존 항목은 재사용), 구독 버튼을 추가하며, 각 구독의 상태를 최신으로 유지합니다.
* **웹훅**: Lumi가 웹훅을 등록하여 결제가 완료되거나 환불될 때, 그리고 구독이 활성화·취소·일시 중지되거나 갱신에 실패할 때 웹사이트가 알림을 받도록 합니다.
* **요금 페이지와 접근 제한**: 유료 콘텐츠는 결제한 고객에게만 표시됩니다.

언제든지 Lumi에게 PayPal 계정에 대해 물어볼 수도 있습니다. 예: "최근 거래 내역을 보여 줘", "구독 플랜 목록을 보여 줘", "이 주문을 환불해 줘", "이 구독을 취소해 줘".

> [!NOTE]
>
> PayPal은 웹 프로젝트에서 사용할 수 있습니다. 결제 제공업체를 지정하지 않으면 Lumi는 [Stripe](https://docs.lumi.new/ko/features/stripe.md)를 사용합니다.

## PayPal 자격 증명 연결

**1. PayPal에서 REST 앱 만들기**

PayPal Developer Dashboard에서 **Apps & Credentials**로 이동하여 REST 앱을 만들거나 엽니다. 테스트에는 **Sandbox** 탭을, 실제 결제에는 **Live** 탭을 사용하세요. 앱의 **Client ID**와 **Secret key**를 복사하세요.

**2. Lumi에 자격 증명 입력**

Lumi가 채팅에 표시하는 PayPal 자격 증명 카드를 채우거나, 워크스페이스의 **도구** 탭을 열고 **PayPal** 카드를 클릭하세요. **PayPal client ID**와 **PayPal client secret**을 입력하고 **Environment**(환경)에서 **샌드박스(테스트)** 또는 **실서비스**를 선택한 뒤 **저장**과 **확인**을 클릭하세요.

> [!WARNING]
>
> 자격 증명을 채팅 메시지에 절대 붙여넣지 마세요. 자격 증명은 프로젝트의 [시크릿](https://docs.lumi.new/ko/features/secrets.md)에 안전하게 저장됩니다. 샌드박스 자격 증명은 샌드박스 환경에서만, 라이브 자격 증명은 실서비스 환경에서만 동작합니다. 이 둘이 맞지 않는 것이 PayPal이 자격 증명을 거부하는 가장 흔한 원인입니다.

### Lumi가 변경할 수 있는 범위 설정

도구 탭의 **PayPal** 카드에서는 PayPal 계정을 변경하는 모든 작업마다 승인 설정이 있습니다. **항상 허용**, **매번 확인**, **허용 안 함** 중에서 고를 수 있습니다. 기본적으로 상품과 플랜 생성은 허용되며, **환불**과 **구독 취소**는 매번 승인을 요청합니다. 거래 내역 조회 같은 읽기 전용 작업은 항상 허용됩니다.

## 테스트 및 실서비스 전환

**1. 샌드박스에서 테스트**

샌드박스 자격 증명을 사용하면 실제 돈이 오가지 않습니다. PayPal 페이지에서 샌드박스 구매자 계정으로 로그인하세요(PayPal Developer Dashboard → **Testing Tools** → **Sandbox Accounts** → Personal 계정의 이메일과 비밀번호). 결제 후 결제 또는 구독 기록이 [클라우드 → 데이터](https://docs.lumi.new/ko/features/databases.md)에 나타나는지, 페이지에 구매 내용이 표시되는지 확인하세요.

**2. 실서비스로 전환**

PayPal에서 Live 앱을 만든 뒤 **PayPal** 카드에 그 앱의 Client ID와 Secret을 입력하고 Environment를 **실서비스**로 설정하세요. Lumi에게 실서비스로 전환해 달라고 요청하세요. 샌드박스의 상품과 플랜은 이어지지 않으므로, Lumi가 라이브 계정에 다시 만들고 웹훅을 다시 등록합니다.

**3. 최종 테스트 및 출시**

저렴한 상품으로 한 번 더 테스트한 뒤 웹사이트를 게시하고 공유하세요.

어느 단계에서든 문제가 생기면 Lumi에게 알려 주세요. Lumi가 PayPal 계정과 함수 로그를 확인해 문제를 찾아 수정합니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.