# 거래 내역을 CSV로 내보내기 또는 다운로드하기 이 문서는 거래 기록을 내보내는 방법, 내보내기 파일이 전달되는 방식, 그리고 거래당 여러 라인 항목을 포함한 CSV 형식을 해석하는 방법을 설명합니다. ## 개요 거래 CSV 내보내기(Transactions CSV Export)를 통해 보고, 대사, 회계, 컴플라이언스 목적으로 자세한 결제 기록을 다운로드할 수 있습니다. 내보내기에 포함되는 항목: * 모든 거래 또는 * 적용된 필터나 검색을 기반으로 한 거래만 내보내기는 이메일 다운로드 링크를 통해 전달되며, 모든 스프레드시트 도구에서 열 수 있습니다. 목차 * [개요](#개요) * [거래 내보내기 방법](#거래-내보내기-방법) * [이메일 전달 동작](#이메일-전달-동작) * [CSV 구조 및 형식 규칙](#csv-구조-및-형식-규칙) * [데이터 일관성 보장 (내보내기 업그레이드)](#데이터-일관성-보장-내보내기-업그레이드) * [컬럼 참조 가이드 (예시 포함)](#컬럼-참조-가이드-예시-포함) * [특별 형식 주의사항](#특별-형식-주의사항) * [FAQ](#faq) ## 거래 내보내기 방법 * Payments(결제) → Transactions(거래)로 이동 * 필요하면 필터/검색 적용 (예: 날짜 범위, 결제 상태, 소스 유형) * Download Icon(다운로드 아이콘) 클릭 * 로그인한 사용자에게 보안 다운로드 링크가 이메일로 전송됨 보안 참고사항: 이메일 링크는 7일간 유효하며 요청한 사용자에게만 고유합니다. ## 이메일 전달 동작 * 내보내기 링크가 몇 분 내에 도착 * 파일은 앱 내에서 직접 다운로드되지 않고 이메일 링크를 통해 다운로드 * 링크가 만료되면 → 새로운 내보내기를 생성하기만 하면 됨 ## CSV 구조 및 형식 규칙 각 행이 항상 하나의 거래와 같지는 않습니다. 단일 거래에는 다음이 여러 개 포함될 수 있습니다: * 상품 → 여러 라인 행을 생성 * 세금 → 상품당 고유한 세금 이름당 하나의 행을 생성 * 기타 요금 (처리 수수료, 연체료, 팁) 이렇게 하면 각 금융 구성 요소를 개별적으로 식별할 수 있습니다. 명확성을 위해 동일한 거래에 여러 행이 있는 경우, 모든 컬럼이 각 행에 채워지지는 않으며, 대부분 고유한 상품이나 세금 관련 데이터가 각 행에 채워지고 전체 데이터는 거래당 1개 행에서만 사용할 수 있습니다. ## 데이터 일관성 보장 (내보내기 업그레이드) 이러한 내보내기는 안정적인 형식과 예측 가능한 값으로 대사, 회계, BI 워크플로우를 위해 설계되었습니다. **0 vs 빈 값** * 0은 해당 필드가 적용되고 값이 실제로 0일 때만 나타남 * 빈 값은 해당 필드가 해당 행/레코드에 적용되지 않을 때만 나타남 **보고를 위한 안정적인 구조** * 컬럼 순서는 피벗, 가져오기, BI 파이프라인을 지원하기 위해 일관됨 * 다중 행 형식은 상품 수준 및 세금 수준 할당을 위해 의도적임 ("행 1개 = 거래 1개"라고 가정하지 마세요) ## 컬럼 참조 가이드 (예시 포함) | 컬럼명 | 설명 | 예시 | | ------------------------------------- | ------------------------------------------------------------------------------ | ----------------------------------- | | Internal transaction id | HighLevel 내부 고유 거래 식별자 | 69369a9968f735180bfeb6ed | | Location id | 하위 계정 식별자 | NyGCsdhgRZ8Ffa8SsagfhGd | | Customer id | GHL 고객 식별자 | jbtyjkzMjvd8cLi9HUC | | Customer name | 거래의 표시 이름 | Alex Ray | | Customer email | 영수증 전달에 사용된 이메일 | | | Customer phone | 결제 시 사용된 전화번호 | +1 555-012-2345 | | Payment method | 결제에 사용된 방법 | Credit Card, Cash, Instant Transfer | | Currency | 거래 통화 | USD | | Sub total | 할인 및 별도 세금 전 상품 총액 | 100.00 | | Discount | 소계에 적용된 총 할인 | -15.00 | | Total tax amount (excluded in prices) | 할인을 뺀 소계에 추가된 세금 | 8.40 | | Total tax amount (included in prices) | 상품 가격에 포함된 세금 즉, 이미 소계의 일부 | 0.00 | | Tip amount | 고객이 자발적으로 추가한 팁; 결제 금액에 포함되지 않음 | 5.00 | | Late fees | 상품 가격을 넘어 추가된 연체료 | 10.00 | | Total amount due | 주문/인보이스의 원래 총액 (소계, 할인, 세금, 연체료 포함); 부분 결제를 고려하지 않고 항상 초기 주문 또는 인보이스 결제 금액을 표시 | 103.40 | | Total amount paid | 이 거래에서 실제로 결제된 금액 (결제 금액 + 팁 + 처리 수수료 포함) | 110.40 | | Coupon code | 적용된 쿠폰 (있는 경우) | WELCOME15 | | Status | 거래 상태 | Success, Refunded | | Live mode | 라이브 모드 또는 테스트 모드에서 발생했는지 여부 (No) | Yes | | Source type | 구매가 발생한 결제 창 | Invoice, Funnel Page, Form | | Source id | 소스 엔티티(결제창)의 내부 ID | inv\_8281 | | Source name | 비즈니스에서 정의한 소스의 표시 이름 | Q4 Billing Invoice | | Internal order id | GHL 내 주문 참조 (해당되는 경우) | jfnkwbgfwbegiu234 | | Payment provider | 거래 실행에 사용된 게이트웨이 | Stripe, NMI, Authorize.net | | Subscription id | 해당되는 경우 GHL 내 구독 참조 | sub\_7A91FC | | Charge id | 제공업체 결제 식별자 | ch\_1NHXYZ | | Connected account | 연결된 결제 제공업체 판매자/클라이언트 계정 ID | acct\_1sagewg732Hko | | Transaction date | 결제일 | Dec 8, 2025 | | Transaction time | 결제 시간 | 03:00 PM | | Timezone | 기록의 시간대 | America/New\_York | | Is refunded | 환불 상태 참조; 환불되지 않은 경우 NA | Yes/No | | Amount refunded | 총 환불 금액 (여러 환불의 경우 모든 환불 합계) | 25.00 | | Refund date | 환불이 발생한 날짜 (여러 환불의 경우 마지막 환불 날짜) | Dec 9, 2025 | | Line item name | 상품명 | Annual Pro Plan | | Line item quantity | '상품명' 컬럼에 언급된 상품의 구매 수량 | 1 | | Line item price | '상품명' 컬럼에 언급된 상품의 라인 항목당 가격 | 100.00 | | Line item coupon discount | '상품명' 컬럼에 언급된 상품의 쿠폰 부분 | 15.00 | | Line item subtotal | '상품명' 컬럼에 언급된 상품에 특정한 소계 | 85.00 | | Line item product id | '상품명' 컬럼의 GHL 상품 식별자 | prod\_5449 | | Tax name | 라인 항목 데이터와 관계없는 고유한 세금 라벨 즉, 여러 상품이나 라인 항목이 같은 세금 이름을 가질 수 있지만 거래당 한 번만 표시 | Sales Tax | | Tax amount | 라인 항목 데이터와 관계없는 이 세금 라인의 세금 값 즉, 이 세금 이름을 가진 모든 상품의 세금이 합산되어 여기에 표시 | 8.40 | | Processing charge name | 기타 수수료 이름 - 거래당 최대 1개 가능; 수수료가 없으면 빈 값 | Platform Fee | | Processing charge amount | 기타 수수료 금액; 수수료가 없으면 빈 값 | 2.00 | | Gift card order number | 기프트 카드 사용 시; 거래 결제에 기프트 카드를 사용하지 않은 경우 빈 값 | GC-ORD-19202 | | Gift card amount used | 기프트 카드를 사용하여 거래에서 사용된 금액; 거래 결제에 기프트 카드를 사용하지 않은 경우 빈 값 | 20.00 | ## 특별 형식 주의사항 * 여러 상품 → 동일한 거래 ID 아래에 여러 행을 생성 * 여러 세금 → 각 세금은 별도 행에 나타나며 상품 라인 항목에 속함 즉, 각 세금은 상품에 대해 고유한 행을 가짐. 따라서 2개 상품이 같은 세금 요율(2개)을 가지는 경우, 거래의 총 라인 항목은 4개가 됩니다. 즉, 세금 1과 세금 2가 있는 라인 항목 1이 2행을 만들고, 세금 1과 세금 2가 있는 라인 항목 2가 2행을 더 만듭니다. * 결합 결제 (예: 카드 + 기프트 카드) → 값 컬럼에 명확히 표시 총액으로 필터링할 때는 스프레드시트에서 항상 신중하게 집계하세요. * 세금율 정밀도 세금율(백분율) 값은 소수점 **4자리**로 내보내집니다(예: **7.1250%**). 이는 소수점 세금율과 일관된 보고를 지원하기 위함입니다. 세금 금액 값은 통화 표준에 따라 **소수점 2자리로 반올림**된 상태로 유지됩니다. ## FAQ ### 1. CSV에서 단일 거래가 여러 행으로 표시되는 이유는 무엇인가요? 상품은 라인 항목별로 추적되고 세금 세부사항은 고유한 세금 이름별로 추적되기 때문입니다. 이는 회계 등급 보고의 표준입니다. ### 2. 결제 예정 금액(Total Amount Due)이 실제 결제 금액(Total Amount Paid)과 다른 이유는 무엇인가요? * 처리 수수료 * 팁 * 부분 결제... 등이 원래 결제 예정 금액이 아닌 최종 결제에 영향을 줍니다. ### 3. 내 내보내기에서 일부 거래가 보이지 않는 이유는 무엇인가요? 다음을 확인하세요: * 필터가 해제되었는지 * 올바른 날짜 범위가 적용되었는지 ### 4. 내보내기에 실패한 거래가 포함되나요? 예 — 성공 또는 환불된 거래만 포함하도록 필터링하지 않는 한 포함됩니다. ### 5. 내보내기에 부분 환불이 포함되나요? 예 — 환불 금액(Amount Refunded)은 전체 누적 환불 금액을 반영합니다. ### 6. 이전에 내보낸 파일을 다시 생성할 수 있나요? 예 — 내보내기는 언제든지 반복할 수 있습니다. ### 7. 누가 거래를 내보낼 수 있나요? 거래를 볼 수 있는 권한과 기록을 내보낼 수 있는 권한이 있는 사용자만 가능합니다. *** *원문 최종 수정: Wed, 4 Feb, 2026 at 7:51 AM* *Hyperclass 사용 가이드 — hyperclass.ai* --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://hyperclass.gitbook.io/hyperclass-docs/payments/using-apple-pay-and-google-pay-in-order-forms/export-or-download-transactions-as-csv.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.