김순태
김순태2y ago

지급대행 요청 실패시 failure

안녕하세요, 혹시 지급대행 요청 실패시 Payout 객체 내부에 failure (code, message) 의 규격을 확인할 수 있나요?
19 Replies
토스페이먼츠 BOT
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) : - 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요. * 주말/공휴일에는 답변이 늦을 수 있어요.
김순태
김순태OP2y ago
대표적으로 어떠한 에러 메시지가 발생되는지 입니다.
유부장
유부장2y ago
에러 코드 | 토스페이먼츠 개발자센터
토스페이먼츠 API/SDK를 사용할 때 발생할 수 있는 에러를 살펴보세요.
김순태
김순태OP2y ago
감사합니다 🙂
토스페이먼츠 BOT
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
김순태
김순태OP2y ago
혹시 여기서 지급요청을 한 대상의 계좌가 유효하지 않다면 INVALID_REQUEST 에러가 발생할까요?
토스페이먼츠 BOT
🫖 에러메세지를 찾아주세요 🧚
* code : INVALID_REQUEST * message : 잘못된 요청입니다. 🧞 발생가능한 에러를 모두 알려드려요~ 🔮 신용카드
- 예상문제 : 주민번호 또는 사업자번호가 숫자가 아닙니다.
- 해결방안 : 주민번호/사업자 번호에 숫자가 아닌 문자가 있습니다. 다시한번 확인해 주시기 바랍니다.
- 예상문제 : 주민번호 또는 사업자번호가 숫자가 아닙니다.
- 해결방안 : 주민번호/사업자 번호에 숫자가 아닌 문자가 있습니다. 다시한번 확인해 주시기 바랍니다.
🔮 신용카드
- 예상문제 : 주민번호/법인번호 자리수 오류입니다.
- 해결방안 : 주민번호또는 사업자 번호의 자리수가 올바르지 않습니다 주민번호 13자리, 사업자 번호 10자리 숫자입니다.
- 예상문제 : 주민번호/법인번호 자리수 오류입니다.
- 해결방안 : 주민번호또는 사업자 번호의 자리수가 올바르지 않습니다 주민번호 13자리, 사업자 번호 10자리 숫자입니다.
🔮 신용카드
- 예상문제 : 잘못된 결제요청입니다. 다시 시도해 주시기 바랍니다.
- 해결방안 : 결제 요청시 오류가 발생했습니다. 잠시후 다시 시도해 주시기 바랍니다.
- 예상문제 : 잘못된 결제요청입니다. 다시 시도해 주시기 바랍니다.
- 해결방안 : 결제 요청시 오류가 발생했습니다. 잠시후 다시 시도해 주시기 바랍니다.
🔮 신용카드
- 예상문제 : Z2:Not Exist Error MsgCode
- 해결방안 : 원인을 알수 없는 오류입니다. 카드사로 문의해 주시기 바랍니다.
- 예상문제 : Z2:Not Exist Error MsgCode
- 해결방안 : 원인을 알수 없는 오류입니다. 카드사로 문의해 주시기 바랍니다.
🔮 신용카드
- 예상문제 : 금액 필드가 잘못되었습니다.
- 해결방안 : 결제 금액을 잘못 입력하셨습니다. 다시 한번 확인해 주시기 바랍니다.
- 예상문제 : 금액 필드가 잘못되었습니다.
- 해결방안 : 결제 금액을 잘못 입력하셨습니다. 다시 한번 확인해 주시기 바랍니다.
예상문제는 상점관리자에서 주문번호 별로도 확인가능해요!
유부장
유부장2y ago
유효하지 않는 계좌라면, 서브몰 등록시에 등록이 되지 않습니다. 관련해서는 아래 링크 입니다 https://docs.tosspayments.com/reference/error-codes#%EC%84%9C%EB%B8%8C%EB%AA%B0-%EB%93%B1%EB%A1%9D
에러 코드 | 토스페이먼츠 개발자센터
토스페이먼츠 API/SDK를 사용할 때 발생할 수 있는 에러를 살펴보세요.
김순태
김순태OP2y ago
서브몰 등록시에는 유효했지만, 추후에 유효하지 않게 된 경우가 궁금합니다 서브몰 등록시 정상 , 지금대행 요청시 비정상
유부장
유부장2y ago
일반적으로 발생하지 않을 케이스 인데요 서브몰 등록하게 되면, 해당 고객이 유효한 고객인지 저희측에서 별도 프로세스까지 진행 됩니다 (KYC) COMMON_ERROR 로 응답된다 라고 인지 해주시고, 저희측에 별도 문의를 해주셔야 할것 같습니다.
김순태
김순태OP2y ago
넵 확인했습니다. 감사합니다!
Kimoon Lee
Kimoon Lee2y ago
이경우 지급대행 요청도 문제없이 되실거구요. 실제로 지급시에 에러가 발생할겁니다. 정상적으로 지급되었는지 여부를 웹훅으로 받아서 관리하셔야 할것 같아요.
김순태
김순태OP2y ago
이거 웹훅에 대한 정보가 어디있을까요? 문서상에 웹훅을 못찾아서요
Kimoon Lee
Kimoon Lee2y ago
웹훅(Webhook) 연동하기 | 토스페이먼츠 개발자센터
웹훅은 데이터가 변경되었을 때 상점 서버에서 실시간으로 알림을 받을 수 있는 기능입니다. 웹훅을 연동해서 결제 상태 변경, 지급대행 실행, 브랜드페이 고객 결제수단 업데이트와 같은 변경 사항을 실시간으로 받아보세요.
Kimoon Lee
Kimoon Lee2y ago
여길 참고하시면 됩니다.
김순태
김순태OP2y ago
감사합니다! 마지막으로 점검차 확인 요청드려요! 1. 계좌번호가 잘못되어있을 경우 지금대행 요청은 성공한다. 2. 실제 지급시에 에러가 발생하고, 웹훅을 통해서 실패 상태를 내려준다. 3. failure 의 상태는 common_error 가 발생된다 가 맞을까요?
김차장
김차장2y ago
네 맞습니다
김차장
김차장2y ago
코드 관련 내용의 Exception 은 케이스별로 다루시는것이 좋습니다 https://docs.tosspayments.com/reference/error-codes#%EC%A7%80%EA%B8%89%EB%8C%80%ED%96%89-%EC%9A%94%EC%B2%AD
에러 코드 | 토스페이먼츠 개발자센터
토스페이먼츠 API/SDK를 사용할 때 발생할 수 있는 에러를 살펴보세요.
김순태
김순태OP2y ago
확인했습니다 감사합니다 🙂

Did you find this page helpful?