토스페이 연동가이드

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

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

POSThttps://pay.toss.im/api/v2/settlement-details

apiKeystring필수

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

dateTypestring필수

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

baseDatestring필수

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

nextCursorstring

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

payMethodstring

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

가능한 값:

TOSS_MONEYTOSSPAY_MONEYCARDACCOUNTRESELLER_CARDBNPL

transactionListSettlementTransaction[]

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

nextCursorstring

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

totalAmountinteger (int64)

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

totalFeeinteger (int64)

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

totalVatinteger (int64)

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

totalFeeVatSuminteger (int64)

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

정산 API