Stripe 청구를 3번 클릭으로 인보이스로 가져오기
Source: Dev.to
Stripe 결제 내역을 3번 클릭만으로 청구서로 가져오기
Stripe에서 발생한 결제(Charge)를 회계 시스템에 청구서(Invoice) 형태로 바로 가져올 수 있다면 업무 효율이 크게 향상됩니다. 이번 글에서는 Stripe Dashboard와 Xero(또는 다른 회계 프로그램)를 연동해, 몇 번의 클릭만으로 Stripe 결제 데이터를 청구서로 변환하는 방법을 단계별로 설명합니다.
📋 사전 준비
| 항목 | 설명 |
|---|---|
| Stripe 계정 | 결제 데이터에 접근할 수 있는 관리자 권한 |
| Xero(또는 회계 프로그램) 계정 | 청구서를 생성할 수 있는 권한 |
| Zapier(또는 Integromat) 계정 | 자동화 워크플로우를 연결할 중간 서비스 |
| API 키 | Stripe와 회계 프로그램을 연결하기 위한 인증 토큰 |
Tip: 테스트 환경에서는 Stripe의 Test API Key와 Xero의 Sandbox 계정을 사용하면 실제 결제에 영향을 주지 않고 검증할 수 있습니다.
🛠️ 단계 1 – Zapier에 새 Zap 만들기
- Zapier에 로그인하고 “Make a Zap” 버튼을 클릭합니다.
- Trigger App으로 Stripe를 선택합니다.
- 트리거 이벤트는 “New Charge”(새 결제 발생)로 설정합니다.
- Stripe 계정을 연결하고, “Live” 혹은 “Test” 모드를 선택합니다.
- Test Trigger를 실행해 최근 결제 데이터를 불러옵니다.
주의: 결제 데이터에 포함된 고객 이메일, 금액, 통화, 결제 일시 등을 확인해 두세요. 이후 청구서에 자동 매핑됩니다.
🧾 단계 2 – 회계 프로그램에 청구서 생성 액션 추가
- Action App으로 Xero(또는 사용 중인 회계 프로그램)를 선택합니다.
- 액션 이벤트는 “Create Invoice”(청구서 생성)으로 설정합니다.
- Xero 계정을 연결하고, Organization을 선택합니다.
- 아래와 같이 필드를 매핑합니다.
| Xero 필드 | Stripe 데이터 매핑 |
|---|---|
| Contact (고객) | Customer Email |
| Invoice Date (청구일) | Created At |
| Due Date (만료일) | Created At + 30 days |
| Line Items (항목) | Amount, Currency, Description |
| Reference (참조) | Charge ID |
Tip:
Line Items에Description을 넣을 때, Stripe 결제 시 입력한 메모나 상품명을 활용하면 청구서가 더 명확해집니다.
✅ 단계 3 – Zap 활성화 및 테스트
- “Test & Review” 버튼을 눌러 실제로 Xero에 청구서가 생성되는지 확인합니다.
- 모든 필드가 올바르게 매핑되었다면 “Turn on Zap” 로 자동화를 활성화합니다.
- 이제 Stripe에서 새로운 결제가 발생하면, Zapier가 자동으로 Xero에 청구서를 생성합니다.
📈 활용 팁
| 상황 | 적용 방법 |
|---|---|
| 다중 통화 | Xero의 Multi‑Currency 기능을 활성화하고, Stripe에서 전달받은 currency 값을 그대로 매핑합니다. |
| 세금 자동 적용 | Stripe 결제에 적용된 Tax Rate를 Xero의 Tax Rate와 매핑해 자동으로 부가세를 계산합니다. |
| 고객 별 라벨링 | Stripe 메타데이터에 customer_type(예: “B2B”, “B2C”)을 추가하고, Xero 청구서에 Reference 혹은 Custom Field 로 전달합니다. |
🛡️ 보안 및 유지보수
- API 키 관리: Zapier에 연결된 Stripe와 Xero API 키는 최소 권한 원칙에 따라 발급하고, 주기적으로 교체합니다.
- 로그 모니터링: Zapier 대시보드에서 Task History를 확인해 오류 발생 시 즉시 대응합니다.
- 데이터 정합성: 월말에 Stripe 결제 내역과 Xero 청구서 리스트를 대조해 누락된 건이 없는지 검증합니다.
🎉 마무리
위 과정을 통해 Stripe 결제 → Xero 청구서 흐름을 3번 클릭만으로 자동화할 수 있습니다. 별도의 수작업 없이 실시간으로 청구서를 생성함으로써 회계 처리 시간을 크게 단축하고, 오류 발생 가능성을 최소화하세요.
추가 자료
궁금한 점이 있으면 댓글로 알려 주세요! 🚀
Stripe와 함께하는 청구. 고객이 결제합니다.
하지만 그 거래들은 누군가가 청구서로 변환하기 전까지는 청구서가 아닙니다. 그 **“누구”**는 이제 당신이 될 필요가 없습니다.
오늘 Stripe Revenue Sync을 출시합니다
Stripe에서 받은 결제를 Frihet에 기록된 청구서로 자동으로 가져오는 통합 기능입니다. 중복 제거, VeriFactu 해시 체인 및 6시간마다 자동 동기화가 포함됩니다.
문제: 한쪽은 청구하고, 다른쪽은 송장 발행
- Stripe가 청구합니다. 고객이 카드로 결제하고, 구독이 갱신되며, 정기 결제가 들어옵니다.
- 당신의 회계는 알지 못합니다. 이러한 청구는 Stripe에는 존재하지만 당신의 송장 소프트웨어에는 없습니다.
- 당신이 중간 다리 역할을 합니다. 매달 Stripe 데이터를 복사해서 수동으로 송장을 만듭니다. 혹은 더 나빠서, 하지 않으면 다음 분기에 회계 담당자가 미쳐버립니다.
Stripe는 영수증을 발행하지만 스페인에서 세법상 유효한 송장은 아닙니다. NIF가 포함되지 않고, 세무청이 요구하는 번호 체계가 적용되지 않으며, VeriFactu가 요구하는 해시 체인도 생성되지 않습니다. 스페인 세법을 준수하려면 실제 송장을 송장 소프트웨어에서 생성해야 합니다.
지금까지는 이중 작업을 의미했습니다. 이제는 아닙니다.
Stripe Revenue Sync란
Revenue Sync는 읽기 전용 제한 API Key를 사용하여 Stripe 계정을 Frihet와 연결합니다. OAuth 없이, 리디렉션 없이, 금액에 대한 쓰기 권한 없이 동작합니다.
작동 방식
- Stripe에서 결제된 청구서를 조회 – 상태가
paid인 것만. - 각 결제마다 Frihet에 청구서를 생성 – 고객, 상세 라인 및 금액 포함.
- 청구서를 결제 완료로 표시 – VeriFactu 파이프라인이 자동으로 활성화됩니다.
- Stripe ID로 중복 제거 – 청구서가 이미 존재하면 무시합니다.
결과: Stripe 결제가 Frihet에 등록된 청구서로 나타나며, 순차 번호, SHA‑256 해시가 포함되고 Modelo 303에 사용할 준비가 됩니다.
실제 작동 방식
세 단계. 코드 없이, 복잡한 설정 없이.
단계 1: Stripe에서 제한된 API 키 생성
Stripe Dashboard > Developers > API Keys 로 이동합니다. 두 가지 권한을 가진 제한된 키를 생성합니다:
- Invoices → Read
- Customers → Read
그 외는 필요 없습니다. 쓰기 권한이나 결제, 이체, 잔액에 대한 접근 권한이 필요하지 않습니다. 키는 rk_live_ 로 시작하며 읽기 전용입니다.
단계 2: Frihet에 연결
설정 > 통합 > Stripe Revenue Sync 로 이동합니다. API 키를 붙여넣고 가져올 시작 날짜를 선택합니다. 최근 90일을 가져오거나 특정 날짜를 선택할 수 있습니다.
단계 3: 가져오기
«Importar ahora» 를 클릭합니다. Frihet가 Stripe에 요청하여 결제된 청구서를 가져와 계정에 생성합니다. 각 청구서는 Firestore 트리거를 거쳐 번호가 격차 없이 매겨지고 VeriFactu 해시 체인이 적용됩니다.
:::tip 자동 동기화(auto‑sync)를 활성화하면 Frihet가 6시간마다 자동으로 Stripe를 조회합니다. 새로운 결제가 회계에 자동으로 반영되어 별도의 작업이 필요 없습니다. :::
VeriFactu 첫 번째 가져오기부터 호환
Stripe에서 가져온 청구서는 “두 번째”가 아닙니다. Frihet에서 수동으로 생성하는 청구서와 동일한 파이프라인을 정확히 통과합니다:
- 갭 없는 번호 매기기 – 서버의 원자적 카운터. 빈칸 없이, 건너뛰기 없이.
- SHA‑256 해시 – AEAT가 요구하는 8개 필드 해시 체인. 각 청구서는 이전 청구서의 해시를 참조합니다.
- 불변성 – 한 번 기록되면 핵심 필드가 잠깁니다. 수정은 정정 청구서를 생성합니다.
- 등록 장부 – 가져온 청구서는 Hacienda가 요구하는 19개 열이 포함된 CSV 내보내기에 표시됩니다.
:::info VeriFactu는 2027년 1월에 법인에게, 2027년 7월에 자영업자에게 의무화됩니다. 오늘 Revenue Sync로 가져오는 청구서는 이미 규정을 충족합니다. :::
이는 Stripe 수익이 모델 303, 모델 130 및 모든 검사를 위해 준비되었음을 의미합니다. 추가 단계 없이.
Revenue Sync는 누구를 위한 것인가
Stripe Billing을 사용하는 SaaS 창업자
Stripe에서 직접 구독을 청구합니다. 매달 수십에서 수백 명의 고객이 갱신됩니다. Revenue Sync를 사용하면 각 갱신이 자동으로 Frihet에 청구서로 표시됩니다. 당신의 MRR, 분기별 부가가치세(VAT), 장부 기록이 항상 최신 상태입니다.
Stripe로 프로젝트 비용을 청구하는 프리랜서
고객이 Stripe를 통해 결제하고, 모든 청구서를 한 곳에 모아 분기별 보고에 사용하고 싶습니다. 청구서를 일일이 만들 필요 없이, Stripe와 스프레드시트 사이의 데이터를 교차할 필요도 없습니다.
Stripe 직접 결제하는 eCommerce
디지털 또는 물리적 제품을 판매하고 Stripe로 결제받습니다(Shopify나 WooCommerce를 거치지 않음). 각 판매가 청구서로 기록됩니다. 특히 EU 고객에게 판매하고 부가가치세 관리를 해야 할 때 유용합니다.
혼합 청구 방식을 사용하는 에이전시
일부 고객은 Stripe로, 일부는 송금으로 결제합니다. Revenue Sync는 Stripe 결제를 가져오고, 나머지는 수동으로 또는 Frihet 직접 청구 기능으로 처리합니다. 모든 것이 동일한 장부에 함께 기록됩니다.
Revenue Sync는 아닌 것
- Stripe의 OAuth 통합이 아닙니다. 이는 이미 Frihet에 존재하며, 앱 자체에서 결제 링크로 청구할 수 있게 합니다. Revenue Sync는 단방향이며, 가져오기만 합니다.
- 청구를 발생시키지 않습니다. 결제를 처리하거나 Stripe에서 요금을 생성하지 않습니다. 이미 결제된 청구서만 읽어옵니다.
- Stripe Billing을 대체하지 않습니다. 보완하는 역할을 합니다. Stripe가 청구하고, Frihet가 기록합니다.
- 고객별 필터링을 하지 않습니다. 선택한 날짜부터 결제된 모든 청구서를 가져옵니다. 중복 제거가 중복을 방지합니다.
보안
제한된 API 키는 두 리소스인 invoices와 customers에 대해 읽기 전용 권한만 가집니다. 돈을 이체하거나, 청구를 생성하거나, Stripe 계정을 수정할 수 없습니다.
키는 AES‑256‑GCM으로 암호화되어 Frihet 서버에 저장됩니다. 프런트엔드에 절대 노출되지 않습니다. Stripe가 키를 감지하면…
⚠️ 통합 만료
권한이 만료되었거나 취소된 경우, Frihet는 통합을 “재연결 필요” 로 표시하고 알립니다.
설정 > 통합에서 언제든지 연결을 해제할 수 있습니다.
이미 가져온 청구서는 Frihet에 그대로 남습니다.
지금 시작하세요!
만약 Stripe로 결제받고 있다면, 청구서는 이미 준비되어 있습니다; 회계에 전달되기만 하면 됩니다.
Stripe Revenue Sync는 3번 클릭만으로, OAuth 없이, 위험한 권한 없이, 첫날부터 VeriFactu와 함께 수행합니다.
Stripe 계정을 연결하세요 그리고 결제가 자동으로 기록된 청구서로 전환되도록 하세요.
:::newsletter-cta :::
원본은 frihet.io에서 게시되었습니다.