최재형•2y ago

정산 데이터 조회 문의

안녕하세요. 고생하십니다. 토스 정산 데이터를 저희 자사 서버에 동기화를 해야 하는 요구사항이 있습니다. 기존 정산 및 지급까지 나간 건이 결제 취소건에 대한 상태 처리를 해야할 것 같은데요. 정산 도메인이 처음이라 조금 막막해서 질문드립니다; 저번 달, 아니면 저번주 정산 된 데이터가 결제가 취소 되었을 경우 , 어떻게 데이터를 조회해가야할지... 방법이 있을까요? 그 결제건의 상태가 변경돼서 결제가 발생했던 해당 날짜 범위를 지정해서 조회해야하는 건지 취소가 되면 취소가 발생한 시점인 날, 즉 매일 매일 하루씩 땡겨가도 되는 건지 궁금합니다. 감사합니다.

30 Replies

토스페이먼츠 BOT•2y ago

⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다

오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.

- 주문번호(orderId) : - 문의 내용 :

(img를 함께 첨부해주시면 도움이됩니다)

* 계약관련 내용은 1544-7772로 문의주세요. * 주말/공휴일에는 답변이 늦을 수 있어요.

김차장•2y ago

매일 매일 하루씩 땡겨가셔도 됩니다. 운영측면에서는 그렇게 하시는것이 더 자연스럽구요. 결제 당일을 D라고 했을때 취소가 D에 발생했다면 제로섬으로 상관이 없지만 취소가 D+1 에 발생했다면 정산조회API는 D+2에 반영된 내용을 확인하실 수 있어요

최재형OP•2y ago

아! 감사합니다. 데이터를 동기화하는 목적에서 이전 정산데이터를 조회해서 싱크를 맞출 상황같은게 있을까요?

Kimoon Lee•2y ago

아뇨 없습니다. 이전 거래건이 취소 되더라고 취소 행위는 어제이므로 어제 정산데이터에 보입니다.

최재형OP•2y ago

배치 작업이 당일 D라고 했을때 D-1의 데이터를 동기화를 하면, 동기화 후에는 전날 데이터는 변동되지 않는다. D-1에 결제 후 D에 취소가 된 경우 D+2인 다음날 데이터에 반영된다.로 이해했는데요 맞을까요?

Kimoon Lee•2y ago

D에 취소가 되면 D 에 반영이 되고, D+1에 D의 데이터를 가져가실수 있습니다.

최재형OP•2y ago

감사합니다. 연말 잘 보내세요~!

토스페이먼츠 BOT•2y ago

❤️ 기술문의 경험이 어떠셨나요?!

간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.

최재형OP•2y ago

안녕하세요. 고생하십니다. 다름이 아니라 Settlement fees 프로퍼티를 확인해보면 BASE: 기본 수수료 INSTALLMENT_DISCOUNT: 카드사 혹은 토스페이먼츠가 부담하는 무이자 할부 수수료 INSTALLMENT: 상점이 부담하는 무이자 할부 수수료 POINT_SAVING: 카드사 포인트 적립 수수료 ETC: 기타 수수료 타입과 수수료 금액인 fee 를 들고 있는데 fee의 금액은 supplyAmount + vat 의 금액이 합산된 금액이 나오는 것 같은데 토스 정산내역 페이지에서 PG 수수료 일반 필드에 supplyAmount의 값이 표기되고 있는 것 같더라구요 기타 수수료가 들어간 결제건을 확인을 못해서 질문 드립니다...

{
    // ...
    "method": "간편결제",
    "fees": [
        {
            "type": "BASE",
            "fee": 7586 // <<
        }
    ],
    "easyPay": {
        "provider": "카카오페이",
        "amount": 209000,
        "discountAmount": 0
    },
    "amount": 209000,
    "interestFee": 0,
    "fee": 7586, // << backward compatibility
    "supplyAmount": 6896, // <<
    "vat": 690, // << 
    "payOutAmount": 201414
}

{
    // ...
    "method": "간편결제",
    "fees": [
        {
            "type": "BASE",
            "fee": 7586 // <<
        }
    ],
    "easyPay": {
        "provider": "카카오페이",
        "amount": 209000,
        "discountAmount": 0
    },
    "amount": 209000,
    "interestFee": 0,
    "fee": 7586, // << backward compatibility
    "supplyAmount": 6896, // <<
    "vat": 690, // << 
    "payOutAmount": 201414
}

PG 수수료를 표기할 때 토스 정산내역의 그리드와 유사하게 표기하려면 fees에서 vat을 뺀 금액을 표기해주어야 하는 건가요?

Kimoon Lee•2y ago

