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

# 결제 및 Stripe

> 연결 방법 선택, 시크릿 키 이름 지정, 샌드박스 오류, 비즈니스 인증, 라이브 결제 앱 등 자주 묻는 Stripe 질문에 대한 답변입니다.

이 답변들은 앱에 Stripe를 연결하는 방법을 다룹니다. 두 가지 설정 방법에 대해서는 [Stripe로 결제 받기](/ko/use-cases/accept-payments-with-stripe)를 참조하세요. 커넥터에 대한 자세한 내용은 [Stripe 결제](/ko/features/monetization/stripe-payments)를 참조하세요.

<AccordionGroup>
  <Accordion title="Replit을 통해 Stripe를 연결해야 하나요, 아니면 직접 가진 키를 사용해야 하나요?">
    Stripe는 두 가지 방법으로 연결할 수 있습니다.

    * **Replit Stripe 커넥터:** Agent가 Stripe 샌드박스를 설정하고, 라이브로 전환할 때 Stripe 앱을 설치합니다. 커넥터는 유료 플랜에서 사용할 수 있습니다.
    * **직접 가진 키 사용(웹훅 또는 Stripe SDK):** **Secrets**에서 직접 관리하는 수동 설정입니다.

    환경마다 한 가지 방법만 사용하세요. Agent가 웹훅 추가를 제안하더라도 같은 환경에서 두 방법을 함께 사용하면 연결 충돌이 발생합니다. 개발과 프로덕션에서 서로 다른 방법을 사용할 수도 있습니다. 예를 들어 빌드하는 동안에는 커넥터를 사용하고, 게시한 후에는 직접 가진 키를 사용할 수 있습니다.

    [환경마다 한 가지 방법 선택하기](/ko/use-cases/accept-payments-with-stripe#환경마다-한-가지-방법-선택하기)를 참조하세요.
  </Accordion>

  <Accordion title="수동 Stripe 설정에서 시크릿 이름은 무엇으로 지정해야 하나요?">
    **Secrets**에서 Stripe 시크릿 키의 이름을 `STRIPE_SECRET_KEY`로 지정하세요. 이는 웹훅 설정과 Stripe SDK 설정 모두에 적용됩니다. 값에는 직접 가진 키를 사용하고, 애플리케이션 코드에는 포함하지 마세요.

    **Tools**를 열고 **Setup** 아래에서 **Secrets**를 선택한 다음 **New Secret**을 선택하세요.
    **Key**에 `STRIPE_SECRET_KEY`를 입력하고 **Value**에 Stripe 키를 입력하세요.

    <Frame caption="이 예시는 값을 입력하기 전에 필수 이름을 보여 줍니다.">
      <img src="https://mintcdn.com/replit/2n-A_ptJoYn-gb3a/images/stripe/secret-name-context.png?fit=max&auto=format&n=2n-A_ptJoYn-gb3a&q=85&s=1133c28885534c63747df325de6ba576" alt="Secrets 탐색 메뉴와 Key에 STRIPE_SECRET_KEY가 입력된 새 시크릿 양식" width="2720" height="2040" data-path="images/stripe/secret-name-context.png" />
    </Frame>

    게시한 앱의 시크릿에도 `STRIPE_SECRET_KEY`가 포함되어 있는지 확인하고, 변경한 후에는 다시 게시하세요. 개발에서 Replit Stripe 커넥터의 샌드박스를 사용하고 프로덕션에서 직접 가진 키를 사용하는 경우, 게시된 값은 `sk_live_` 또는 `rk_live_`로 시작하는 라이브 키여야 합니다. 그렇지 않으면 **Connect a live Stripe account before publishing.** 메시지와 함께 게시가 중단됩니다.

    [직접 가진 라이브 키로 게시하기](/ko/use-cases/accept-payments-with-stripe#publish-with-your-own-live-keys)를 참조하세요.
  </Accordion>

  <Accordion title="Stripe가 샌드박스 클레임을 차단하거나 샌드박스가 너무 많다고 표시합니다. 어떻게 해야 하나요?">
    오류에 맞는 조치를 취하세요.

    * **샌드박스가 이미 사용 중인 경우:** 해당 샌드박스를 클레임하는 대신 새 샌드박스를 만드세요.
    * **샌드박스 한도에 도달한 경우:** Stripe에서 이미 가지고 있는 샌드박스를 통합한 다음 다시 시도하세요.

    잘못되었거나 만료된 클레임 토큰 오류가 표시되면 [Replit 지원팀에 문의](https://replit.com/support)하세요.
  </Accordion>

  <Accordion title="Stripe에서 비즈니스 인증을 완료했는데 Replit에서 여전히 미완료로 표시되는 이유는 무엇인가요?">
    비즈니스 인증은 Stripe 포털에서 진행됩니다. Replit은 사용자가 확인할 때까지 해당 단계를 열어 둡니다.

    1. Stripe에서 비즈니스 인증을 완료하세요.
    2. Replit으로 돌아와 **Got It**을 선택하여 설정을 계속하세요.

    Stripe에서 인증을 완료하는 것만으로는 이 단계를 넘어갈 수 없습니다.
  </Accordion>

  <Accordion title="라이브 설정 중에 Stripe가 샌드박스 결제 앱을 선택했습니다. 라이브 앱은 어떻게 선택하나요?">
    설치 흐름에서 결제 앱의 샌드박스 버전이 자동으로 선택되어 오류가 발생할 수 있습니다. 해결하려면 다음을 따르세요.

    1. Stripe 설치 흐름에서 앱의 **Live Mode** 버전을 직접 선택하세요.
    2. 샌드박스나 테스트 계정이 아닌 라이브 Stripe 계정으로 설치하세요.
    3. 설치가 끝날 때까지 Stripe 창을 열어 두세요.

    [라이브 전환하기](/ko/features/monetization/stripe-payments#라이브-전환하기)를 참조하세요.
  </Accordion>
</AccordionGroup>

## 도움이 더 필요하신가요?

여기서 Stripe 관련 질문의 답변을 찾을 수 없다면 [Replit 지원팀에 문의](https://replit.com/support)하세요.