정산 API 관련 문의
정산 API 관련하여 문의드립니다.
1. 토스페이먼츠 개발자센터에서 직접 취소 버튼을 눌러서 취소한 건에 대해서 정산데이터가 잘 들어오는지 확인이 필요한데,
영업일 기준 5일이라고 들었습니다.
제가 2025년 11월 21일에 개발자센터 테스트서버에서 취소버튼을 눌러서 취소해서
11월 28일로 정산일이 잡힌다고 들었는데
정산 대상을 조회해보면 정산될 날짜를 결제 건별로 어떻게 조회가 되는지 잘 이해가 되지않습니다.
결국 StartDate와 EndDate 사이에 정산일이 들어와야 가능한 것 아닌가요?
그렇다면 인위적으로 StartDate 값을 27일, EndDate 값을 28일로 주면 들어온다는 말씀이실까요?
2. 지금까지 한국기초과학지원연구원쪽으로 토스페이먼츠 개발자센터에서
직접 취소 버튼을 눌러서 취소한 경우(운영서버, 개발서버 모두 포함)에 대한 정산 API 송신 건을
토스 측 로그 등에서 조회하여 저희에게 주실 수 있는지 확인 요청드립니다
이 질문에 대해
건별로 확인을 해야 해서 그렇게 정보를 제공해 드릴수 없습니다. 로그상 직접 취소했는지 API 로 취소 했는지는 건별로만 확인이 가능합니다
이렇게 답해주셨는데 혹시 그럼 확인을 위해 필요한 정보가 있을까요? OderId 등 드리면 확인 요청이 가능하다는 말씀이실까요?
41 Replies
1. 정산 대사 API 를 보면 정산 날짜 기준으로 요청을 하실수 있습니다.
2. 샘플 orderid 를 주시면 어떻게 호출해서 보실수 있는지 공유 드릴께요.
2. ARIA_2025f1c2b05aebcf45538e07b9027dbdb077
ARIA_2025e7995c1d8926458c884b9480194828df
ARIA_2025e4f34de2712e4625a4ee16313069afb5
ARIA_202506a4f3f744d24f25961145d4d714a9c3
ARIA_2025d27be66151834a57a91e0eef4ac1abe7
ARIA_2025779f7fb2cd68446eb7e9ad2e06d12850
이 orderId에 대해서 확인할 수 있을까요?
전부 테스트 상점 거래이신것 같은데요.
테스트 상점의 경우는 정산데이터가 제공되지 않습니다.
라이브거래하신것 있으면 알려주세요.
1. 위 테스트 건에 대한 정산일자가 11월 28일이라고 들어서 이 날짜로 정산 조회 API를 호출하였으나 넘어오는 데이터가 없는 상황입니다. 어떤게 문제인지 알 수 있을까요?
2. 라이브거래 건은 확인 후 말씀드리도록 하겠습니다
위 테스트 건은 모두 테스트 거래건이라서
정산 조회 API에 반영이 안됩니다.
테스트 건은 반영이 안된다라는 말씀이 토스에서 취소한 건의 경우만 안된다라는 말씀이신걸까요? 아니면 결제든 토스에서 취소든 사이트 내에서 취소든 모든 테스트 결제 데이터는 정산 조회에 반영이 안된다는 말씀이실까요?
위 건은 현재 테스트 서버에 테스트 정산 데이터로 이해를 하고 있는데 이건 정산 조회 API로 넘어온 것이 아닐까요?
ARIA_20258ac1e6a8248146b6b877914e5a8760c4
ARIA_2025e31a97146bac4d32ad4d2f57fb81edde
ARIA_2025e9ec6442999a44908954e3397a67dff0
ARIA_20252247b10da5c8456bb9dd5b54f69f96ad
ARIA_2025ce0401bd3793401eaa6bd45fd6d75012
ARIA_20253c5961ed825a417291782f3e13ca097f
ARIA_2025dcabb3e049ec4b90a3637fd38fe7e614
ARIA_20252f82c1c58b2a4df7867d390bb7d53521
ARIA_2025bd33ab0789ae43ec95ee0373468cb858
ARIA_2025cf2879f08b3449d49a83f19f25de9890
ARIA_202574c13b04bf624cbe9e58c187cb41e8d4
ARIA_20259d3c857e0d8b4bf5b27c8e264f140
라이브 거래 건 orderId 전달드립니다.
혹시 답변까지 시간이 좀 걸릴까요?
혹시 언제 거래건일까요?
이런식으로 취소거래도 받게 됩니다
수수료 부분은 0000으로 가렸어요
테스트 키로 테스트 하신 거래는 정산 데이터가 아예 생성이 안됩니다.
모든 거래가 다 그래요.
라이브거래에서 샘플링한것처럼 결제일과 취소일의 간격이 있는경우
정산도 두번 발생하는데요
승인내역에 대한 정산은 승인일+1 에 받을 수 있고
취소내역에 대한 정산은 취소일+1에 받게됩니다
ARIA_202583e4b3c026f541039db1b33c0d20003f 2025-09-17 20:00:30.000
ARIA_20253909cdc8fca343ccbf26dfce49534e3f 2025-09-12 19:09:36.000
ARIA_2025ce0401bd3793401eaa6bd45fd6d75012 2025-08-12 11:22:38.000
ARIA_2025dcabb3e049ec4b90a3637fd38fe7e614 2025-08-07 13:12:30.000
ARIA_20252f82c1c58b2a4df7867d390bb7d53521 2025-08-06 00:25:18.000
ARIA_20259d3c857e0d8b4bf5b27c8e264f140138 2025-07-21 14:30:54.000
ARIA_202574c13b04bf624cbe9e58c187cb41e8d4 2025-07-07 09:46:48.000
ARI
결제일시도 함께 전달드립니다
모두 라이브결제이신거죠?
혹시 기존에 결제 XPAY 사용하셨나요?
네
23년, 24년, 25년 모두 토스페이로 하고있었다고 합니다
이 건을 봤을 때 토스에서 직접 취소한 건이라는 걸 알 수 있는 데이터가 있을까요?
추가적으로 토스페이먼츠 개발자센터에서 이 이미지 위치 이외에도 토스 상에서만 취소할 수 있는 다른 취소 프로세스가 있는지도 알 수 있을까요?
밑에 상점관리자 들어가셔서
테스트모드를 켜면
테스트 상점관리자 (이번에 추가된 기능)이 있고 거기서 동일한 업무가 가능합니다.
상점관리자에서 취소하기 기능의 경우도 특별한 플래그를 추가한다거나 그런 거 없이 위에 제가 첨부한 사진에서의 취소하기 기능과 동일한 웹훅으로 데이터가 전송되는걸까요?
말씀하신 대로입니다.
취소경로 (API , 상점관리자 등) 와 관계없이 결제상태가 취소로 변경되면 동일한 웹훅이 발송됩니다.
취소 API 를 사용하는 방법이 있습니다
PG에서는 긴급한 장애상황이 아니라면 가맹점의 결제를 취소하는 일이 없구요
이 말씀은 취소 API로 파라미터를 담아서 저희 서버에서 호출을 해야한다는 말씀이 맞으실까요?
@이 건을 봤을 때 토스에서 직접 취소한 건이라는 걸 알 수 있는 부분이 있을까요?
알 수는 없는데
토스에서 망취소 하는 경우는 거의 결제 이후 n초 이내고
이후에 필요한 경우 귀사에 연락을 드릴거에요
그랗죠
ARIA_202583e4b3c026f541039db1b33c0d20003f 의 경우 17일 정산 API 를 라이브키로 호출해 보시면 아래와 같이 데이터 보입니다.
"approvedAt": "2025-09-17T20:02:51+09:00", "soldDate": "2025-09-17", "paidOutDate": "2025-09-25", 25일이 정산 되는 날이에요.
"approvedAt": "2025-09-17T20:02:51+09:00", "soldDate": "2025-09-17", "paidOutDate": "2025-09-25", 25일이 정산 되는 날이에요.
취소시점을 보면 PG 직권취소가 아닙니다. 가맹점에서 취소하신거에요
취소가능한 경로는
1) 가맹점 자체 관리자 페이지에 취소API 를 연동한경우
2) 결제고객의 mypage 에 취소API 를 연동한 경우
3) 가맹점 내부 직원이 토스페이먼츠 상점관리자에 접속하여 취소를 한 경우
이렇게 있구요, 어떤 내용때문에 무엇을 찾고계신건지를 알려주시면 해결에 도움이 될거같아요
제가 원하는 부분은
저희 사이트가 아닌 토스 내에서 결제 건 취소 시 저희 사이트 소스 내에 정산 조회 API가 적용되어 있다면,
1. 해당 취소 건의 정산 데이터가 제대로 전달 되는지
2. 저희 사이트에서 취소 요청 시에 받는 리턴 데이터들과 동일하게 받아오는지
위 두 사항에 대한 확인이 필요합니다
1. 어디에서 누가 취소하건 정산API 에는 반영이되고 당연히 전달됩니다.
2. 토스페이먼츠 상점관리자에서의 취소는 가맹점의 통신이 아니라서 실시간응답은 아니고 위에 박의원님 말씀처럼 웹훅 수신이 가능합니다. 정산도 반영되구요
토스내에서 결제건 취소시 -- 이 내용의 정확한 의미는 어떤것인가요? 토스페이먼츠 상점관리자 취소도 포함하여 말씀하신건지요
토스페이먼츠 개발자센터 및 상점관리자에서의 취소 건을 확인하고 싶습니다
추가적으로 앞서 보내주신 취소거래 내역 관련하여 제가 직접 확인하는 방법을 알 수 있을까요?
개발자센터는 테스트 거래밖에 없는데 필요하신건가요?
직접확인은 어려우시고 취소시점도 3개월 이상이면 저희쪽 로그도 바로 확인가능하진 않습니다
취소API 는 운영하시나요?
1. 가장 필요한 건 라이브 거래 데이터입니다.
다만, 해당 데이터에 대한 추후 처리 작업이 필요할 수 있어서 테스트 거래도 되면 좋을 것 같다고 생각합니다.
2. 라이브 거래 데이터도 제가 직접 확인이 불가능하다는 말씀이실까요?
3. 취소 API는 https://api.tosspayments.com/v1/payments/" + paymentKey + "/cancel 이 API를 말씀하시는 걸까요?
3. 맞습니다
1, 2 원하시는 내용을 제가 잘 이해를 못하고 있네요
잠깐 통화가능하실까요?
💡 정보 제출
민감 정보를 안전하게 제출해주세요
여기에 전화번호 주시면 전화드릴게요
들어가셨나보군요, 내일 다시 연락주세요
아 어제 퇴근했어가지고 지금 확인했습니다
혹시 오늘 연락 드려도 가능할까요?
네 가능합니다
💡 정보 제출
민감 정보를 안전하게 제출해주세요
전화번호 전달주세요
제출했습니다
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
안녕하세요. 혹시 고객이 결제를 잘못했다던가 등의 휴먼에러 등을 이유로 토스측에 직접 환불을 요구할 경우 상점관리자를 통하지않고 직접 토스 사이트에서 취소가 일어나는 경우가 있을까요?
없습니다.
기본적으로 가맹점 요청으로만 취소 진행합니다.
확인 감사드립니다