정산 조회 API로 "미지급액" 데이터 확인 방법 문의
infinistar, infinistar_b 상점에서 정산 대사 작업을 처리 중입니다.
테스트 중 마이너스 매출이 발생하여 토스측으로부터 "미지급액" 데이터를 정산데이터로 확인하라는 가이드를 받았습니다. (첨부 이미지 참조)
정산데이터는 현재 https://docs.tosspayments.com/reference#정산-조회 API로 매일 수집 중인데,
response에 "미지급액"에 해당하는 key 가 없는 것 같아서,
다른 API를 사용해서라도 "미지급액" 데이터를 얻을 수 있는 방법이 있는지 문의 드립니다.
코어 API | 토스페이먼츠 개발자센터
토스페이먼츠 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
16 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
스크린샷은 Xpay 정산조회의 내용입니다.
docs.tosspayments.com 의 내용은 신모듈 정산API의 내용이구요
정산데이터를 수신하시기위해 어떤 모듈을 사용중이실까요?
문의내용에 있군요, 잠시만요..
안내받으신 내용은 https://docs.tosspayments.com/reference#%EC%A0%95%EC%82%B0-%EC%A1%B0%ED%9A%8C API에서는 지원되지 않는 기능입니다. 문의주신 내용이 꼭 필요하신 것이라면 구모듈 정산조회 신청을 하셔야합니다.
코어 API | 토스페이먼츠 개발자센터
토스페이먼츠 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
아... 그렇군요 구모듈 정산조회 신청 전에
구모듈 정산조회 API 명세를 좀 확인할 수 있을까요?
지금 동작이 신모듈 정산조회 response로 맞춰져 있어서,
대체할 수 있을지 같이써야할지 써드파티랑 논의를 좀 해봐야 될 것 같습니다
네, 이걸 보시면 됩니다.
https://docs.google.com/document/d/1licQFx3fnZG5keaBzP4To0FcLn4ySG8UQd0Ygh_Q8jA/edit?usp=sharing
Google Docs
XPAY[기타]정산조회_일자별_https_v.1.0.3
Xpay-기타-정산조회_일자별_HTTPS Protocol and Core Function Specification Version 1.0.3 2022.09 목차 정산 내역 Http Client 호출 방식 3 조회 Parameter 안내 3 조회 URL 안내 3 헤더 라인 상세 설명 4 데이터라인 상세 설명 5 참고사항 5 Appendix. 거래유형 코드 6 정산 내역 Http Client 호출 방식 Httpclient 방식으로 토스페이먼츠와 호출 파라미터를 약속하고 ...
구모듈과 신모듈간 사용되는 키값의 체계가달라서 일반적으로는 대체가 잘 안되실거에요..수도 있습니다.
일단 위에 전달 받으신 내용의 "지급금액", "미지급금액" 은 헤더에 포함된 정보로 해당일자의 데이터를 의미하고 있어요. 그래서 개별 거래건의 정산대사 데이터는 아닙니다. 따라서 "미지급금액" 에 대한 키 값으로 단건으로 맞추실 때 사용하시는 정보는 아닐꺼에요.
위에 메일로 전달 드린 내용을 내부에서 확인해보니..
미수금 선반영 로직에서 차감된 미수금을 대사 파일에서 확인하시는 용도로 설명 주신거였어서 위 XPay 대사에서 해당일자 정산대사를 긁어가셔서 헤더에 포함된 "미지급금액" 만 참고하시는 용도로 사용할 수 있도록 설명 드린거라고 하네요.
내용은 확인했구요. 스펙 문서는 위에 첨부드린 문서를 확인해주시면 되고,
대사 확인 방법은 본 채널이 공개 채널이어서 위에 문의주셨던 본래 메일에 회신 드릴 수 있도록 하겠습니다.
메일로 내용 전달 드린 후 다시 말씀드릴게요!
넵 감사합니다! 제 생각에도 저희가 매일 정산조회를 하니 헤더에서 해당일자 "미지급액" 만 꺼내오면 될 것 같습니다. 궁금한 점은
1. mertKey 는 어떻게 설정할 수 있을까요?
2. GET 호출 시 live(test) key 가 필요 없을까요?
정도 입니다. 답변 기다리겠습니다!
1. 머트키는 상점관리자에 접속하시면 클라이언트키/시크릿키 확인하시는 메뉴 아래에서 찾아보실 수 있습니다.
2. 신규모듈을 클라이언트키/시크릿키 를 사용하고, XPay는 머트키를 사용합니다.
직접 key 값을 생성하여 대사 링크 주소를 생성하셔도 되고, 바로 호출해보실 수 있도록 대사 링크를 메일로 드릴텐데 날짜만 바꿔서 사용하셔도 됩니다. 편한 방법으로 사용해주시면 되겠습니다.
정리된 내용은 원래 문의 주신 메일로 담당 매니저님이 회신 드릴 예정입니다. 참고 부탁드려요!
넵 감사합니다!
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
머트키와 MD5(상점아이디 + mertKey) 한 key 값 XXXX를 메일로 받았습니다.
확인해 볼 수 있는 URL도 메일로 주셨는데
https://pgweb.tosspayments.com/pg/wmp/outerpage/trxdown.jsp?mertid=infinistar_b&servicecode=ADJ&trxdate=20230907&key=XXXX
"미지급액" 뿐만 아니라 아무 데이터도 반환되지 않는데, 한 번 확인 부탁드립니다
안녕하세요
전달 주신 MID 로 확인 해보았는데,
현재 infinistar, infinistar_b 가 같은 "지급그룹" 으로 묶여 있는 것으로 보입니다.
지급그룹 대표 MID 는 infinistar 로 확인되니
정산대사는 infinistar 로 조회 하시면, 결과로 infinistar 뿐 아니라 infinistar_b 내역까지 확인 가능 하실 겁니다.
만약 MID 별로 나눠서 조회가 필요 하실 경우,
저희측 담당자를 통해 "지급그룹분리" 요청을 해주시면 됩니다.
단, 지급그룹분리 로 인한 충분한 설명도 저희측 담당자를 통해서 전달 받으신 이후에, 내부 논의 완료 되시고 진행 해주시면 좋을것 같습니다.
넵 우선 이대로 작업하겠습니다.
지급그룹분리는, 이대로 반영되면 코드에 혼선이 생겨서 분리를 해야 하는데
이 건은 별도 쓰레드나 메일로 다시 문의 드리도록 하겠습니다.
prod / preprod 환경 분리 때문에 혹시 mertKey 가 test / live 로 나눠져 있는지 마지막으로 확인 부탁 드리겠습니다.
제가 상점관리자 권한이 없어서 확인이 안되어서
만약 나눠져 있다면 메일로 공유해 주시면 감사하겠습니다. 🙏
mertKey 는 테스트, 운영 동일합니다
아 그렇군요 잘 알겠습니다
지금까지 지원에 감사드립니다!