모바일의 경우 네트워크가 불안정할시, 결제 후 다시 리디렉션 페이지로 돌아 왔을때 API 호출을 못하는 경우가 있는데요. 이를 방지하고자 보통 웹훅 기반의 결제 검증 프로세스
를 지원 하는데 토스페이먼츠에도 이 기능이 있을까요?
예를 들어, 사용자가 토스페이먼츠 위젯으로 결제를 성공했을때, 우리 서버 쪽으로 '결제 완료' 웹훅이 날아오는 기능이 있을까요?
16 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
네 있습니다. https://docs.tosspayments.com/reference/using-api/webhook-events#payment_status_changed 이가이드 참고해 보세요.
웹훅 이벤트 | 토스페이먼츠 개발자센터
토스페이먼츠에서 제공하는 웹훅 이벤트 목록입니다.
앗 냥과장님 감사합니다
추가로 한가지 이상한점?이 있는데 확인하고 싶은데용
웹훅 등록을 잘 해두었는데도 불구하고
결제 완료까지 잘 했을때
웹훅 내역에 뜨지를 않더라고용
혹시 웹훅 로직에서 아직 /v1/payments/confirm 를 호출하지 않아서 일까요?

앗 냥과장님. 승인 성공 웹훅 자체가.
결제 승인
POST
/v1/payments/confirm
을 호출해야 도착하는것 아닌가요?
그렇다 하면. 모바일에서 네트워크 불안정시. 저 웹훅 조차도 도착 못하지 않을까 싶어서요 (왜냐면 /v1/payments/confirm 를 호출할수 없었기 때문에)

클라이언트의 네트워크 불안정에 의한, 결제 실패는 별도로 핸들하실 필요 없습니다.
승인 API가 콜이 안되었기에, 고객에게서 돈이 빠져나가지 않구요.
고객들이 대부분 오류나 오랜기간 멈춘 화면을 보면
앱 내지는 사이트를 껏다 키고 다시 결제를 첨부터 하시기때문에
핸들하는 이유가 없습니다.
앗 제가 말씀 드리는것은
고객에서 돈이 빠져 나갔고
redirection URL Param에 ?paymentKey 등을 가지고 왔을시.
이때 /v1/payments/confirm 를 호출하지 못하는 경우였어요
그게 일어날 수 없어요
/v1/payments/confirm이 호출이 안되면 돈이 안빠져나가요
냐?!
/v1/payments/confirm가 호출이 되어야,
토스페이먼츠 서버가 카드사와 통신해서 돈을 가져옵니다.
호출이 안되면, 돈이 안빠져나가요.
카카오페이와 토스페이가 유일하게, /v1/payments/confirm을 호출하지 않아도 돈이 빠져나가는 케이스인데, 10분 내로 카카오페이 머니 및 토스머니에 자동 환불이 되기때문에 걱정하실 필요가 없으세요.
앗 그런 로직이 있군요
혹시 이런거는 토스페이먼츠 문서에는 없고 경험에 의해 알아야 하는 내용인가용?
결제 흐름 이해하기 | 토스페이먼츠 개발자센터
카드 결제 과정의 세 가지 핵심 단계인 요청, 인증, 승인을 이해하고 결제 정보를 검증하는 방법을 알아보세요.
문서에 있는 내용입니다 ㅎ

헐 감사합니다
큰 도움이 되었습니다..!
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.