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

Stripe를 Google Sheets에 연결

다음에서 데이터를 가져오세요 스트라이프 ~ 안으로 Google 스프레드시트

Stripe 계정에서 실시간으로 데이터를 가져와 Google Sheets에 불러오고 원할 때마다 새로 고칠 수 있습니다. CSV 파일 업로드, Apps Script, 복사 붙여넣기 작업이 필요 없습니다. 처음 설정하는 데 약 10분 정도 소요되며, 무료 플랜으로 이용 가능합니다.

약 10분 코딩이 필요 없습니다 자격증명은 영구적으로 보관됩니다. 어떤 브라우저든, 어떤 기기든

당신이 최종적으로 얻게 될 것

Stripe 계정에 대한 SQL 쿼리 결과를 실시간으로 보여주는 Google 스프레드시트입니다. 데이터가 변경될 때마다 최신 행을 가져오는 버튼도 포함되어 있습니다. 예를 들어 다음과 같습니다.

영업 드라이브에 저장됨

파일편집하다보다끼워 넣다체재데이터도구확장 기능돕다

	A	B	C	D	E
1	customer_id	첫 번째 이름	성	국가	총
2	1042	마리아	알바레스	미국	1,284.50
3	1043	다니엘	오카포르	미국	612.00
4	1047	프리야	나이르	미국	2,090.75
5	1051	도마	산	미국	338.20
6	1056	루시아	페레이라	미국	1,455.00
7	1060	켄지	사토	미국	874.10
8

+ 고객 시트1 Stripe에서 생중계

Stripe는 API를 통해 사용자 데이터를 저장합니다. Google Sheets로 데이터를 가져오려면 일반적으로 최신 데이터가 필요할 때마다 Stripe 대시보드에서 CSV 파일로 내보내야 합니다. 하지만 Query Streams를 사용하면 이 과정을 생략할 수 있습니다. Agent라는 작은 도우미 프로그램이 데이터가 저장된 위치에서 쿼리를 실행하고, Google Sheets 추가 기능이 필요한 행을 요청합니다. 암호화된 링크를 통해 결과만 전송되므로 Google Sheets는 어떤 기기의 어떤 브라우저에서든 어디서든 접속할 수 있습니다.

필요한 것

Query Streams 계정

이 가이드를 이용하시려면 무료 플랜으로도 충분합니다. 지금 가입하세요. my.querystreams.com.

항상 켜져 있는 컴퓨터의 에이전트

백그라운드에서 실행되는 작은 프로그램으로, Google Sheets에서 Stripe 결제를 요청할 때 작동합니다. 인터넷 연결만 있으면 됩니다.

Stripe 로그인 정보

Stripe에 한 번 로그인하고 읽기 권한을 허용하면 됩니다. Query Streams에는 비밀번호를 입력할 필요가 없습니다.

5단계로 연결하세요

1. 계정을 만드세요

   가다 my.querystreams.com 가입하세요. 선택하세요. 무료 정식 플랜입니다. 체험판이 아니며, Stripe 계정 연결 및 Google Sheets에서 쿼리 실행 기능을 포함합니다.

2. 항상 켜져 있는 컴퓨터에 에이전트를 설치하십시오.

   로그인, 열기 다운로드인터넷에 접속할 수 있는 상시 가동 컴퓨터 또는 서버에 에이전트를 설치하십시오. 설치에는 약 1분 정도 소요되며, 이후에는 자동으로 시작됩니다.

   드라이버 대신 작은 프로그램을 사용하는 이유는 무엇인가요? 에이전트는 Windows, Mac 또는 Linux용으로 한 번만 설치하면 되며(Windows에서는 약 85MB, Mac 및 Linux에서는 100MB 조금 넘는 용량), 백그라운드에서 조용히 실행됩니다. 웹 브라우저와 마찬가지로 쿼리 스트림에 암호화된 연결을 한 번만 생성하므로 방화벽 포트를 열거나 VPN을 설정할 필요가 없습니다. 키는 해당 컴퓨터에 보관되며, 데이터는 필요한 경우 인터넷을 통해 사용자의 위치로 전송됩니다. 사용자가 해야 할 일은 추가 기능 설치뿐입니다.

   다운로드 페이지가 표시됩니다 액세스 키에이전트가 요청할 때 해당 코드를 붙여넣고 배지가 인식될 때까지 기다리세요. 쿼리 스트림에 연결됨에이전트 자체에서 할 수 있는 일은 그게 전부입니다.

   자세한 공략이 필요하시면 보여드리겠습니다. 윈도우, 스코틀랜드 사람, 리눅스.

