토스 정산 API 소개
토스 결제 서비스를 통한 매출과 정산 금액 확인을 위한 API입니다.
페이징 개념이 적용되며, 페이징 단위는 1,000건입니다. 다음 페이징이 존재하면 nextCursor라는 응답값이 리턴되며, 이를 포함하여 호출하면 다음 페이징 데이터를 얻을 수 있습니다.
용어
| 용어 | 정의 |
|---|---|
| 지급일 | 결제 금액을 가맹점의 결제 계좌로 입금한 날입니다. |
| 거래 승인일 | 결제, 환불 등 거래가 실제로 일어난 날입니다. |
정산 API 조회 시 유의사항
- 정산 API는 승인일 기준 D+1일 06:00경에 DW에 참조 테이블 적재가 완료됩니다.
- 따라서 06:00 이후 호출해야 누락 없이 전체 데이터를 조회할 수 있습니다.
- 단, 06:00 직후에는 데이터 수집이 진행 중일 수 있어 응답이 지연되거나 실패할 수 있습니다.
- 이 경우에는 오후 시간대에 재조회하실 것을 권장드립니다.