가상계좌 환불 요청 후 실패했다는 이메일 수신건에 대한 처리방식
가상계좌 환불 시 API 요청 당시에는 환불 승인되었다고 응답 받았으나 추후 오류가 있다고 정산 담당자 메일로 수신한 건들이 있습니다.
1. 주문번호: BIGC-1760526406-269879, 실패사유: 입금한도초과
2. 주문번호: BIGC-1760614379-283059, 실패사유: 해약계좌
// ... 등 8건
이 경우 처리 방법에 대해 문의드립니다.
1. 이처럼 요청 시에는 approved로 받았으나 나중에 실패한 경우에 대해 실패에 대한 웹훅을 수신할 수 있나요?
2. 이 경우 저희 서버 내애서는 환불 처리로 저장이 되는데, 토스 대시보드에서 어떻게 처리해야 할까요?
19 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(문제가 발생한 이미지나 전체 결제흐름 동영상을 첨부해주시면 빠른 분석을 받으실 수 있습니다.)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
해당 이슈로 환불 실패하게 된경우 결제 상태는 DONE으로 변경됩니다.
1. 실패한 경우는 웹훅 발송되지 않습니다.
2. 상태 미스매치가 발생하기 때문에 정산팀에서 별도 연락을 드리는데, 가맹점에서 수기 환불 진행하거나 상점관리자 혹은 API를 통해 다시 환불 진행하시면 됩니다.
정산담당자 메일에 보면 어떻게 처리해달라고 가이드가 있으실텐데요.
보통은 환불계좌 정보를 다시 메일로 보내달라고 정산팀에서 하시는 것으로 알고 있습니다.
환불가능한 계좌 메일로 회신주시면 그쪽으로 환불처리해 드릴거에요.
저희 정산 담당팀께 문의 드린을 포함하여 다시 문의드립니다.
해당 이슈로 환불 실패하게 된경우 결제 상태는 DONE으로 변경됩니다.1. 토스 페이먼츠 상점 관리자 페이지에서 처리하려 했으나 결제 상태가 "완료 -> 취소요청" 상태에서 멈춰있어 환불을 진행할 수 없는 상황이라고 전달 받았습니다. 예시) A. 10000원 결제 완료 후 9500원 취소 요청 B. 취소 요청에서 상태 멈춤 C. 관리자 페이지에서 취소 요청 진행하려 했으나 취소 가능 금액이 "500원"이라 노출. 9500 입력 시 취소 가능 금액 초과라고 노출 D. 금액을 제대로 입력할 수 없어 처리 불가 === 1. 결제 상태가 "DONE" 으로 변경된다고 안내해 주셨는데 왜 취소 가능 금액은 기 취소 요청을 포함한 상태로 유지가 되는 걸까요? 2 이 경우 토스 페이먼츠 정산팀과의 이메일을 통한 수기 처리 밖에 방법이 없을까요?
환불가능한 계좌 메일로 회신주시면 그쪽으로 환불처리해 드릴거에요.이 경우 이메일을 통한 취소 처리가 끝난 후 API 조회 시 API/상점 관리자 에서 정상적인 취소를 진행한 것과 동일하게 결과를 받을 수 있나요? 즉, 정상 취소 플로우를 탄 것 과 같은 결과를 받을 수 있을까요?
이미 취소 API 호출해서 취소 성공상태로 받으신 상태이실겁니다.
그래서 이메일로 고객에게 환불만 처리하면 됩니다.
이미 flow 상으로는 정상처리 된것과 같은 상황이시지 않나요?
@냥과장
이미 취소 API 호출해서 취소 성공상태로 받으신 상태이실겁니다.1. @박수습 님께서 이러한 취소 실패 발생 시 결제 상태 (status)가 "DONE"으로 변경된다고 안내해 주셨습니다. 그렇다면 정상 취소("PARTIAL_CANCELED" 또는 "CANCELED") 가 아닌 상태라 예측하여 문의드렸습니다. 결과적으로 해당 거래건은 상태가 어떤 상태로 있는걸까요?
그래서 이메일로 고객에게 환불만 처리하면 됩니다. 이미 flow 상으로는 정상처리 된것과 같은 상황이시지 않나요?2. 실제로 환불이 되지 않았기 떄문에 수기 처리가 필요한 상태고, 가상계좌 거래건 대비 낮지 않은 비율로 해당 이슈가 발생하여 이메일을 통한 수기 처리 보다는 관리자 페이지를 이용한 처리가 더 용이하다고 생각해 말씀드렸습니다. 또한 @박수습 님께서 상점관리자를 이용하면 된다 안내해 주셔서 문의드렸습니다.
1. 마지막 취소는 API 로 하셨나요? 아니면 상점관리자에서 하셨나요/
@냥과장
마지막 취소는 API 로 하셨나요? 아니면 상점관리자에서 하셨나요/마지막 취소라 말씀주신게 정산 담당자로부터 취소 실패로 안내받은 결제건에 대한 취소 요청 경로를 말씀하시는 걸까요? 앞 전제가 맞다면 API 로 진행하였습니다.
BIGC-1760526406-269879 이거 취소 성공 응답 받으신 날짜 알수 있을까요?
이력을 좀 확인해 보고 정확히 답변을 드려야 할것 같아요.
2025-10-21 01:40:49 UTC/ 2025-10-21 10:40:49 KST 입니다.
이 때 stauts 는 " CANCELED" 로 받았습니다.
지금 상태가 잘못되어 있는것 같은데 이부분 확인해 보고 공유 드릴께요.
@냥과장 님 혹시 확인된 내용 있으실까요?
@Kwangsub Lee 님 아직 확인 중에 있습니다. 늦어져서 죄송해요.
확인 되시면 답변 부탁드립니다
처리가 늦어져 죄송합니다. 예외 케이스라 현재 논의 중이며 완료되는데로 답변 드리겠습니다.
@Kwangsub Lee 님 해당 건들은 status: CANCELED 상태가 맞습니다.
현재 응답값 및 상점관리자 표시 이슈는 수정 예정인데 바로 조치가 어려워 CANCELED로 인지하고 후속 처리해주시면 됩니다.
저희측으로부터 수기환불 계좌 요청 받으셨을텐데 해당 프로세스 진행중인지 확인 부탁드려요.
그리고 총 8건으로 말씀하셨는데, 대상 주문번호 공유부탁드립니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
@today.lastday
현재 해당 프로세스 담당팀에서 토스 정산팀과 진행중으로 알고 있습니다. 아래 11건이 전달받은 건 입니다.
BIGC-1760613125-279869
BIGC-1760612516-278479
BIGC-1760613100-279682
BIGC-1760526406-269879
BIGC-1760614379-283059
BIGC-1760613139-279958
BIGC-1760613273-280910
BIGC-1760612596-278865
BIGC-1760526455-270471
BIGC-1760613836-282548
BIGC-1760526447-270391
안녕하세요.
이후 확인되거나 진행된 내용 있을지 문의드립니다.
1. 위 11건 확인이 진행된걸까요?
2. "현재 응답값 및 상점관리자 표시 이슈는 수정 예정" 이라 해 주셨는데 혹시 어떤식으로 수정될 예정인지 알려주실 수 있으실까요?
모두 CANCELED 로 보정될 예정입니다.
환불은 저희 정산팀과 진행해주시면 됩니다.
@Kwangsub Lee 님 위 건들 결제조회 API로 조회하시면 상태값 취소, 부분취소 상태로 확인되실거에요. 조회는 모두 보정되었습니다.
취소 방안은 위에 설명드린데로 정산팀 메일 통해서 수기 환불 진행하시면 됩니다!