토스정산 내역에 PG 수수료 일반 필드는 fee 의 금액을 표시합니다. 왜 supplyAmount 값이 표시된다고 생각하시는 건가요? 혹시 어떤 부분을 보신건지 확인부탁드립니다.

Kimoon Lee•2y ago

최재형OP•2y ago

위의 JSON 데이터를 보시면 7586이 있는데

최재형OP•2y ago

PG수수료 탭의 경우 6,896인지라 fee의 type이 base가 일반 수수료가 아닌건가요?

Kimoon Lee•2y ago

네 PG 수수료 합에 표시 되는데 PG 수수료 탭에 있는 값이 필요하신 건가요?

최재형OP•2y ago

네 맞습니다

Kimoon Lee•2y ago

정산 대사 에서는 각 세부 수수료 별 VAT 제외 금액을 보내드리지는 않고 있습니다.

최재형OP•2y ago

아, 그러면 Fee의 총합은 vat까지 합쳐서 type별로 내려오고 합산 시 PG수수료 합을 만들 수 있는거죠?

Kimoon Lee•2y ago

네 맞습니다.

최재형OP•2y ago

알겠습니다 감사합니다!! 새해 복 많이 받으세요

Kimoon Lee•2y ago

네 감사합니다.

최재형OP•2y ago

안녕하세요... 정산내역을 동기화하고 있는데,,, 입금 정산액이라는 부분이 정산 내역 조회 API에서는 제공되지 않네요 ㅜㅜ 토스페이먼츠 내 상점의 정산내역에서는 (payableAmount) 라는 필드인 것 같은데 이 부분을 어떤 근거로 저희가 만들어 낼 수 있을까요?

Kimoon Lee•2y ago

현재 실제 입금정산액은 API 로 제공해 드리지 않고 있습니다. 일반적으로 정산한도에 걸렸다거나 특정 사유에 의해 지급이 되지 않는 경우를 제외하면 해당 알지의 입금액을 모두 더하면 입금정산액이 되긴합니다. 이부분은 API 에 추가가 가능 할지 논의중입니다.

최재형OP•2y ago

상점 아이디 cjsmarsh2q 정산액 입금일 기준으로 봤을때 2024-01-02 당일 정산액 201,414 인데요 실제 입금 정산액이란 부분에 기입된 날짜는 2024-01-08 기준에 201,414가 붙어있는데 이게 어떤 상황인지 알 수 있을까요?

Kimoon Lee•2y ago

보시면 12월 내내 미입금 정산액이 33만원정도 있었습니다. 1월 8일 201,414 는 뭔가 다른 특정 이벤트 때문에 처리가 된것 같은데요 이부분은 1544-7772로 문의 주셔야 할것 같습니다.

토스페이먼츠 BOT•2y ago

토스페이먼츠 결제연동팀

빠르고 정확한 결제연동 경험을 위해, 디스코드에서는 기술 문의만 받고 있습니다. 계약 및 운영 관련 문의는 1544-7772나 홈페이지 상담을 이용해주세요. 감사합니다.

최재형OP•2y ago

감사합니다 안녕하세요 또 문의가 있어서... 남기게 되었습니다 새벽 1시 15분에 싱크가 돌아서 전날 정산 자료를 수집하였으나 실제 수집되지 않고, 오후 5시 경 다시 시도해보니 전날 정산 자료를 수집하면 정산 데이터가 수집되었다고 전달받았습니다. 전날 정산 자료를 조회하려면 언제부터 가능한건가요?

김차장•2y ago

전날 정산자료는 익일 09:00 이후에 확인하시면 됩니다.

최재형OP•16mo ago

감사합니다 안녕하세요 고생하십니다. 혹시 API 개별 연동키 테스트 키를 가지고 테스트 결제 건에 대한 정산 조회는 불가능한가요? 정산 조회를 시도해봤는데 빈 배열이 넘어오고 있습니다

유부장•16mo ago

테스트 환경에서는 정산 관련 기능 테스트는 불가 합니다. https://docs.tosspayments.com/guides/get-started/preparations#%ED%85%8C%EC%8A%A4%ED%8A%B8-%ED%99%98%EA%B2%BD-%EC%A3%BC%EC%9D%98%EC%A0%90

연동 준비하기 | 토스페이먼츠 개발자센터

토스페이먼츠 연동을 준비하는 가이드입니다. 회원가입, API 키 발급, 지원 환경 등 연동을 시작하기 전에 꼭 알아야 할 정보를 알아보세요.

최재형OP•16mo ago

감사합니다 문서를 놓쳤었네요

정산 데이터 조회 문의

Did you find this page helpful?