메인 콘텐츠로 건너뛰기

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 커넥터는 Starter, Core, Pro 사용자에게만 지원됩니다. 현재 팀 워크스페이스에서는 사용할 수 없습니다.

​
빌드할 수 있는 것

Agent를 사용하여 클릭 한 번으로 앱에 Stripe를 추가하세요. 별도의 설정이 필요하지 않습니다. 스토어프론트를 빌드하거나, 일회성 결제를 수락하거나, 구독을 만드세요. Agent가 연동, 데이터 모델, 테스트 환경을 연결합니다.

​
작동 방식

Agent는 실제 돈을 이동하지 않고도 결제를 안전하게 테스트할 수 있도록 Stripe 샌드박스부터 시작합니다. 즉시 흐름을 빌드하고 사용해 볼 수 있습니다. 준비가 되면 라이브 Stripe 계정으로 전환하여 게시하고 실제 결제를 수락하세요.
Stripe 샌드박스는 결제, 구독, 이벤트를 시뮬레이션할 수 있는 격리된 테스트 환경입니다. 샌드박스에 대한 Stripe 문서에서 자세히 알아보세요.

​
시작하기

  • Agent에게 Stripe 사용 요청
    • 홈 화면에서 슬래시 명령을 사용하고 Stripe를 선택하거나 직접 요청하세요:
Stripe 연동에는 백엔드 기능이 있는 앱이 필요합니다. 시작하려면 홈페이지에서 앱을 선택하세요.

​
샌드박스에서 결제 테스트하기

  1. 새 탭에서 앱의 미리보기를 여세요.
  2. 스토어프론트 또는 결제 페이지에서 테스트 구매를 하세요.
  3. Stripe의 표준 테스트 카드를 사용하세요:
카드 번호: 4242 4242 4242 4242
만료일: 미래의 임의 날짜
CVC: 임의의 3자리 숫자
이름, 주소: 임의의 가상 값
샌드박스 구매는 실제 네트워크를 통해 처리되거나 돈을 이동하지 않습니다. 끝까지 안전하게 테스트할 수 있습니다.

​
상품 및 가격 관리하기

두 가지 옵션이 있습니다:
  1. 앱에서 게시를 선택한 다음 Stripe 샌드박스를 청구하도록 선택합니다.
    • Stripe 계정이 아직 없다면 샌드박스를 청구하기 위해 계정을 만드세요.
  2. Stripe 대시보드에서 상품을 열어 상품 및 가격을 추가하거나 수정하세요. Stripe 샌드박스에서 변경한 내용은 Replit 앱에 자동으로 반영되고 앱의 데이터베이스에 동기화됩니다.

​
동기화된 Stripe 데이터 보기

  • 프로젝트 편집기에서 데이터베이스를 여세요.
  • MyData를 선택하세요.
  • 스키마 선택기를 Stripe로 변경하여 결제 객체와 관련 레코드를 확인하세요.

​
라이브 전환하기

실제 결제를 수락하려면:
게시 전에:
  • 라이브 Stripe 계정에 Replit 통합 결제 앱을 설치하세요 (샌드박스에서 라이브 동기화에 필요)
  • Stripe의 KYB 인증을 완료하고 라이브 API 키를 추가하세요
샌드박스 연동은 프로덕션용이 아닙니다. 이 단계를 완료할 때까지 실제 결제를 수락할 수 없습니다.
  1. Stripe에서 샌드박스에서 라이브 계정으로 전환하세요.
  2. 메시지가 표시되면 Stripe의 KYB(기업 인증) 인증을 완료하세요.
  3. Stripe에서 라이브 공개 키와 시크릿 키를 복사하세요.
  4. Replit에서 게시 창을 열고 라이브 키를 추가하세요.
  5. 앱을 게시하세요.

​
연동 관리하기

  • 연동 > Stripe로 이동하여 Stripe 커넥터를 여세요.
  • 연결을 테스트하고, 상태를 확인하고, 설정을 관리할 수 있습니다.

​
자주 묻는 질문

​
상품 가격은 어떻게 업데이트하나요?

  • Agent에게 요청: 변경 사항을 설명하면 Agent가 앱과 Stripe 객체를 업데이트합니다.
  • Stripe 대시보드 사용: 상품을 열어 가격과 상품 세부 정보를 수정하세요.
    • 샌드박스에서 변경 사항은 앱과 데이터베이스에 자동으로 다시 동기화됩니다.
    • 프로덕션의 경우 먼저 라이브 계정으로 전환한 다음 가격을 업데이트하세요. 앱이 새 구성을 가져와야 하는 경우 다시 게시하세요.

​
Replit에서 거래를 어떻게 테스트하나요?

