정산 CSV·전표 템플릿
Paddle transaction export, payout reconciliation report, 내부 주문 DB, 은행 입금내역을 연결하는 월마감 템플릿
핵심 요약
- 월마감은 보고서를 내려받는 일이 아니라 같은 거래를 Paddle report·내부 주문 DB·payout reconciliation·bank statement·전표에서 다시 맞춰보는 작업이다.
- transaction ledger, payout 대사, exception 등 6종 CSV 파일 세트를 표준 컬럼으로 맞춰 거래·세금·수수료·환불·환율을 추적한다.
remittance_reference별 balance movement 합계와 remittance advice·은행 입금액을 대조하고 Paddle fee, rebate, SWIFT/중개은행 fee를 분리한다.- 미매칭·payout 누락·은행 차이·환불 월차이·unknown 결제수단·세무 검토 건은 exception queue 상태값으로 담당자에게 배정한다.
- 원본 CSV는 수정하지 않고 정규화 테이블을 따로 만들며, 한국 고객·KRW·국내 B2B 예외 거래는 별도 태그를 둔다.
월마감은 보고서를 내려받는 일이 아니라 같은 거래를 여러 원장에서 다시 맞춰보는 일입니다. 이 장에서는 Paddle report, 내부 주문 DB, payout reconciliation report, bank statement, 회계 전표를 한 흐름으로 묶는 템플릿을 정리합니다.
파일 세트
| 파일 | 소스 | 목적 |
|---|---|---|
paddle_transactions_YYYY_MM.csv | Paddle export | 거래, 세금, 수수료, 환불 원장 |
paddle_payout_reconciliation_YYYY_MM.csv | Paddle payout reconciliation report | 지급 묶음과 지급 통화 확인 |
internal_orders_YYYY_MM.csv | 내부 DB | 고객, 워크스페이스, 권한 매칭 |
bank_statement_YYYY_MM.csv | 은행 | 실제 입금, wire fee, 환율 확인 |
fx_rates_YYYY_MM.csv | 회계 기준 환율 | KRW 전표 환산 |
exceptions_YYYY_MM.csv | 재무/운영 | 미매칭, 환불 지연, chargeback 추적 |
표준 거래 원장 컬럼
month,paddle_transaction_id,paddle_subscription_id,internal_order_id,workspace_id,customer_country,payment_method_type,payment_currency,gross_amount,tax_amount,paddle_fee,refund_amount,net_amount,remittance_reference,book_fx_rate,krw_amount,exception_note
2026-08,txn_01,sub_01,ord_01,ws_01,KR,kakao_pay,KRW,29000,2636,1450,0,24914,REM-2026-08-001,1,24914,| 컬럼 | 기준 |
|---|---|
gross_amount | 고객이 결제한 총액. 통화별 최소 단위 처리 여부 확인 |
tax_amount | Paddle이 계산/처리한 거래세. 한국 법인의 신고 판단과 혼동 금지 |
paddle_fee | Paddle transaction fee. payment method/country별 분석 가능하게 보관 |
refund_amount | 원 transaction과 연결. 환불 발생월과 원 결제월을 둘 다 보관 |
net_amount | Paddle transaction/report 기준 정산 대상 금액 |
book_fx_rate | 회사 회계정책상 적용 환율 |
krw_amount | 전표 입력용 원화 환산액 |
payout 대사 컬럼
remittance_reference,balance_movement_date,balance_movement_type,balance_currency,balance_movement_in_balance_currency,remittance_amount,bank_received_amount,bank_fee,matched,exception_note
REM-2026-08-001,2026-08-12,transaction,USD,7835.00,7835.00,7820.00,15.00,true,| 점검 | 기준 |
|---|---|
| remittance 매칭 | remittance_reference별 balance_movement_in_balance_currency 합계가 remittance advice와 일치 |
| 은행 입금액 | bank statement의 실제 입금액과 payout reconciliation report를 대조 |
| wire fee | Paddle fee와 은행/중개은행 수수료를 분리 |
| FX | Paddle conversion, 은행 환전, 장부 환율을 별도 컬럼으로 분리 |
| 미매칭 | 다음 월 이월인지, 환불/chargeback인지, 누락 export인지 기록 |
회계 전표 예시
회계 계정은 회사 정책과 세무사 검토로 확정합니다. 아래는 구조 예시입니다.
| 상황 | 차변 | 대변 | 메모 |
|---|---|---|---|
| Paddle 정산 매출 인식 | 외상매출금/Paddle receivable | 매출 또는 기타수익 | 총액/순액 인식 정책 확정 필요 |
| Paddle fee 인식 | 지급수수료 | 외상매출금/Paddle receivable | transaction fee breakdown 첨부 |
| payout 입금 | 외화예금 | 외상매출금/Paddle receivable | payout reconciliation report와 bank statement 첨부 |
| 은행 수수료 | 지급수수료 | 외화예금 | Paddle fee와 분리 |
| 환차손익 | 외환차손익 | 외화예금/외상매출금 | 장부 환율과 입금 환율 차이 |
| 환불 | 매출 차감 또는 환불 비용 | 외상매출금/Paddle receivable | 원 transaction ID 연결 |
월마감 SQL 체크
-- Paddle transaction과 내부 주문 미매칭
select
p.paddle_transaction_id,
p.paddle_subscription_id,
p.net_amount,
p.payment_currency
from finance_paddle_transactions p
left join orders o on o.paddle_transaction_id = p.paddle_transaction_id
where p.month = :month
and o.id is null;
-- payout별 합계와 은행 입금 대조
select
remittance_reference,
sum(net_amount) as transaction_net_sum,
max(bank_received_amount) as bank_received_amount,
sum(net_amount) - max(bank_received_amount) as diff
from finance_reconciliation
where month = :month
group by remittance_reference
having abs(sum(net_amount) - max(bank_received_amount)) > :tolerance;exception queue
| 상태 | 의미 | 담당 |
|---|---|---|
missing_internal_order | Paddle 거래는 있으나 내부 주문이 없음 | Engineering |
missing_remittance | 거래는 있으나 remittance reference가 아직 없음 | Finance |
bank_diff | payout reconciliation report와 은행 입금액 차이 | Finance |
refund_cross_month | 환불월과 결제월이 다름 | Finance/Support |
unknown_payment_method | 새 결제수단 타입 유입 | Data/Engineering |
tax_review | 세무 판단이 필요한 거래 | Finance/Tax |
운영 원칙
- 원본 CSV는 수정하지 않고, 정규화 테이블을 따로 만듭니다.
transaction_id,subscription_id,remittance_reference를 회계 전표 메모에 남깁니다.- 한국 고객, 한국 통화, 국내 B2B 예외 거래는 별도 태그를 둡니다.
- 월마감 후 exception이 남으면 다음 달 첫 영업일에 재무/개발/CS가 함께 review합니다.