지급대행 셀러 웹훅 관련
안녕하세요, 현재 지급 대행을 개발하여 테스트중에 있습니다.
셀러 상태에 대한 웹훅을 설정 완료했습니다. eventType : seller.changed
본인인증을 완료하면 웹훅으로 status : PARTIALLY_APPROVED 이 오는걸 확인했는데요
셀러 수정 요청으로 핸드폰번호를 수정했을때 웹훅이 발송되지 않는것으로 보입니다.
셀러의 상태가 APPROVAL_REQUIRED 의 상태는 웹훅으로 받을 수 없나요?
또한 아래의 에러는 왜 발생하는걸까요?

21 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
일단 오류 횟수 초과는
같은 번호로 인증번호나 인적정보 오류가 다수 쌓이면 일시적으로 인증이 정지되는데요
KMC한국모바일인증에서 해당 인증 차단을 해제할 수 있습니다
https://www.kmcert.com/BlockCert.jsp
APPROVAL_REQUIRED 는 개인/개인사업자의 경우 초기 등록시 발생하는 상태로 웹훅을 발송하고 있지 않습니다. https://docs.tosspayments.com/reference/using-api/webhook-events#sellerchanged
웹훅 이벤트 | 토스페이먼츠 개발자센터
토스페이먼츠에서 제공하는 웹훅 이벤트 목록입니다.
웹훅은 상태가 변경된 경우만 발생하고 있기 때문에 등록된 셀러는 셀러조회 API를 이용하셔야 합니다.
전화번호가 변경되어도 상태가 변경되는것아닌가요?
관리자페이지에서 등록완료인 셀러의 전화번호를 수정했을때 등록대기 상태로 옮겨지는것은 확인했습니다.
해당 셀러의 상태를 api 조회했을때도 status가 'APPROVAL_REQUIRED' 로 변경된것으로 확인됩니다
셀러 아이디 남겨주시겠어요?
seller_a01jxhdbyw1899pfd2jn78e8j22
입니다
이슈 확인하였습니다. 해당 현상 관련해서는 내부 논의 후 답변드리겠습니다.
기존에 고려된 부분이 아니라서 시간이 다소 소요될 수 있습니다.
감사합니다.
개발 완료기간이 얼마 남지 않아 추후 처리 방향성이 결정되면 알려주시면 감사하겠습니다.
추가로 잔액조회할때 개발에서 임의로 잔액을 추가할 방법은 없을까요?
테스트쪽은 방금 충전해드렸습니다.
감사합니다!
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
안녕하세요 질문이 있습니다.
{
refPayoutId: "test",
destination: "seller_a01jxm2wep87ms5ysgmtgd5e6p",
scheduleType: "EXPRESS",
amount: {
currency: "KRW",
value: 5000,
},
transactionDescription: "테스트",
}
위와 같이 지급 요청을 보내고있습니다. Body 암호화도 진행했습니다.
그러나 에러 처리되면서
{"version":"2022-11-16","traceId":"a5502becb1eb4e42d76e9cd23bfbc25b","entityBody":null,"entityType":null,"error":{"code":"INVALID_REQUEST","message":"필수 파라미터가 누락 또는 요청 형식이 잘못되었습니다."}
위와 같은 에러를 응답받습니다.
필수 파라미터 모두 들어간것같은데 왜 에러가 발생할까요?
지급대행 요청은 {}가 아닌 []로 시작합니다.
[{
refPayoutId: "test",
destination: "seller_a01jxm2wep87ms5ysgmtgd5e6p",
scheduleType: "EXPRESS",
amount: {
currency: "KRW",
value: 5000,
},
transactionDescription: "테스트",
}]
이렇게 넘겨보셔요
개발 셀러의 상태 변경은 따로 요청 드려야할까요? APPROVAL_REQUIRED 에서 PARTIALLY_APPROVED 상태로 변경을 희망합니다.
sellerId : seller_a01jxfc879sjm96eyftjmgsmnmw
입니다.
셀러 상태 변경은 제공하지 않습니다. 새로 법인 사업자로 셀러를 등록해주시면 PARTIALLY_APPROVED 상태이므로 그렇게 테스트해주세요.
안녕하세요!
지급대행에서 잔액조회 호출의 제한 기준을 알 수 있을까요?
잦은 호출을 하니 에러가 발생해서 여쭤봅니다!
운영은 에러가 발생하지 않는데 개발에서만 존재하는 에러일까요?
어떤 에러 발생하였나요? 그리고 문의 내용이 다르면 글을 새로 작성 부탁들비니다.
테스트 환경은 리소스가 제한적이라 AP를 자주 호출하면 에러 발생할 수는 있습닏.ㅏ
혹시 기존에 여쭤봤던 웹훅 이슈건은 어떻게 처리될지 정해졌을까요?
해당 부분은 제품팀에 요청했으나 관련팀 리소스 이슈로 아직 검토 대기중입니다. 🙏
검토가 늦어 죄송합니다.
휴대폰 번호 변경으로 APPROVAL_REQUIRED 상태로 변경된 경우 웹훅 발송하지 않는 것이 정책입니다. 이 경우는 가맹점에서 인지하고 수정 요청을 했기 때문입니다.
seller.changed 웹훅은 KYC 이슈가 발생하여 셀러 상태가 변경된 경우를 알리기 위해 개발된 것으로 PARTIALLY_APPROVED -> APPROVAL_REQUIRED 상태로 변경된 경우는 웹훅을 지원하지 않습니다.