💳 토스페이먼츠 연동하기 (3) _결제 성공/실패

📌 해당 게시물은 전 게시물과 이어지는 내용입니다.
📌 <결제 흐름 역할별 정리>에서 4~6번에 해당하는 내용입니다.

결제창을 이용하여 정상적으로 결제가 완료되면,

아래와 같이 지정해둔 성공 시 콜백 URL로 orderId, paymentKey, amount 3개의 파라미터 값이 넘어오게 된다.

• paymentKey
  ➜ 토스페이먼츠에서 정한 결제 구분용 키
  ➜ 결제 취소 / 결제 조회에 사용됨
  ⠀
• orderId
  ➜ 서비스에서 정한 주문 고유번호
  ➜ 각 주문 별 unique한 값이기 때문에 이 값을 가지고 저장된 결제 호출 내역을 조회하여 (현재 amount 값 <-> 결제 요청 때 저장된 amount 값)을 비교하면 동일한 가격으로 정상적인 주문이 완료되었는지 확인할 수 음
  ⠀
• amount
  ➜ 가격 정보

---

그럼 이제 프론트에서 요청한 데이터를 반환해주었고

프론트가 그 응답데이터로 결제 요청을 했기 때문에

토스페이먼츠가 결제 결과로 성공 시 리다이렉트 될 주소로 응답을 보낸 것을 처리할 것이다.

🌼 성공 시 콜백 응답 처리 + 검증 로직

✔️ 성공 Controller

• tossPaymentSuccess
  

➜ 성공 시 콜백 요청을 처리하는 곳
⠀
➜ 토스페이먼츠가 보낸 파라미터를 가지고 Service 로직에서 검증을 완료한 후 반환

---

✔️ 성공 Service

• tossPaymentSuccess()
  

➜ Controller에서 전달받은 값들을 이용하여 검증 로직들을 처리하는 메서드
⠀
➜ 정상 결제 후 해당 멤버의 결제 성공 여부, 포인트 등을 업데이트 해주는 부분이기도 함
⠀
➜ 정상 결제가 되었다면 추후 결제 취소 / 결제 조회를 할 수 있도록 paymentKey도 넣어줌
⠀

• verifyPayment()
  

➜ 결제 요청된 금액과 실제 결제된 금액이 같은지 검증하는 부분
⠀

• requestPaymentAccept()
  

➜ 토스페이먼츠에 최종 결제 승인 요청을 보내기 위해 필요한 정보들을 담아 POST로 보내는 부분

➜ net.minidev.json.JSONObject를 사용하여 키/값 쌍을 문자열이 아닌 오브젝트로 숫자 그대로 보낼 수 있음

➜ postForObject() 안에 필요한 정보인 < 요청 URL + 요청 객체 + 응답 Dto >를 넣어주면 됨

✔ 요청 URL
➜ "https://api.tosspayments.com/v1/payments/" + paymentKey

• restTemplate.postForObject()
  ➜ POST 요청을 보내고 객체로 결과를 반환받음
• restTemplate.postForEntity()
  ➜ POST 요청을 보내고 결과로 ResponseEntity로 반환받음

• getHeaders()
  

➜ 헤더에는 토스에서 제공해준 시크릿 키를 Basic Authorization 방식으로 base64를 이용하여 인코딩하여 꼭 보내야함
( ❗ 꼭! {시크릿키 + ":"} 조합으로 인코딩하기 )

---

✔️ 성공 Dto

• 결제 성공 시 응답 데이터인 PaymentSuccessDto

  @Data
  public class PaymentSuccessDto {
     String mid; // 가맹점 Id -> tosspayments
     String version; // Payment 객체 응답 버전
     String paymentKey;
     String orderId;
     String orderName;
     String currency; // "KRW"
     String method; // 결제 수단
     String totalAmount;
     String balanceAmount;
     String suppliedAmount;
     String vat; // 부가가치세
     String status; // 결제 처리 상태
     String requestedAt;
     String approvedAt;
     String useEscrow; // false
     String cultureExpense; // false
     PaymentSuccessCardDto card; // 결제 카드 정보 (아래 자세한 정보 있음)
     String type; // 결제 타입 정보 (NOMAL / BILLING / CONNECTPAY)
  }

• 응답 데이터로 함께 보내줄 결제 카드 정보인 paymentSuccessCardDto
  

---

🚩 이렇게 하고 테스트를 해보면, 아래와 같이 응답이 성공적으로 오는 것을 확인할 수 있다.

테스트 사진을 넣을 예정입니다.

그리고 해당 값을 백엔드에서 받아 고객에게 넘겨줄 정보만 잘 포장해서 프론트에 넘겨주는 응답은 아래와 같다.

---

이제, 토스페이먼츠가 결제 실패 시 콜백 주소로 리다이렉트 하는 요청에 대해 처리를 해볼 것이다.

🌼 실패 시 콜백 응답 처리 + 검증 로직

✔️ 실패 Controller

• tossPaymentFail
  

➜ 실패 시 콜백 요청을 처리하는 곳

---

✔️ 실패 Service

• tossPaymentFail
  

➜ 실패 응답을 처리하는 실제 로직 부분

➜ 결제 성공 여부를 false로 바꾸고 에러 메세지를 set함

---

✔️ 실패 Dto

• 결제 실패 시 응답 데이터인 PaymentFailDto
  

➜ 결제가 실패했을 경우 errorCode / errorMessage / 해당 주문 ID를 반환하기 위한 응답용 데이터

---

🚩 이렇게 해서 실패한 테스트를 진행해보려고 했는데

실제 돈이 없어도 결제가 되는 가결제 시스템이어서 그런지 실패할 테스트를 만들지 못해서

아래와 같이 postman으로 error Code와 message를 임의로 넣어주고 응답값이 잘 전달되는지 확인만 했다.

h2 DB에도 fail reason이 잘 들어가는 것을 볼 수 있다.

---

🎀 지금까지 완성된 부분

1. 프론트에서 결제 요청
2. 백엔드에서 요청 검증 후 필요한 정보와 함께 반환
3. 프론트에서 토스페이먼츠 호출
4. 토스페이먼츠에서 결제 결과를 성공/실패 시 콜백 주소로 리다이렉트

📌 다음 포스팅은 결제 취소에 대한 내용입니다.
⠀
👉 💳 토스페이먼츠 연동하기 (4) _결제 취소 / 결제 내역 조회