PAYOUT_STATUS_CHANGED 웹훅 관련
지급대행을 기존에 v1 에서 v2로 업데이트 하고 있습니다.
현재 지급대행 요청 상태변경 웹훅을 받아서 처리하고 있는데 v1 과 v2가 response body가
조금 다른걸로 알고 있는데 v2로 지급대행 요청하면 response body가 v2 버전으로 오나요??
현재는 v1 버전으로 바인딩해서 처리하고 있는데 이거를 혹시 버전에 따라 수정해야 할까요??
10 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
지급대행 v1과 v2는 응답값 형태가 다르기 때문에 각각 처리해주셔야 합니다.
문서 링크 공유드려요.
v1: https://docs.tosspayments.com/guides/payouts#%EC%A7%80%EA%B8%89%EB%8C%80%ED%96%89-%EC%9A%94%EC%B2%AD
v2: https://docs.tosspayments.com/reference#%EC%A7%80%EA%B8%89%EB%8C%80%ED%96%89-%EC%9A%94%EC%B2%AD
코어 API | 토스페이먼츠 개발자센터
토스페이먼츠 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
정산 지급대행 v1 | 토스페이먼츠 개발자센터
토스페이먼츠 정산 지급대행 v1 API 및 웹훅 스펙입니다. 지급대행은 하위 상점(서브몰)의 정산 금액을 토스페이먼츠가 대신 지급하는 서비스입니다.
웹훅 이벤트 | 토스페이먼츠 개발자센터
토스페이먼츠에서 제공하는 웹훅 이벤트 목록입니다.
{
"createdAt": "2025-10-27T12:25:29.229036",
"eventType": "PAYOUT_STATUS_CHANGED",
"data": {
"payoutKey": "tdpo_a01k8ggepkvqhw4xtwt2aydtb15",
"requestId": null,
"subMallId": "222222",
"payoutDate": "20251027",
"payoutAmount": 499000,
"requestedAt": "20251026235841",
"account": null,
"status": "COMPLETED",
"metadata": {
"plate": "175러8401",
"orderId": "200311",
"escrowId": "612997"
},
"failure": null
}
}
v1과 v2 는 이벤트 이름이 다릅니다. v2 로 변경하시고 v2 이벤트 웹훅을 설정하신후 v2 방식으로 처리하셔야 합니다.
저희가 기존에는 웹훅 이벤트 응답을 이렇게 바꿔있었는데 v2형태로 응답이 올거라서 거기에 맞게 수정해야 된다는 말씀이시죠?
요 웹훅 이벤트는 개발계에서 확인이 가능한가요??
아니면 운영에서만 확인 가능한가요?
개발계에서도 확인 가능합니다.
오 네 확인해보겠습니다.
개발계에서 셀러 등록시 법인사업자(CORPORATE)로 테스트 진행하시면 됩니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.