새 탭에서 앱의 미리보기를 여세요. 표준 테스트 카드(4242 4242 4242 4242), 미래의 임의 만료일, 임의의 CVC로 Stripe Checkout 흐름을 실행하세요. 자세한 내용은 위의 샌드박스에서 결제 테스트하기를 참조하세요.

​
라이브 Stripe 계정이란 무엇인가요?

라이브 Stripe 계정은 비즈니스 세부 정보를 사용하여 실제 결제를 처리할 수 있는 활성화 및 인증된 계정입니다. 계정 생성 및 활성화에 대한 Stripe 가이드를 참조하세요: Stripe 계정 만들기 및 관리하기.

​
라이브 키는 어디서 찾나요?

  1. Stripe 대시보드에서 계정 선택기(왼쪽 상단)를 사용하여 라이브 계정으로 전환하세요.
  2. 왼쪽 하단에서 개발자 > API 키를 선택하세요.
  3. 라이브 키를 공개하거나 새로운 키를 만드세요. 새 키를 만드는 단계별 지침은 시크릿 API 키 만들기를 참조하세요.

​
Stripe 연결 업데이트 또는 제거하기

라이브 Stripe 키로 게시할 준비가 되지 않은 경우 세 가지 옵션이 있습니다:

​
옵션 A: 플레이스홀더 API 키 사용하기

나중에 교체할 수 있는 Stripe 플레이스홀더 키를 사용할 수 있습니다.
플레이스홀더 키는 실제 결제를 처리하지 않습니다. 라이브 Stripe 키를 추가할 때까지 게시된 URL에서 카탈로그와 결제 페이지가 작동하지 않습니다. 이 옵션은 테스트 목적으로만 사용하세요.
1

게시 탭으로 이동하기

프로젝트 편집기에서 게시 창을 여세요.
2

플레이스홀더 키 입력하기

다음 값을 사용하세요:공개 키:
pk_live_abcdef
시크릿 키:
sk_live_abcdef

​
옵션 B: Stripe 연동 수동으로 제거하기

프로젝트에서 Stripe 연동을 완전히 제거할 수 있습니다.
1

프로젝트 열기

제거하려는 Stripe 연동이 있는 프로젝트로 이동하세요.
2

새 탭을 열고 연동 입력하기

Replit 네이티브 및 외부 서비스에 연결하는 연동 옵션을 보여주는 새 탭 검색
3

아래로 스크롤하여 Stripe를 찾고 관리 선택하기

관리 버튼이 있는 Stripe 연동을 보여주는 커넥터 패널
4

프로젝트 이름 선택하기

연결 세부 정보가 열립니다.
5

편집 선택하기

공개 키, 시크릿 키, 편집 버튼이 있는 Stripe 샌드박스 계정
6

삭제 선택하기

삭제 및 업데이트 버튼이 있는 Stripe 샌드박스 계정
7

Agent에게 Stripe 코드 제거 요청하기

Agent 채팅으로 이동하여 Agent에게 애플리케이션에서 Stripe 커넥터 코드를 제거하도록 요청하세요. 그러면 전체 Stripe 연동이 제거됩니다.

​
옵션 C: Stripe 연동 이전 체크포인트로 롤백하기

Stripe 연동을 완전히 취소하고 이전 상태로 돌아가려면 이전 체크포인트로 롤백할 수 있습니다.
1

프로젝트 열기

제거하려는 Stripe 연동이 있는 프로젝트로 이동하세요.
2

새 탭을 열고 연동 입력하기

연동 옵션을 보여주는 새 탭 검색
3

아래로 스크롤하여 Stripe를 찾고 관리 선택하기

관리 버튼이 있는 Stripe 연동을 보여주는 커넥터 패널
4

프로젝트 이름 선택하기

연결 세부 정보가 열립니다.
5

편집 선택하기

편집 버튼이 있는 Stripe 샌드박스 계정
6

삭제 선택하기

삭제 버튼이 있는 Stripe 샌드박스 계정
7

Stripe 연동 이전 체크포인트 찾기

Agent 채팅으로 이동하여 Stripe 연동 이전에 만들어진 체크포인트를 찾으세요. 채팅 창 왼쪽 상단의 시계 아이콘을 선택하여 오래된 채팅 기록을 확인하세요.
채팅 기록과 체크포인트를 보기 위한 시계 아이콘
8

여기서 롤백 선택하기

좋아 보이는 체크포인트를 찾으면 여기서 롤백을 선택하여 프로젝트를 해당 상태로 복원하세요.
여기서 롤백 버튼이 있는 체크포인트

​
참고 사항 및 제한 사항

  • 샌드박스 활동은 실제 잔액이나 고객에게 영향을 주지 않습니다.
  • 일부 Stripe 기능은 샌드박스에서 테스트할 수 없습니다(예: IC+ 가격 및 특정 Connect 흐름). Stripe의 샌드박스 제한 사항을 참조하세요.