/payment/confirm API에서 결제가 실패했지만 Payment 객체가 반환되는 경우가 있을까요?
안녕하세요. Toss 담당자님
외국인 개발자분 질문 요청이 있어서 글 남깁니다.
-----------------------------------------------------------------------------------------------
/payment/confirm API에서 결제가 실패했지만 Payment 객체가 반환되는 경우가 있을까요?
/payment/confirm API에서 결제가 성공한 경우 반환되는 Payment 객체는 항상 payment.status = "DONE"인 것으로 예상되는데, "DONE" 이외의 상태가 반환될 가능성이 있을까요?
질문의 배경: TOSS의 응답 사양에는 다음과 같은 설명이 있습니다.
"Returns a Payment object if successful. Provide the customer with the checkout.url to open the payment window.
Returns an error object if unsuccessful."
https://docs.tosspayments.com/en/api-guide#returns-1
위 설명에 따라 요구사항 정의 시에는 Payment 객체의 존재 유무만으로 결제 성공을 처리하는 정리를 하고 있습니다. 따라서 결제가 실패했음에도 불구하고 Payment 객체가 반환될 경우 "결제 실패했지만 임시 주문이 해제되는" 사례가 발생할 수 있습니다. 외부 설계의 전제로서 응답 사양을 확인하고자 합니다.
Integrate Payment APIs | 토스페이먼츠 개발자센터
Learn how to integrate Toss Payments APIs
5 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
Payment 객체는 성공일 때만 내려갑니다. 실패 시 아래 코드, 메세지가 내려가구요.
https://docs.tosspayments.com/reference/error-codes#코어-api-별-에러
API 에러 코드 | 토스페이먼츠 개발자센터
토스페이먼츠 API 사용할 때 발생할 수 있는 에러를 살펴보세요.
결제수단이 카드가 아니라 가상계좌일 경우에는 status 가 DONE 이 아닌 입금대기 상태인 WAITING_FOR_DEPOSIT 일 수는 있습니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
감사합니다!