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