토스페이 연동가이드

지급일 또는 거래 승인일 기준으로 정산 상세 내역을 조회합니다.

각 API 응답 필드와 에러코드는 사전 공지 없이 추가되거나 변경될 수도 있으니, 추가된 항목으로 인해 오류가 발생하지 않도록 처리에 유의해 주시기 바랍니다.

POST

apiKeystring필수

가맹점 API Key. Test API Key도 입력은 가능하나 테스트 결제는 실제 지급되지 않으므로 정산 대상이 아닙니다.

dateTypestring필수

기준 날짜의 형태. DUE: 지급일 (정산 계좌에 입금된 날짜), SETTLE: 거래 승인일 (결제 시점의 날짜)

baseDatestring필수

조회하고자 하는 날짜 (yyyyMMdd 형식). 승인일 기준 최대 1년까지 조회 가능하며, 당일 자 데이터 조회는 제한됩니다.

nextCursorstring

페이징 cursor 값. 파라미터가 추가되지 않으면 첫 페이징 데이터가 리턴됩니다.

payMethodstring

조회하고자 하는 결제수단. 보내지 않거나 null로 보내면 모든 결제수단에 대해 응답. TOSS_MONEY: 토스머니, CARD: 카드

가능한 값:

TOSS_MONEYCARD

transactionListSettlementTransaction[]

정산 내역 리스트 (최대 1000개)

nextCursorstring

커서 값. 다음 페이징 데이터가 있으면 커서 값을 반환, 마지막 페이징일 경우 빈 스트링을 반환

totalAmountinteger (int64)

총 금액 합산. 조회된 전체 건의 총 금액 합산

totalFeeinteger (int64)

총 수수료 합산. 조회된 전체 건의 총 수수료 합산

totalVatinteger (int64)

총 부가세 합산. 조회된 전체 건의 총 부가세 합산

totalFeeVatSuminteger (int64)

총 수수료 + 부가세 합산 (totalFee + totalVat)

정산 API