토스페이먼츠 에러 코드 문의 드립니다
API 호출시
상기 형식의 에러와
Payment 객체의 failure 에러는 어떤 점이 다른 건가요?
에러가 2가지 경우로 나눠져 혼란 스럽네요
failure에 에러가 발생하게 하려면 어떻게 해야하나요?
21 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
두가지로 나눠져 있다는게 어떤 의미 이실까요?
SDK 에러 말씀 이신가요?
API 호출시 code, message에 에러가 담겨져 오는 거랑 failure에 담겨져 오는 거랑
2가지 인거 같습니다
100원 아래 결제금액을 시도했더니
{"code":"BELOW_MINIMUM_AMOUNT","message":"신용카드는 결제금액이 100원 이상, 계좌는 200원이상부터 결제가 가능합니다."}
이렇게 넘어오네요
failure 객체는 안넘어오고요
failure 에 담겨져 있는건 어느 상황때 받아 보셨을까요?
아직 받아본적이 없어요 공식문서상에 에러가 발생하면
Payment객체의 failure에 담겨온다고 써있어서요
어떤 이야기 이신지 이해 했습니다.
API 호출 했을때의 실패 응답은 JSON 구조이고
해당 결제건에 대해 조회등을 했을 경우, 에러에 대한 조회가 가능하다면 조회 객체 내 failure 에서 에러를 확인 할 수 있다는 의미 입니다.
에러 처리라면, JSON 응답 되는 것만 처리 해주세요.
payment객체가 넘어올때 failure 필드가 있으면 오류 아닌가요?
failure nullable · objectv1.4
결제 실패 정보입니다.
code string
오류 타입을 보여주는 에러 코드입니다.
message string
에러 메시지입니다. 에러 발생 이유를 알려줍니다. 최대 길이는 510자입니다.
다시 설명 드리자면
API 요청에 대한 실패가 있을때,
그때는 JSON 으로 응답이 되고
해당 결제건을 "조회" 했을때 (결제 조회라고 하겠습니다)
이때 failure 객체 내에 에러를 명시 해준다는 의미 입니다
이해가 되셨을까요?
결제조회 했을때 여기에 어떤 에러 였는지 표기 된다는 의미입니다
API 실패시에는 JSON 응답 되고요
이런식 으로요
그럼 결제 승인시에는 안나오는 건가요?
API 요청에 대한 실패가 있을때는 JSON 으로 응답이 됩니다.
아 네 무슨 말씀인지 알겠습니다
네 확인 감사합니다
문서에 설명이 좀 더 있었으면 좋겠습니다
모든 응답이 하나의 객체로 되다보니
어떤때 필드가 표출되고 안되고를 알수가 없네요
에러 응답 관련해서는 여기에 설명 되어 있는데
https://docs.tosspayments.com/reference/using-api/response
더 잘 설명할 수 있는 방법이 있을지 내부 고민 해보겠습니다.
응답 본문 | 토스페이먼츠 개발자센터
토스페이먼츠 API 응답 본문을 알아봅니다. 토스페이먼츠 API의 성공 여부는 HTTP 상태 코드로 전달합니다. 돌아온 HTTP 상태 코드에 따라 요청이나 에러를 처리하는 로직을 구축하세요.
네 그 문서는 읽었습니다
근데 failure랑 혼동이 되었네요..
네 좋은 의견 감사합니다
내부 에서 논의 해보고 개선 할 수 있는 부분 찾아 보겠습니다
네 답변 감사합니다 🙂
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.