Payment
결제 히스토리 목록 조회
사용자의 결제 내역을 기간별로 조회합니다. 결제 상태, 금액, 결제 수단 등의 정보를 페이징 방식으로 확인할 수 있습니다.
get/v2/payment/payment-histories
Query parameters
pagenumber nullable
Example:1
페이지 번호
limitnumber nullable
Example:20
한 번에 조회할 결제 내역의 개수입니다. 기본값은 10개이며, 너무 큰 값을 설정하면 응답 속도가 느려질 수 있습니다.
startDatestring date-time nullable
Example:2024-01-01
조회할 기간의 시작일입니다. 미지정시 최근 30일부터 조회됩니다.
endDatestring date-time nullable
Example:2024-12-31
조회할 기간의 종료일입니다. 미지정시 현재 날짜까지 조회됩니다.
Response
결제 히스토리 목록 조회 요청의 처리 결과입니다. 결제 내역 목록과 페이징 정보가 포함됩니다.
Example response
{
"data": {
"histories": [
{
"id": 12345,
"amount": 50000,
"proofDocumentId": "doc_123456",
"memo": "추가 할인 적용됨",
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T10:30:00Z",
"expiredAt": "2024-02-15T10:30:00Z"
}
],
"totalCount": 1250,
"totalPages": 63,
"currentPage": 1,
"hasNextPage": true
}
}