3. Stripe 계정을 지정하세요

   브라우저로 돌아가서 열기 데이터 에이전트 (아래에 데이터 상단 메뉴에서 담당 에이전트를 확인하세요. (상단 메뉴에 있습니다.) 커넥터 추가 그리고 선택하세요 스트라이프. Need your Stripe credentials first? Open the walkthrough, then fill in:

   Create your Stripe credentials (about 8 minutes)

   Follow this with Stripe open in another tab. Query Streams keeps what you create here so your Agent can use it, and only ever reads from Stripe.

   Who can do this

   Account owner, Super Administrator, Administrator or Developer (the Stripe roles that can create API keys)

   추천

   Restricted API key with Read-only permissions (rk_live_… for live data, rk_test_… for a sandbox)

   시작하기 전에

   • A Stripe login with the Account owner, Super Administrator, Administrator or Developer role. Other roles (Analyst, View Only, Support and so on) cannot create API keys.
   • Access to the email inbox or phone Stripe sends verification codes to. Stripe asks for a code before it creates the key.
   • The Query Streams wizard open in another tab (Data Agents → Add connector → Stripe) with your Agent online, so you can paste the key the moment Stripe shows it.

   Steps

   1. Sign in and choose live data or a sandbox

      Sign in to the Stripe Dashboard. Stripe keeps live data and sandbox (test) data apart, and each has its own keys. For your real payments, stay in your business account, not a sandbox. For test data, open the Dashboard’s account picker, click Sandboxes, and open the sandbox you want.

      A live key cannot read sandbox data, and a sandbox key cannot read live data. If you want both, create one key in each and add each one as its own Stripe connector in Query Streams.

   2. Open the API keys page

      Open the API keys page. From inside the Dashboard you can also click Developers (bottom-left) and choose API keys. The page has two lists: Standard keys (publishable and secret keys) and Restricted keys.

      Using a sandbox? Open the sandbox first (step 1). Each sandbox has its own API keys page and its own keys.

   3. Start a restricted key

      In the Restricted keys list, click Create restricted key. Some accounts show it as + Create restricted key.

      Don’t use the publishable key (pk_…). It can’t read account data. A secret key (sk_…) also works in Query Streams, but it can do anything in your account, including refunds and payouts. Stripe recommends restricted keys, and Query Streams only needs to read.

   4. Say how the key will be used

      Stripe asks how you will use the key. Choose Building your own integration, then click Continue.

      Don’t choose Authorizing agent access to your account. That option tags the key for AI agents and adds Stripe’s approval rules. If you chose Providing this key to another website by mistake, tick Customize permissions for this key on the next screen. If you leave it unticked, Stripe gives the key its default permissions instead of the read-only list in step 7.

   5. Start from no permissions

      Stripe offers ready-made permission templates or a start from zero permissions. Choose to start from zero (pick your own permissions), so every permission begins at None.

      Stripe changes the wording on this screen often. Look for an option worded like Start from scratch or Choose my own, not a template. If the screen is not there, go straight to step 6.

   6. Name the key

      In Key name, type a name you will recognise later, for example Query Streams (read-only).

   7. Set Read on the 13 resources Query Streams syncs

      Each resource row has three choices: None, Read and Write. Click Read on these 13 rows and leave every other row at None. Under Core: Balance, Balance transaction sources, Charges and Refunds, Customers, Disputes, Events, Payment Intents, Payouts, Products. Under Billing: Coupons, Invoices, Prices, Subscriptions. To find a row fast, press Ctrl+F (Cmd+F on a Mac) and type the first word of its name.

      Never choose Write. Query Streams only reads, so a key with only Read can’t create charges, refunds or payouts, even if it leaks. You need Events even if you never sync the events table, because Query Streams reads Stripe’s event list to pick up changes between syncs. If you use Connect, leave the connected-account permissions at None. If a row name doesn’t match what you see, click Read on the All core resources and All Billing resources header rows instead. The key is still read-only, but it can read more than Query Streams uses.

   8. Create the key

      Click Create key.

   9. Enter the verification code

      Stripe sends a verification code by email or text message. Type it into the dialog. If the dialog doesn’t move on by itself, click Continue.

      No code? Check spam, or the phone number on your Stripe profile.

   10. Copy the key

       Stripe now shows the new key. It starts with rk_live_ (or rk_test_ in a sandbox). Click the key value to copy it, then paste it straight into Stripe Secret Key in the Query Streams wizard.

       In live mode, Stripe shows a key you created only this once and can’t reveal it again. Sandbox keys can be revealed at any time. Don’t send the key by email or chat. Query Streams stores it for your Agent and only ever reads with it.

   11. Note where the key is used

       In Add a note, type where the key is used, for example Query Streams Agent on the office computer. Then click Done. The key now appears in the Restricted keys list.

       The note shows up whenever you or a colleague later review your keys, so nobody expires this one by accident.

   Permissions to grant

   Resource	액세스	Used for
   고객	읽다	customers table. Test connection also reads it first.
   Charges and Refunds	읽다	charges and refunds tables. One row covers both, and there is no separate Refunds row.
   Payment Intents	읽다	payment_intents table
   Invoices	읽다	invoices and invoice_items tables. Invoice items have no row of their own.
   Subscriptions	읽다	subscriptions and subscription_items tables
   균형	읽다	balance_transactions table (Stripe’s list of balance transactions, formerly called Balance history)
   Balance transaction sources	읽다	balance_transactions table: lets each transaction link to the charge, refund or payout behind it. Stripe says this also grants Read on Balance and Payouts.
   Payouts	읽다	payouts table
   Disputes	읽다	disputes table
   제품	읽다	products table
   물가	읽다	prices table
   Coupons	읽다	coupons table
   Events	읽다	events table, and the change feed that keeps customers, subscriptions, invoices, invoice items, charges, payment intents, refunds, disputes, payouts, products, prices and coupons up to date between syncs

   Paste into Query Streams

   스트라이프 비밀 키

   The restricted key you copied in step 10 (starts with rk_live_ or rk_test_). A secret key (sk_live_ or sk_test_) also works, but it can do far more than read.

   Common problems

   Test connection fails with Invalid API key.

   Why: Part of the key was missed when copying, a space was added, the publishable key (pk_…) was pasted, or someone expired or rotated the key in Stripe.

   Fix: The key must start with rk_ or sk_. Paste it again with nothing before or after it. If you no longer have it (Stripe shows live keys only once), create a new restricted key (steps 3 to 11) and paste that one.

   Test connection says Connected, but some tables stay empty and their sync shows a Stripe permission error (403). Newer Agents also show a warning under Test connection that names the tables the key cannot read.

   Why: The key is missing Read on that table’s row. Stripe’s error message names the missing permission, for example rak_event_read means Events.

   Fix: On the Stripe API keys page, click the ⋯ menu next to the key, choose Edit key, set the missing row to Read, and save. The key itself does not change, so there is nothing to paste again. Click Test connection again in Query Streams.

   Connected, but you only see test data, or the tables are empty even though you take real payments.

   Why: The key comes from a sandbox (rk_test_) when you wanted live data, or the other way round.

   Fix: Check how the key starts. For live data, use the account picker to leave the sandbox, create the key again (steps 2 to 11), then open the connector in Data Agents, click Edit, and paste it into Stripe Secret Key. Keep test and live as separate connectors.

   A connector that used to work stops syncing with Invalid API key.

   Why: Someone rotated or expired the key in Stripe. A rotated key keeps working only until the expiration chosen at rotation, which is at most 7 days.

   Fix: Create a new restricted key, or copy the replacement from the rotation. In Query Streams, open the connector, click Edit, paste the key into Stripe Secret Key, click Test connection, then click Save.

   You can’t see Create restricted key, or the API keys page won’t open.

   Why: Your Stripe role can’t manage API keys. Analyst, View Only and support roles can’t.

   Fix: Ask your Stripe account owner, an Administrator or a Developer to create the key for you, or to change your role.

   Stripe emails you that it blocked a request, and syncs fail even though the key is correct.

   Why: An access policy on the key (IP addresses or Advanced) doesn’t allow the Agent computer’s internet address, or it blocks a VPN or proxy that the computer uses.

   Fix: On the API keys page, click ⋯ next to the key, choose Manage access policy, and either choose a policy that allows the Agent computer’s public IP address or choose None. Then click Save.

   The key was exposed (sent in an email or chat, or saved in a shared file), or someone who had it left your team.

   Why: Anyone holding the key can read everything its permissions allow.

   Fix: On the API keys page, click ⋯ next to the key and choose Rotate key. In Expiration, pick Now to cut off the old key at once, then click Rotate API key. Copy the new key, and paste it into the connector (Edit → Stripe Secret Key → Test connection → Save).

   You want Query Streams to stop reading this Stripe account.

   Why: Deleting the connector does not disable the key. It stays valid in Stripe until you expire it.

   Fix: On the API keys page, click ⋯ next to the key, choose Expire key, and click Expire key again to confirm. Then delete the connector in Data Agents.

   Limits to know

   • Events go back 30 days. Stripe’s event list reaches only 30 days back, so the events table never holds more than the last 30 days. Query Streams also reads events to pick up changes between syncs, so if a connector is switched off for more than about four weeks, its next sync reads its tables again in full.
   • Request speed: Stripe allows 100 API requests per second in live mode and 25 in a sandbox, and most individual endpoints allow 25. Each request returns at most 100 records, so a first sync of 1,000,000 charges is about 10,000 requests, roughly 7 minutes at 25 per second. Sandbox syncs are slower.
   • Monthly read allowance: Stripe expects an account’s read requests to average no more than 500 per transaction over a rolling 30 days, with a minimum of 10,000 a month. Every enabled table makes at least one request each time it syncs, so on a new or low-volume account, set longer sync intervals on tables you don’t need minute by minute.
   • One mode per key: a key reads only the mode it was created in (live, or one particular sandbox).
   • Connect: the key reads your own account’s objects only. Payments on connected accounts are not synced.
   • Showing the key again: Stripe shows a live key you created only once, while sandbox keys can be revealed at any time. When you rotate a key, the old one keeps working for at most 7 days.

   Steps verified 8 October 2026. Sources: docs.stripe.com/keys, docs.stripe.com/keys/restricted-api-keys, docs.stripe.com/keys-best-practices, docs.stripe.com/stripe-apps/reference/permissions, docs.stripe.com/sandboxes, docs.stripe.com/testing-use-cases, docs.stripe.com/rate-limits, docs.stripe.com/api/events/list, docs.stripe.com/api/balance_transactions/list, docs.stripe.com/api/errors, docs.stripe.com/get-started/account/teams/roles, docs.stripe.com/workbench, support.stripe.com/questions/plugin-user-migration-guide, stripe.com/sessions/2026/building-security-first-stripe, posthog.com/docs/cdp/sources/stripe, help.chaserhq.com/use-chaser-with-stripe, homerunner.io/docs/creating-stripe-restrict-key-for-homer…, chargebee.com/docs/reveal/transactions/get-started/stripe…, nango.dev/docs/api-integrations/stripe-api-key/connect, fivetran.com/docs/connectors/applications/stripe/troubles….

   연결 이름

   나중에 알아볼 수 있는 이름들입니다. 예를 들어, 판매 데이터베이스 같은 것이죠.

   스트라이프 비밀 키

   Stripe 대시보드의 개발자 > API 키에서 Stripe 비밀 키를 확인하세요. 비밀 키는 sk_live_ 또는 sk_test_로 시작합니다.

   클릭 테스트 연결읽을 때 연결됨클릭 저장연결은 몇 초 내에 에이전트에 도달합니다.

   오픈 데이터 에이전트

   테스트에 실패했나요? Usually a missing permission, or a credential from the wrong Stripe account. The walkthrough above lists the common problems and their fixes.

4. Google Sheets에 쿼리 스트림 추가

   아무 구글 시트나 열고, 다음으로 이동하세요. 확장 프로그램 → 추가 기능 → 추가 기능 가져오기검색하세요 쿼리 스트림그리고 클릭하세요 설치하다또는 바로 설치하세요. Google Workspace Marketplace에서 Query Streams를 검색하세요.구글에서 추가 기능을 허용할지 묻는 메시지가 나타날 것입니다. 이는 정상적인 절차입니다.

   이후에는 여는 모든 Google Sheets에서 오른쪽 사이드 패널에 쿼리 스트림 아이콘이 표시되며, 해당 아이콘은 다음 항목 아래에도 나열됩니다. 확장 기능별도의 로그인 절차가 없습니다. 이미 사용 중인 Google 계정을 자동으로 인식하므로, Query Streams 계정에 등록된 이메일 주소와 동일한 이메일 주소를 사용해야 합니다.

5. 첫 번째 테이블을 가져오세요

   시트 오른쪽 측면 패널에서 "쿼리 스트림" 아이콘을 클릭하거나 (아래에서 찾을 수 있습니다) 확장 기능). 선택하다 쿼리 스트리머 그리고 방금 연결한 연결을 선택하세요.

   실행하려는 쿼리를 입력하세요. 이 쿼리는 테이블에서 몇 개의 열을 가져옵니다. 스트라이프.인보이스 테이블:

   예시 · SQL

   SELECT number, status, amount_due / 100.0 AS amount_due, currency FROM stripe.invoices ORDER BY created DESC LIMIT 100;

   아래에 목적지 정보 행이 표시될 탭을 선택한 다음 클릭하세요. 쿼리 실행행들이 해당 탭에 1~2초 안에 나타납니다. 데이터가 변경될 때마다 '쿼리 실행'을 다시 클릭하면 탭이 즉시 업데이트됩니다.

   SQL을 모르시나요? 쿼리 스트림 포털에서 쿼리를 작성하세요. 쿼리 빌더 테이블과 열을 표시해 주므로 마우스 클릭만으로 원하는 정보를 얻을 수 있습니다. 비즈니스 플랜에서는 Nova에 "미국 고객을 보여주세요"와 같이 간단한 영어로 요청하면 Nova가 SQL 쿼리를 자동으로 작성해 줍니다. 쿼리를 저장하면 포털에서 한 번의 클릭으로 바로 사용할 수 있으며, Personal Core 플랜 이상부터는 추가 기능의 저장된 쿼리 목록에서도 확인할 수 있습니다.

좋은 다음 행보입니다

• 쿼리를 저장하세요 포털에 저장되므로 Google Sheets 또는 Excel에서 한 번의 클릭으로 다시 실행할 수 있습니다.
• 필터를 추가하세요 날짜 범위를 지정할 수 있으므로 편집 없이 동일한 쿼리로 "이번 달"이라는 답변을 얻을 수 있습니다.
• 결과를 공유하세요 동료와 함께 있을 때, 그들은 당신의 자격 증명이 아니라 행 목록만 봅니다.

사람들이 묻는 질문

관련 가이드

• Stripe에서 Microsoft Excel로
• HubSpot에서 Google Sheets로
• Shopify에서 Google Sheets로
• Google Analytics 4에서 Google Sheets로
• Google 스프레드시트용 파워 쿼리
• 모든 가이드