View Categories

Stripe를 Google 스프레드시트에 연결하는 방법 - SQL로 결제 데이터 쿼리하기

5분 읽기

Query Streams는 Stripe 계정을 Google Sheets에 SQL 쿼리가 가능한 테이블로 연결하여 고객, 송장, 구독, 요금 등 모든 데이터를 표준 SQL을 사용하여 액세스할 수 있도록 합니다. API 프로그래밍도, 수동 내보내기도, CSV 파일 처리도 필요 없습니다. SQL 쿼리만 작성하면 Stripe 데이터를 실시간으로 스프레드시트에 가져올 수 있습니다. QueryStreams.com에서 무료로 가입하세요. 몇 분 안에 Stripe 계정에 대한 조회를 시작할 수 있습니다.

15개의 Stripe 테이블

고객, 송장, 구독, 요금, 잔액 거래 등

거의 실시간

청구 내역과 결제 의도는 최소 5분마다 동기화됩니다.

AES-256 암호화

API 키와 캐시된 데이터는 클라우드가 아닌 사용자 네트워크에 안전하게 저장됩니다.

API 노출 제로

Stripe 키를 공개하지 않고도 팀원들과 매출 보고서를 공유할 수 있습니다.

Stripe에서 어떤 데이터에 접근할 수 있나요?

Query Streams는 Stripe API 데이터를 AES-256으로 암호화된 로컬 캐시에 동기화하고, 이를 15개의 SQL 쿼리 가능한 테이블로 변환합니다. 각 테이블에는 다음이 포함됩니다. raw_data 모든 메타데이터 필드를 포함한 Stripe API 응답 전체가 담긴 JSON 열입니다.

핵심 사업

  • 고객 청구 정보 및 메타데이터가 포함된 고객 기록
  • 결제 의도 최신 결제 흐름 추적
  • 송장 청구 기록 및 납기일
  • 구독 정기 결제 구독
  • 요금 결제 수수료(기존 및 현재)

재무 및 조정

  • 잔액 거래 전체 장부 (수수료, 지급액, 이체 내역)
  • 환불 고객에게 환불된 금액
  • 지급금 은행 송금 추적
  • 분쟁 환불 요청 및 사기 사건

카탈로그 및 가격

  • 제품 제품 카탈로그
  • 물가 가격 등급 및 구성
  • 쿠폰 할인 코드 및 프로모션

활동 및 세부 정보

  • 이벤트 웹훅 백업 및 감사 추적
  • 송장 항목 항목별 청구 상세 내역
  • 구독 항목 다중 제품 구독 분석

전제 조건

1
스트림 계정 쿼리

무료로 가입하세요 — 신용카드 필요 없음

2
쿼리 스트림 네트워크 에이전트

네트워크에 설치된 Windows 서비스입니다. 설치 가이드

3
스트라이프 계정

API 접근 권한이 있는 모든 Stripe 계정 (실제 모드 또는 테스트 모드)

4
Stripe 비밀 API 키

~로 시작합니다 sk_live_ 또는 sk_test_ — Stripe 대시보드에서

5
Google 스프레드시트

Google Workspace Marketplace에서 Query Streams 추가 기능을 설치하면

설치 가이드

1에이전트 설치
2API 키 가져오기
3커넥터 추가
4동기화 일정
5추가 기능 설치

1단계: Query Streams 네트워크 에이전트를 설치합니다.

  1. 로그인하세요 my.querystreams.com
  2. 다음으로 이동하세요 네트워크 에이전트 왼쪽 사이드바에
  3. 클릭 다운로드 에이전트 그리고 윈도우 설치 프로그램을 실행하세요.
  4. 에이전트는 Windows 서비스로 설치되며 자동으로 연결됩니다.
  5. 담당 상담원이 30초 이내에 포털에서 "온라인"으로 표시됩니다.

네트워크 에이전트는 안전한 아웃바운드 전용 연결을 생성합니다. 인바운드 방화벽 포트가 필요 없으며 VPN도 필요하지 않습니다. Stripe API 키는 네트워크를 벗어나지 않습니다.

2단계: Stripe 비밀 API 키를 받으세요

  1. 로그인하세요 Stripe 대시보드
  2. 클릭 개발자 상단 탐색 메뉴에
  3. 선택하다 API 키 왼쪽 사이드바에서
  4. 복사하세요 비밀 키 (다음으로 시작합니다) sk_live_ 생산을 위해 또는 sk_test_ (테스트용)
  5. 이 키를 안전하게 보관하세요. 이 키를 사용하면 Stripe 데이터에 대한 전체 읽기 권한이 부여됩니다.

공개 키가 아닌 비밀 키를 사용하십시오. 공개 가능한 키(다음으로 시작) pk_) API 요청을 인증할 수 없습니다. Query Streams는 읽기 작업만 수행하며 Stripe 데이터를 수정하지 않습니다.

3단계: Stripe 커넥터를 추가합니다.

  1. 네트워크 에이전트 인터페이스를 엽니다. http://localhost:1823
  2. 클릭 연결 추가 그리고 선택하세요 스트라이프
  3. 붙여넣으세요 API 비밀 키 API 키 필드에 입력하세요
  4. 클릭 연결 테스트 — Query Streams는 Stripe를 사용하여 키를 검증합니다.
  5. 성공하면 계정 모드(실제 계정 또는 테스트 계정)에 대한 확인 메시지가 표시됩니다.
  6. 클릭 다음 구성 동기화를 진행하려면

4단계: 동기화 일정 구성

