결제 에러 처리 방식에 대한 문의
안녕하세요, 스프링 프레임워크(EgovFramework) 환경에서 '토스페이먼츠' Javascript SDK를 이용하여 카드결제, 가상계좌, 계좌이체 일반 결제 모듈을 순차적으로 연동중에 있습니다.
각 결제 수단별로 '결제 인증 -> succssUrl 호출 -> 결제 승인 API 호출' 과정으로 연동 로직을 구현하는 중에 에러 처리 방식에 대해 궁금한 점이 생겨 문의드립니다.
여기서의 '에러'란 요청 데이터 변조로 인해 상점상의 상품 결제 금액과 요청 파라미터로 넘어온 결제금액이 상이한 경우와
결제 승인 API까지 모두 성공적으로 처리한 후 상점상의 '주문정보 상태'를 '입금완료'로 변경하기 전 상정의 DB에서 주문 정보를 조회하는 부분에서 '주문정보가 없거나', '통신상의 오류'가 있는 경우
기타 등등...
위와 같은 에러 발생 시 결제 승인을 Rollback(?) 시키고자 하는데요.
토스페이먼츠측에서 제공하는 API 문서에 관련 자료가 있을까요?
(첨부된 이미지는 successUrl 호출 후 그 안에서 결제 승인 API까지 처리된 '성공' 응답 데이터를 바탕으로 이후 DB 처리 과정 로직의 일부입니다.)
2 Replies
별도의 rollback API는 제공하고 있지 않으며,승인이 후 문제가 생길경우 결제취소API 호출하는 것으로 가이드 드리고 있습니다.
또한 결제대사와 정산대사 API를 통해서 요청금액과 실제 결제 금액이 다른지 확인할 수 있으며, 이 과정에서도 문제가 있을 경우 결제 취소API를 호출하여 결제를 무효화할 수 있습니다. (단, 가상계좌 환불은 은행과 계좌번호 예금주를 사전에 보관하고 있어야 취소 가능합니다.)
또는 웹훅을 통해서 결제 결과 확인 가능합니다.
그렇군요. 답변 감사드립니다!