지급요청 문의사항 2가지 (지급대행 목록, 지급대행 실패 처리)
1. 현재 문서에 기재된 'https://api.tosspayments.com/v2/payouts' 경로로 GET 요청을 보내고 있으나 404로 반환됩니다.
response: {
"timestamp": "2025-11-25T08:31:40.257+00:00",
"status": 404,
"error": "Not Found",
"path": "/v2/payouts"
}
해당 API가 삭제된것인가요? 아니면 별도로 추가해주어야하는 정보가 있을까요?
headers에 Authorization 값은 넣어서 보내고 있습니다.
2. 'INVALID_PAYOUT_DATE' 에러 발생으로 지급대행 불가한 일자에 요청한 것으로 보이나 해당 건 정보를 확인해볼 수 있나요?
요청시간이나 요청 파라미터라던가, 반려된 상세한 이유를 확인하고 싶습니다. (상점관리자-지급대행-지급 요청서 작성/조회 에서는 조회가 되지 않습니다)
상점 ID: pocket_yak5of6
refPayoutId: payout-10
추가)
payout 콜백의 refPayoutId가 null 으로 오는데 오류인가요? 아님 요청시에 빠져있는 데이터인가요?
19 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(문제가 발생한 이미지나 전체 결제흐름 동영상을 첨부해주시면 빠른 분석을 받으실 수 있습니다.)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
1. 보내는 요청 내용이 지급대행 요청인가요?
2. 응답이 이렇게 나갔어요
요청이 15:00:01 에 들어왔네요
https://api.tosspayments.com/v2/payouts' 이거는 그냥 브라우저에서 열어보세요.
어떤 결과 나오는지 공유 부탁드립니다.
브라우저에서 열면 headers에 키값 토큰이없어서 오류입니다
네 그럼 404는 안나오시는것 같아요.
404는 다른 서버에서 요청하시는 건가요?
2. 응답은 확인하였습니다. 응답에 대한 요청값을 확인할 수 있을까해서 요청드렸습니다~ 최소한 요청시간이라도 알수있으면 좋을거같습니다
404는 POSTMAN 으로 요청하였습니다
그럼 POST man 에서 요청하신 내용 스크린 캡쳐 해주실수 있을까요?
이렇게 요청하셨습니다.
[{"refPayoutId":"payout-10","destination":"seller_a01k9nq6pv5zw3nvxsd9mzq8qej","scheduleType":"EXPRESS","amount":{"currency":"KRW","value":"303912"},"transactionDescription":"정산지급","metadata":{}}]
postman 이렇게 요청하였습니다
지급요청 응답이 에러코드를 확인해보니 '지급일자는 과거일자 또는 공휴일로 설정할 수 없습니다. 올바른 지급일자를 입력해주세요.' 로 나와서 지급요청시간대를 확인하고 싶은데 방법이 있을까요?
일단 인증방식이 Bearer 가 아니라 Basic 인증으로 해주셔야 하고요.
지급요청 API 호출 하실 때에는 payoutDate 가 파라미터가 없습니다.
문의 주실 때 정보를 부분부분 주시면 저희쪽에서 파악이 어렵습니다.
응답으로 받은 traceId 를 함께 전달 주시면 확인이 수월하니 traceId 를 넘겨주시는것도 좋습니다.
제일 마지막에 적은 추가 문의사항의 refPayoutId 값이 null 로 오는경우는 어떤 경우인지 알수있을까요?
payout-10 <-- 이것 말씀하시는거죠?
이건 EXPRESS 요청 주시긴 하셨는데,
바로지급 요청을 15시 넘어서 주셔서 가능시간이 넘어서 실패한거로 보여요.
payout 콜백으로 온 값에서 entityBody의 refPayoutId 값이 null로 넘어오는 경우가 있어서 문의드렸습니다
refPayoutId는 상점에서 보내주는 값이 지급 요청시 refPayoutId를 안보내면 응답에도 없습니다.
그럼 API 가 아닌 웹 상점관리자에서 직접 지급한 경우는 null 값으로 오는게 맞을까요?
네
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.