본문으로 건너뛰기

복합과세

복합과세란 하나의 결제 건에 과세 상품(부가세 부과 대상)과 비과세/면세 상품(부가세 면제 대상)이 섞여 있는 경우를 의미합니다.

일반적인 결제는 총 금액의 10%를 자동으로 부가세로 계산하지만, 복합과세는 가맹점이 직접 공급가액, 부가세, 비과세 금액을 구분하여 요청해야 정확한 세무 처리가 가능합니다.

🧮 금액 산정 방식​

복합과세 결제를 요청할 때는 아래의 금액 공식을 반드시 준수해야 합니다. 금액의 합이 맞지 않을 경우 결제 요청이 거절될 수 있습니다.

{총 결제 금액} = {과세 금액(공급가)} + {부가세(VAT)} + {비과세 금액}
취소 시 주의사항

결제 서비스 종류에 따라 아래 복합과세 정보(변수)는 상이할 수 있습니다. 이점 유의하여 주시기 바랍니다.

구분변수명 예시설명
과세 금액taxAmount과세 상품의 물품 가액 (부가세 제외)
부가세vatAmount과세 상품에 대한 부가가치세 (통상 과세 금액의 10%)
비과세 금액freeAmount면세 상품의 총 금액 (도서, 농축수산물 등)
부가세 계산 예시
  • 상황: 콜라(1,100원, 과세)와 사과(2,000원, 면세)를 함께 구매
  • 총 결제 금액: 3,100원
  • 요청 데이터:
    • 과세 금액(taxAmount): 1,000원
    • 부가세(vatAmount): 100원
    • 비과세 금액(freeAmount): 2,000원

💳 결제 요청 (Payment Request)​

일반 결제와 달리, 복합과세 결제 시에는 복합과세 여부 플래그를 켜고 세부 금액 필드를 전송해야 합니다. 복학과세 결제 API 바로가기

  1. 복합과세 사용 설정: {taxInfo} 객체를 설정
  2. 금액 정보 설정: taxAmount, vatAmount, freeAmount 세부 금액 필드에 값 입력

JSON 요청 예시:

{
  "orderId": "ORD-001",
  "amount": 3100,          // 총 결제 금액
  "productName": "콜라 외 1건",
  "taxInfo": {
    "taxAmount": 1000,    // 과세 금액
    "vatAmount": 100,     // 부가세
    "freeAmount": 2000    // 비과세 금액
  }
}

↩️ 취소 요청 (Cancellation)​

복합과세 승인 건을 취소할 때도 반드시 원거래와 동일한 과세/비과세/부가세 정보를 포함하여 요청해야 합니다. 복학과세 취소 API 바로가기
특히 부분 취소(Partial Cancel) 시에는 취소하려는 금액만큼의 과세/비과세 정보를 정확히 계산해서 보내야 합니다. 만약 정보가 누락되면 남은 잔액의 세무 정보가 꼬이게 되어 정산 불일치가 발생합니다.

부분 취소 예시 (사과 2,000원만 환불 시):

{
  "orgTid": "TID-12345...",
  "cancelType": "Partial",
  "amount": 2000,    // 취소 요청 금액
  "taxInfo": {
    "taxationAmount": 0,    // 취소할 과세 금액
    "vatAmount": 0,         // 취소할 부가세
    "taxFreeAmount": 2000   // 취소할 비과세 금액
  }
}
취소 시 주의사항

이지페이에서는 부분 취소 시 남은 잔액(Remains) 검증을 수행합니다. (남은 총액) = (남은 과세) + (남은 부가세) + (남은 비과세) 공식이 성립하지 않으면 취소가 거절됩니다.

❓ 자주 묻는 질문 (FAQ)​

Q. 모든 상품이 과세 상품이면 복합과세를 안 써도 되나요?
A. 네, 그렇습니다. 일반 과세 상품만 판매하는 경우 taxInfo객체를 생략하면, 이지페이가 자동으로 총액 / 1.1 계산을 통해 부가세를 처리합니다.

Q. 비과세 금액만 보낼 수 있나요?
A. 과세금액, 부가세금액을 0원으로하고, 비과세 금액만 설정해서 결제 요청하면 됩니다.