가상계좌 입금 후 콜백호출관련 문의드립니다.
가상계좌 입금이 완료되면 토스측에서 callback url을 호출해 주는데 현재 오류가 메일을 받은 상태입니다.
콜백 url호출을 한번이라도 실패하면 실패 메시지를 보내주는건지? 재시도를 한다면 얼마마다 재시도를 하는지 등, 콜백 url호출 시점 및 재시도 기준, 실패메일 발송 기준 등과 관련해서 상세한 정보 부탁 드립니다.
24 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
웹훅(Webhook) 연동하기 | 토스페이먼츠 개발자센터
웹훅은 데이터가 변경되었을 때 상점 서버에서 실시간으로 알림을 받을 수 있는 기능입니다. 웹훅을 연동해서 결제 상태 변경, 지급대행 실행, 브랜드페이 고객 결제수단 업데이트와 같은 변경 사항을 실시간으로 받아보세요.
정책은 해당 링크 참고 부탁드립니다.
콜백은 실패하면 실패시마다 메일을 발송합니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
실패한 웹훅의 주문번호를 알 수 있을까요?
메일에 관련 내용이 있으실겁니다.
메일에서 노티 url 을 제외하고 공유부탁드립니다.
가상계좌 입금완료 통보가
정상적으로 처리되지 않았습니다.
상점 서버에 이상이 있거나 입금완료 알림 URL에 문제가 있을 수 있습니다. 아래 내용을 확인한 후 문제를 해결해 주세요.
콜백 상세 정보를 확인한 후 서버에 이상이 있는지 점검해주세요.
콜백 상세 정보
호출 주소: --------------------------
호출 실패 시각: 2023-09-13T12:26:28.940435+09:00
재시도 회차: 6회 (에러 : 접속할 수 없거나 잘못된 URL 입니다. 올바른 URL을 넣어주세요.)
입금완료 알림 URL이 올바르게 설정되어 있는지 확인해주세요. 바로가기>
callback url이 변경되어서 발생한 오류라고 파악 되었습니다. 오류난 건을 처리할려는데 어떤 건인지 알기위해 주문번호를 알수있을 지 문의드립니다.
주문번호는 10256_B20230911170246 로 확인됩니다. 맞으신지 크로스체크 부탁드릴께요.
맞는것 같습니다.
감사합니다.
헌데 주문번호를 알기위해서는 매번 이렇게 문의를 드려아 하는건가요?
보통 해당 통보실패는 URL 서버에 문제가 있는경우가 있어서 주문번호가 필요하지는 않으실것 같은데요.
서버에 문제가 있는게 맞습니다. 헌데 실패할 경우 수기로 처리를 해야하는데 어떤건이 실패했는지 명확히 알 필요가 있습니다.
이부분은 개발자 센터에서 웹훅 메뉴를 보시면 각각의 통보건이 실패했는지 성공했는지 보실수 있습니다.
메일본문에 주문관련 정보를 추가 할수 있을지 확인해 보겠습니다.
아. 웹 훅 메뉴가 있군요.
확인 해 보겠습니다.
요청한 웹 훅 리스트를 확인할 수 있는 메뉴가 있다는건가요?
몇가지 정리 하겠습니다.
지금 API 버전 1.0 이고, 아직 virtualAccountCallbackUrl 파라미터를 사용하고 있는것 같습니다. virtualAccountCallbackUrl 파라미터를 사용하고 있는 경우에는, 개발자센터 웹훅 메뉴에서 통보건 성공 / 실패여부 확인이 불가 합니다.
가능하면 웹훅을 상점관리자에 등록하여 사용하시는 것을 권장 드립니다.
상점관리자에 웹훅을 등록하면, 해당 시간대에 발송한 웹훅 현황을 상점관리자에서 확인할 수 있습니다
https://docs.tosspayments.com/reference/release-note#%EA%B0%80%EC%83%81%EA%B3%84%EC%A2%8C-api-%EB%B0%8F-sdk
릴리즈 노트 | 토스페이먼츠 개발자센터
토스페이먼츠 제품의 새로운 기능과 변경 사항을 알아보세요.
네 감사합니다.
그리고 웹훅 재전송 정책을 말씀해 주셨는데 문서에 의하면 7회 실패 후 이메일 이벤트 정보를 알려준다고 되어있는데 실제로는 4회, 5회, 6회차 실패시 메일이 발송되는것으로 보여집니다. 이부분도 검토 바랍니다.
문서 어느부분인지 링크 알려주실 수 있으실까요?
웹훅(Webhook) 연동하기 | 토스페이먼츠 개발자센터
웹훅은 데이터가 변경되었을 때 상점 서버에서 실시간으로 알림을 받을 수 있는 기능입니다. 웹훅을 연동해서 결제 상태 변경, 지급대행 실행, 브랜드페이 고객 결제수단 업데이트와 같은 변경 사항을 실시간으로 받아보세요.
'전송 중'일 때 '다시 시도'를 누르면 진행 중이던 재전송 시도는 무효화되고 새로운 1회 요청이 시도됩니다. 웹훅 전송이 계속 실패한다면 등록한 웹훅 URL의 포트 번호에 방화벽 설정이 허용되어 있는지 확인해보세요. 7회 전송까지 실패하면 이메일로 이벤트 정보를 알려드립니다.
문서 내용이 모호하게 이해될수 있는점 이해 합니다.
1, 2, 3 회 실패시에는 메일을 못받으셨나요?
네. 1, 2, 3회차는 메일을 못받았습니다.
현재 4, 5, 6회차 메일을 받은상태이고 아마도 7회차 메일도 받을것 같은데 만약 메일에 주문번호가 있다면 혼동이 없었을것 같으나 주문번호가 없으니 4, 5, 6회차 실패메일이 동일한 주문의 실페메일인지 확인이 안되서 애로사항이 있습니다.
재전송 회차는 메일에 표시가 될겁니다.
1,2,3회의 경우 1,4,16분 에 전송이 되다보니 메일 전송은 제외 처리 되어 있는것으로 확인됩니다.
재전송 회차는 표시되고 있으나 어떤 주문에 대한 실패인지가 확인이 안되는데 이 부분은 개선 여지가 있는지요?
우선은 가이드 드린것처럼
상점관리자에 웹훅 등록하셔서,
상점관리자에서 특정 시간대 발송된 웹훅 이력 확인하는 방법을 활용 부탁 드립니다.
url 유효여부를 http status code 를 기반으로 해서,
목적지가 유효하지만 단순 수신이 안된것인지, 아니면 목적지가 유효하지 않은지에 따라서 주문번호를 전달하고 있지 않은데,
이 부분에 개선이 필요할지 여부는 내부에서 별도 확인 해보도록 하겠습니다.
웹 훅 등록처리는 개산하도록 하겠습니다.
감사합니다