📌 PortOne 결제 시스템 연동 (결제하기 + Access Token 발급 + 다건 조회)

My Pale Blue Dot·2025년 5월 15일

PortOne Spring Springboot 결제 인증 조회

SPRING BOOT

목록 보기

32/40

📌 PortOne 결제 시스템 연동 (결제하기 + Access Token 발급 + 다건 조회)

📅 날짜

2025-05-15

📝 학습 내용

1️⃣ PortOne 관리자 콘솔 준비

채널 생성: 👉 https://admin.portone.io/integration-v2/manage/channel
테스트 SDK: 👉 https://sdk-playground.portone.io
연동 정보 확인 위치: 결제 연동 > 연동정보에서 다음 항목 확인 가능:
- REST API KEY
- REST API SECRET

2️⃣ HTML: 결제 & 본인인증 버튼 테스트

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>PortOne 테스트</title>
</head>
<body>

<!-- UI -->
<button onclick="pay()">결제하기</button> |
<button onclick="auth()">본인인증</button>

<!-- PortOne SDK 로드 -->
<script src="https://cdn.iamport.kr/v1/iamport.js"></script>
<script>
    IMP.init("imp68801222"); // 고객사 식별 코드

    function pay() {
        IMP.request_pay({
            channelKey: "channel-key-xxxxx",
            pay_method: "phone",
            merchant_uid: "merchant_" + crypto.randomUUID(), // 고유 주문번호
            name: "테스트 결제",
            amount: 100,
            buyer_tel: "010-0000-0000"
        });
    }

    function auth() {
        IMP.certification({
            channelKey: "channel-key-xxxxx",
            merchant_uid: "test_" + new Date().toString()
        }, function(resp) {
            console.log(resp); // 본인인증 결과 콜백
        });
    }
</script>

</body>
</html>

3️⃣ Spring Boot - Access Token 발급

@GetMapping("/getToken")
@ResponseBody
public void getToken() {
    log.info("GET/portOne/getToken");

    String url = "https://api.iamport.kr/users/getToken";

    HttpHeaders header = new HttpHeaders();
    MultiValueMap<String, String> params = new LinkedMultiValueMap<>();
    params.add("imp_key", RESTAPI_KEY);       // 발급받은 키 입력
    params.add("imp_secret", RESTAPI_SECRET); // 발급받은 시크릿 입력

    HttpEntity<MultiValueMap<String, String>> entity = new HttpEntity<>(params, header);

    RestTemplate rt = new RestTemplate();
    ResponseEntity<PortOneTokenResponse> response = rt.exchange(url, HttpMethod.POST, entity, PortOneTokenResponse.class);

    this.portOneTokenResponse = response.getBody(); // 추후 조회에 사용
    System.out.println(this.portOneTokenResponse);
}

4️⃣ Access Token 응답 DTO

@Data
private static class TokenData {
    public String access_token;
    public int now;
    public int expired_at;
}

@Data
private static class PortOneTokenResponse {
    public int code;
    public Object message;
    public TokenData response;
}

5️⃣ 결제 내역 다건 조회

@GetMapping("/getPayments")
@ResponseBody
public void payments() {
    log.info("GET/portOne/getPayments...");

    // imp_uid 기반으로 다건 조회
    String url = "https://api.iamport.kr/payments?imp_uid[]=imp_xxxxx";

    HttpHeaders header = new HttpHeaders();
    header.add("Authorization", "Bearer " + this.portOneTokenResponse.getResponse().getAccess_token());
    header.add("Content-Type", "application/json");

    HttpEntity<?> entity = new HttpEntity<>(header);

    RestTemplate rt = new RestTemplate();
    ResponseEntity<String> response = rt.exchange(url, HttpMethod.GET, entity, String.class);

    System.out.println(response);
}

✅ 응답 예시 (마스킹 처리)

{
  "code": 0,
  "message": null,
  "response": [
    {
      "amount": 100,
      "buyer_tel": "010-0000-0000",
      "imp_uid": "imp_",
      "merchant_uid": "merchant_",
      "pay_method": "phone",
      "pg_provider": "danal",
      "status": "paid"
    }
  ]
}