Amount (카카오페이 결제 정보 DTO)
@Data
@Builder
@ToString
@NoArgsConstructor
@AllArgsConstructor
public class Amount {
private String cid = "TC0ONETIME"; // 가맹점 코드 (테스트용으로 “TC0ONETIME” 고정)
private String partner_order_id; // 주문번호 (예: “12345”)
private String partner_user_id; // 회원 아이디 (예: “user123”)
private String item_name; // 상품명 (예: “상품 A”)
private int quantity; // 수량 (예: 1)
private int total; // 총 결제 금액 (원 단위)
private int tax_free = 0; // 비과세 금액 (원 단위)
private int tax; // 부가세 금액 (원 단위)
private int point; // 사용한 포인트 (원 단위)
private int discount; // 적용된 할인 금액 (원 단위)
private int green_deposit; // 친환경 보증금(컵 보증금 등, 원 단위)
}
설명
- cid
카카오페이에 등록된 가맹점 번호. 테스트 환경에서는 “TC0ONETIME”을 사용합니다.
- partner\_order\_id
가맹점(우리 시스템)에서 생성한 고유 주문 식별자입니다. 카카오페이 요청 시 이 값으로 주문을 연결합니다.
- partner\_user\_id
결제를 요청하는 회원의 아이디(또는 회원 고유값). 카카오페이가 결제 결과를 되돌려줄 때 참고합니다.
- item\_name
결제할 상품 또는 거래 내역의 이름(예: “상품 A”).
- quantity
주문 수량(정수). 예를 들어 상품 3개를 결제한다면 3을 설정합니다.
- total
결제 대상 전체 금액(원).
예) 상품 가격 합계에서 할인/포인트를 제외한 최종 결제 금액.
- tax\_free
비과세 금액(원).
식료품 등 비과세 대상이 있다면 해당 금액을 설정하고, 보통 0으로 둡니다.
- tax
부가세 금액(원).
total에 이미 부가세가 포함된 경우, 별도 계산해서 넣거나 0으로 처리할 수 있습니다.
- point
사용자가 결제에 사용한 포인트 금액(원).
예를 들어 5,000포인트를 사용했다면 5000을 설정합니다.
- discount
쿠폰·할인 금액(원).
예) 2,000원 할인 쿠폰을 적용했다면 2000을 설정합니다.
- green\_deposit
친환경 보증금(컵 보증금 등) 금액(원).
이 값이 없으면 0으로 둡니다.