청구/지불 의사5분마다
청구서/구독15분마다
고객/환불15분마다
잔액 거래30분마다
제품/가격시간당
사건/분쟁일일

기본적으로 15개 테이블 모두 동기화됩니다. 동기화 간격을 설정하여 특정 테이블의 동기화를 비활성화할 수 있습니다. 절대클릭 저장 — 초기 동기화가 즉시 시작됩니다.

5단계: Google Sheets 추가 기능을 설치합니다.

  1. 브라우저에서 Google Sheets를 엽니다.
  2. 가다 확장 기능추가 기능추가 기능을 받으세요
  3. 검색 "쿼리 스트림"
  4. 클릭 설치하다 필요한 권한을 부여합니다.
  5. 다음을 통해 접속하세요 확장 기능쿼리 스트림열려 있는
  6. Query Streams 계정 자격 증명으로 로그인하세요.
  7. 또는 직접 설치하세요: Google 스프레드시트용 쿼리 스트림 설치

연결되었습니다! Google Sheets에서 쿼리 스트림을 열고 클릭하세요. 저장된 쿼리그리고 미리 작성된 쿼리가 포함된 Stripe 폴더를 찾으세요. 원하는 쿼리를 선택하고 클릭하세요. 실행 Stripe의 실시간 데이터를 스프레드시트로 가져오려면.

Stripe SQL 쿼리 예시

월별 매출 요약
SELECT DATE_TRUNC('month', created) AS month, COUNT(*) AS charge_count, SUM(amount) / 100.0 AS gross_revenue, SUM(CASE WHEN refunded THEN amount_refunded ELSE 0 END) / 100.0 AS refunds, (SUM(amount) - SUM(CASE WHEN refunded THEN amount_refunded ELSE 0 END)) / 100.0 AS net_revenue FROM stripe.charges WHERE status = 'succeeded' AND created >= CURRENT_DATE - INTERVAL '12 months' GROUP BY DATE_TRUNC('month', created) ORDER BY month DESC;
플랜별 활성 구독 현황
SELECT p.name AS product_name, pr.nickname AS plan_name, pr.interval AS billing_interval, pr.unit_amount / 100.0 AS price, COUNT(s.id) AS active_subscribers, COUNT(s.id) * pr.unit_amount / 100.0 AS mrr_contribution FROM stripe.subscriptions s JOIN stripe.subscription_items si ON si.subscription = s.id JOIN stripe.prices pr ON pr.id = si.price JOIN stripe.products p ON p.id = pr.product WHERE s.status = 'active' GROUP BY p.name, pr.nickname, pr.interval, pr.unit_amount ORDER BY mrr_contribution DESC;
결제 실패 분석
SELECT DATE(created) AS date, failure_code, failure_message, COUNT(*) AS failure_count, SUM(amount) / 100.0 AS lost_revenue FROM stripe.charges WHERE status = 'failed' AND created >= CURRENT_DATE - INTERVAL '30 days' GROUP BY DATE(created), failure_code, failure_message ORDER BY date DESC, failure_count DESC;

자격 증명을 공유하지 않고 Stripe 보고서를 공유하세요

쿼리 빌더에서 Stripe 쿼리를 열고 → 클릭하세요. 공유 탭 → 팀원 이메일 주소 입력 → 클릭 공유수신자는 Google Sheets 추가 기능에서만 쿼리를 받게 됩니다. 필요에 따라 쿼리를 실행하여 실시간 데이터를 가져오며, Stripe API 키는 절대 노출되지 않고 SQL 코드도 볼 수 없습니다.

자주 묻는 질문

Stripe 테스트 모드 API 키를 사용할 수 있나요?
예. Query Streams는 라이브 스트림과 라이브 스트림 모두에서 작동합니다.sk_live_) 및 테스트(sk_test_API 키. 테스트 모드는 프로덕션 계정을 연결하기 전에 통합 기능을 평가하는 데 적합합니다.
charges와 payment_intents의 차이점은 무엇인가요?
청구 건(Charges)은 개별 결제 거래를 나타냅니다. 결제 의도(Payment Intents)는 전체 결제 라이프사이클을 추적하는 최신 Stripe 결제 흐름 객체입니다. 과거 보고에는 charges를 사용하고, 새로운 통합에는 payment_intents를 사용하세요.
Query Streams는 얼마나 많은 과거 Stripe 데이터를 동기화하나요?
기본적으로 Query Streams는 각 테이블의 최신 데이터를 동기화합니다. 커넥터 설정에서 조회 기간을 조정할 수 있습니다. 거래량이 많은 계정의 경우 초기 동기화에 몇 분이 소요될 수 있습니다.
여러 개의 Stripe 계정을 연결할 수 있나요?
네. 하나의 에이전트에 여러 개의 Stripe 연결을 추가할 수 있으며, 각 연결에는 서로 다른 API 키가 할당됩니다. 각 연결은 쿼리 빌더에서 별도의 데이터 소스로 표시되므로 동일한 SQL 쿼리에서 여러 Stripe 계정을 조회하고 비교할 수 있습니다.

관련 가이드

카테고리: API 커넥터

태그: Stripe, Google Sheets, API, 결제 데이터, SQL, 매출 분석, 구독, 실시간 데이터

메타 설명: SQL을 사용하여 Stripe를 Google Sheets에 연결하세요. API 코딩 없이 고객, 송장, 구독 및 청구 내역을 실시간으로 조회할 수 있습니다. 단계별 설정 가이드가 제공됩니다.

Updated on 2026년 6월 3일

Powered by BetterDocs