토스 페이먼츠 가상 계좌 api로 결제시 환불 처리 프로세스
사내 시스템 취소 + 토스 상점 관리자에서 수기로 환불처리 맞나요?
토스에서 제공하는 가상계좌 취소 api 가 혹시 있을까요?
22 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
네~ API로 취소 가능합니다
코어 API | 토스페이먼츠 개발자센터
토스페이먼츠 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
/v1/payments/{paymentKey}/cancel 이쪽으로 취소 요청해주시면 되세요.
가상계좌 결제건에 환불을 진행하는 경우 refundReceiveAccount 이 값까지 같이 넘겨주시면 환불 진행됩니다.
500에러가 나오는데 이유를 잘 모르겠어서 가상계좌 취소 api 호출 해봤습니다
b'{"message":{"timestamp":"2025-05-14T05:05:09.458+00:00","status":500,"error":"Internal Server Error","path":"/v1/payments/%2...520'161142887',%2520'receiptUrl':%2520'https:/dashboard.tosspayments.com/receipts/cash-receipt/ZPR8BJU4GF69/reshopy4vh"}}'
알수있을까요? 응답 보내드렸어요
취소할 때 사용한
paymentKEy남겨주세요
'resho20250514115840etBj9'
입니다
취소 호출시 URI를 잘못 올렸어요. /v1/payments/{paymentKey}로 호출하셔야 합니다.
네 감사합니다!
/v1/payments/{paymentKey}/cancel
이거는 다른 api 인가요?
필수 파라미터 누락이 떠서요 기존 cancel api 재사용해서 쓰고 있는데!
같은 API 입니다 request body 를 어떻게 구성했는지 전달주세요
💡 정보 제출
민감 정보를 안전하게 제출해주세요
제출 했습니다
json 데이터가 이상한데요 실제로 저렇게 생성되었나요?
요소를 표현할때 " 가 아닌 ' 로 되어있습니다
잠시만요
endpoint도 이렇게 보내신것 같아요
/v1/payments/resho20250514115840etBj9/cancel/resho20250514115840etBj9
다시 제출할게요
제출 했습니다 두개 endpoint로 보냈어요 취소
https://api.tosspayments.com/v1/payments/resho20250514115840etBj9
이건 취소 endpoint 가 아니구요.
14시 42분에보내신건 정상취소 된것 같습니다.
감사합니다
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
혹시 환불 계좌 (가상계좌 결제시) 번호랑 은행명 토스페이먼츠 관라자 어디서 볼수있나요?

상점관리자 > 가상계좌
보시고
표설정 메뉴에서
활성화되어있는지 모세요