페이 스튜디오 · 정기결제 목록 조회

정기결제 목록 조회

생성일 기준으로 정기결제 목록을 조회하는 API입니다.

인증이 필요한 요청에는 Accesskey · Secretkey 헤더를 첨부합니다. 공통 응답 형식과 에러 코드는 빠른 시작을 참고하세요.

GET /pay/v1/billings

정기결제 목록 조회

생성일 기준으로 정기결제 목록을 조회하는 API입니다.

요청 파라미터

이름	타입	필수	기본값	조건	설명
`sdate`	date	선택	`오늘-92일`	YYYY-MM-DD, 최대 3개월	조회 시작일입니다.
`edate`	date	선택	`오늘`	YYYY-MM-DD, 최대 3개월	조회 종료일입니다.
`is_active`	boolean	선택	-	-	조회할 정기결제 사용 여부입니다. true면 사용 중, false면 정지(해지)만 조회합니다.
`card_registered`	boolean	선택	-	-	카드 등록 완료 여부입니다. true면 등록 완료, false면 미등록만 조회합니다.
`page`	integer	선택	`1`	1 이상	페이지 번호입니다.
`cnt`	integer	선택	`20`	1~20	페이지당 목록 개수입니다.

응답 파라미터

이름	타입	설명
`traceId`	string	요청 추적 ID입니다.
`code`	string	응답 코드입니다. 성공은 000000입니다.
`message`	string	응답 메시지입니다.
`sdate`	date	조회 시작일입니다.
`edate`	date	조회 종료일입니다.
`page`	integer	현재 페이지입니다.
`maxpage`	integer	마지막 페이지입니다.
`cnt`	integer	반환 기준 개수입니다.
`total`	integer	전체 정기결제 수입니다.
`items` 20개 필드	array	정기결제 목록입니다.
`key`	string	정기결제 key입니다.
`is_active`	boolean	정기결제 사용 여부입니다. true면 사용 중, false면 정지(해지) 상태입니다.
`bill_url`	string	고객에게 전달할 정기결제 안내 링크입니다.
`card_url`	string	카드 등록/수정 화면 링크입니다.
`goods_name`	string	정기결제 상품명입니다.
`amount`	integer	정기결제 금액입니다.
`cycle`	string	정기결제 주기입니다. `MONTHLY`—매월 `WEEKLY`—매주
`cycle_name`	string	정기결제 주기명입니다.
`billing_days`	array	정기결제일 목록입니다.
`buyer_name`	string	고객명입니다.
`buyer_phone`	string	고객 휴대폰 번호입니다.
`buyer_email`	string	고객 이메일입니다.
`pay_start_dttm`	datetime	정기결제 시작일시입니다.
`pay_end_dttm`	datetime	정기결제 종료일시입니다.
`card_registered`	boolean	카드 등록 완료 여부입니다.
`card_no`	string	카드번호 표시값입니다.
`card_name`	string	카드명입니다.
`card_kind`	string	카드 종류입니다.
`create_dttm`	datetime	생성일시입니다.
`update_dttm`	datetime	수정일시입니다.

요청 예시

예시 생성 중…

응답 예시 성공

{
  "traceId": "9f2c1a7b-4e0d-4b1a-8c2e-1f3a5d7b9c0e",
  "code": "000000",
  "message": "성공",
  "sdate": "2026-03-16",
  "edate": "2026-06-16",
  "page": 1,
  "maxpage": 1,
  "cnt": 20,
  "total": 1,
  "items": [
    {
      "key": "f1e2d3c4b5a6978869aa",
      "is_active": true,
      "bill_url": "https://www.doublestudio.co.kr/share/bill/f1e2d3c4b5a6978869aa/",
      "card_url": "https://www.doublestudio.co.kr/share/bill/card/f1e2d3c4b5a6978869aa/",
      "goods_name": "월 유지보수",
      "amount": 110000,
      "cycle": "MONTHLY",
      "cycle_name": "매월",
      "billing_days": [
        25
      ],
      "buyer_name": "홍길동",
      "buyer_phone": "01012345678",
      "buyer_email": "pay@example.com",
      "pay_start_dttm": "2026-06-16 00:00:00",
      "pay_end_dttm": null,
      "card_registered": false,
      "card_no": "",
      "card_name": "",
      "card_kind": "",
      "create_dttm": "2026-06-16 10:00:00",
      "update_dttm": "2026-06-16 10:00:00"
    }
  ]
}