결제 금액에서 세금을 어떻게 처리하나요?
"taxTypeCd 파라미터에 뭘 넣어야 하나요?"
결제 연동을 하다 보면 세금 관련 파라미터가 나와요. 대부분의 경우 기본값으로 처리되지만, 면세 상품을 판매하거나 과세/비과세 상품을 함께 판매하는 경우라면 정확한 설정이 필요해요.
이번 아티클에서는 과세, 비과세, 복합과세의 개념과 PG 연동 시 올바른 설정 방법을 알아볼게요.
세금 유형 3가지
PG 결제에서 사용하는 세금 유형은 크게 3가지예요.
| 유형 | taxTypeCd | 설명 |
|---|---|---|
| 과세 | N | 부가가치세(VAT) 10%가 포함된 일반 상품 |
| 비과세 | Y | 부가가치세가 면제되는 상품 |
| 복합과세 | G | 과세 + 비과세 상품을 함께 결제 |
과세 (taxTypeCd = N)
가장 일반적인 케이스예요. 대부분의 상품과 서비스는 부가가치세(VAT) 10% 가 포함된 과세 상품이에요.
특징
- 결제 금액에 VAT 10%가 포함되어 있어요
- 별도의 세금 관련 파라미터 설정이 필요 없어요
- 기본값으로 처리되는 경우가 많아요
금액 계산 예시
10,000원짜리 과세 상품의 경우:
| 항목 | 금액 | 계산 |
|---|---|---|
| 결제 금액 | 10,000원 | - |
| 공급가액 | 9,091원 | 10,000 ÷ 1.1 |
| 부가세 | 909원 | 9,091 × 0.1 |
VAT 계산 공식
비과세 (taxTypeCd = Y)
부가가치세가 면제되는 상품이에요. 법으로 정해진 특정 품목 만 비과세로 처리할 수 있어요.
비과세 대상 예시
- 농수산물: 가공되지 않은 농산물, 수산물
- 의료/교육: 의료 서비스, 교육 서비스
- 도서/신문: 도서, 신문, 잡지
- 금융/보험: 금융 서비스, 보험료
특징
- 결제 금액 전체가 비과세 처리돼요
- VAT가 없으므로 결제 금액 = 공급가액이에요
- 현금영수증 발행 시에도 비과세로 처리돼요
금액 계산 예시
10,000원짜리 비과세 상품의 경우:
| 항목 | 금액 |
|---|---|
| 결제 금액 | 10,000원 |
| 공급가액 | 10,000원 |
| 부가세 | 0원 |
비과세 설정 주의
복합과세 (taxTypeCd = G)
한 번의 결제에 과세 상품과 비과세 상품이 함께 포함된 경우예요. 예를 들어 온라인 서점에서 도서(비과세)와 문구류(과세)를 함께 구매하는 경우가 해당돼요.
특징
taxTypeCd를G로 설정해야 해요taxAmt,vatAmt,taxFreeAmt파라미터가 필수 예요- 각 금액의 합이 총 결제 금액과 일치해야 해요
필수 파라미터
| 파라미터 | 설명 | 계산 |
|---|---|---|
taxAmt | 과세금액 (공급가액) | 과세 상품 금액 ÷ 1.1 |
vatAmt | 부가세 | 과세 상품 금액 - taxAmt |
taxFreeAmt | 비과세금액 | 비과세 상품 금액 전체 |
금액 계산 예시
도서 8,000원(비과세) + 문구류 11,000원(과세) = 총 19,000원 결제 시:
| 항목 | 금액 | 계산 |
|---|---|---|
| 총 결제 금액 | 19,000원 | - |
| taxFreeAmt (비과세) | 8,000원 | 도서 금액 |
| taxAmt (공급가액) | 10,000원 | 11,000 ÷ 1.1 |
| vatAmt (부가세) | 1,000원 | 11,000 - 10,000 |
검증: taxFreeAmt + taxAmt + vatAmt = 8,000 + 10,000 + 1,000 = 19,000원
금액 불일치 오류
봉사료 (svcAmt)
음식점, 호텔 등에서 봉사료(서비스 차지) 를 별도로 받는 경우가 있어요. 봉사료는 부가세 과세 대상이 아니기 때문에 별도로 구분해서 처리해야 해요.
특징
- 봉사료는 비과세 항목이에요
- 현금영수증 발행 시 봉사료는 별도 구분돼요
svcAmt파라미터로 전달해요
봉사료가 포함된 결제 예시
음식값 50,000원(과세) + 봉사료 5,000원 = 총 55,000원 결제 시:
| 항목 | 금액 | 계산 |
|---|---|---|
| 총 결제 금액 (trdAmt) | 55,000원 | - |
| 음식값 | 50,000원 | 과세 |
| 공급가액 | 45,455원 | 50,000 ÷ 1.1 |
| 부가세 | 4,545원 | 50,000 - 45,455 |
| 봉사료 (svcAmt) | 5,000원 | 비과세 |
봉사료와 복합과세
봉사료 + 복합과세 예시
음식값 30,000원(과세) + 생수 2,000원(비과세) + 봉사료 3,000원 = 총 35,000원:
| 항목 | 금액 | 파라미터 |
|---|---|---|
| 총 결제 금액 | 35,000원 | trdAmt |
| 과세금액 (공급가액) | 27,273원 | taxAmt (30,000 ÷ 1.1) |
| 부가세 | 2,727원 | vatAmt (30,000 - 27,273) |
| 비과세금액 | 2,000원 | taxFreeAmt |
| 봉사료 | 3,000원 | svcAmt |
검증: taxAmt + vatAmt + taxFreeAmt + svcAmt = 27,273 + 2,727 + 2,000 + 3,000 = 35,000원
자주 묻는 질문
Q. taxTypeCd를 설정하지 않으면 어떻게 되나요?
상점 설정에 따라 기본값이 적용돼요. 대부분의 상점은 과세(N) 가 기본값으로 설정되어 있어요. 정확한 설정은 영업 담당자에게 확인하세요.
Q. 복합과세에서 금액 계산이 맞지 않으면요?
결제가 실패해요. taxAmt + vatAmt + taxFreeAmt가 총 결제 금액(trdAmt)과 정확히 일치해야 해요. 원 단위까지 맞춰야 하므로 반올림 처리에 주의하세요.
Q. 비과세 상품만 판매하는데 매번 Y로 설정해야 하나요?
상점 기본 설정을 비과세로 변경할 수 있어요. 영업 담당자에게 요청하시면 기본값을 변경해드려요.
Q. 현금영수증도 세금 유형에 따라 다르게 발급되나요?
네. 과세 결제는 부가세가 포함된 현금영수증이, 비과세 결제는 부가세 없이 발급돼요. 복합과세는 각각의 금액이 구분되어 발급돼요.
Q. 봉사료는 어떤 업종에서 사용하나요?
주로 음식점, 호텔, 숙박업소 등에서 사용해요. 봉사료는 부가세 과세 대상이 아니므로 별도로 svcAmt 파라미터에 전달해야 정확한 세금 계산이 가능해요.
정리
| 상황 | taxTypeCd | 필수 파라미터 |
|---|---|---|
| 일반 과세 상품 | N | trdAmt |
| 비과세 상품 (도서, 농수산물 등) | Y | trdAmt |
| 과세 + 비과세 혼합 | G | trdAmt, taxAmt, vatAmt, taxFreeAmt |
| 봉사료 포함 | N 또는 G | 위 파라미터 + svcAmt |
세금 유형을 올바르게 설정하면 현금영수증 발행과 세무 처리가 정확해져요. 특히 복합과세의 경우 금액 계산에 주의하고, 비과세 여부는 반드시 세무 담당자와 확인하세요.
