구독 결제

상품·할인·고객·구독을 등록해 두면 정해진 주기마다 포트원이 청구와 결제를 대신 처리하는 서비스입니다.

구독 결제란?

구독 결제는 정기결제에 필요한 청구 일정 관리, 금액 계산, 결제 요청, 실패 처리를 포트원이 대신 수행하는 서비스입니다.

상품과 구독을 한 번 등록하는 것만으로 포트원이 결제 주기를 알아서 계산하고, 청구일마다 인보이스를 만들어 고객의 빌링키로 결제합니다.

이미 빌링키로 정기결제를 직접 운영하고 있다면, 보유한 빌링키를 그대로 등록해 구독 결제로 옮겨 올 수 있습니다. 고객이 결제수단을 다시 등록할 필요가 없습니다. 빌링키로 구독 등록하기를 참고해 주세요.

구독 결제는 V2 연동에서만 사용할 수 있으며, 결제수단은 카드 빌링키와 페이팔 빌링키를 지원합니다.

구성 요소	설명
상품	청구 금액과 주기를 정합니다. 정기 상품(`RECURRING`)은 매 주기 청구하고, 일회성 상품(`ONE_TIME`)은 구독의 첫 회차에만 청구합니다. 구독에는 정기 상품이 하나 이상 있어야 합니다.
할인	구독에 붙여 인보이스 금액을 깎습니다. 정률·정액 할인과 적용 회차(한 번·N회·계속)를 정할 수 있습니다.
고객	결제를 받을 고객입니다. 고객마다 빌링키를 하나 가지며 고객의 모든 구독이 이 빌링키로 결제됩니다.
구독	고객과 상품 목록을 묶은 청구 계약입니다. 청구 기준일로부터 상품 주기마다 인보이스가 만들어집니다.
인보이스	회차별 청구서입니다. 청구 시각이 되면 만들어지는 즉시 결제됩니다.

구독 등록 SDK로 시작하기 (권장)

고객사 서버에서 구독을 사전 등록한 뒤, 브라우저에서 구독 등록 SDK(requestSubscriptionRegistration)를 호출합니다. 결제창 한 번으로 결제수단 등록과 첫 회차 결제가 끝나고, 카드를 등록한 시각부터 구독이 시작됩니다.

빌링키로 직접 등록하기

빌링키를 먼저 발급받은 뒤 고객 등록 API와 구독 생성 API로 구독을 만듭니다. 기존 빌링키를 구독 결제로 옮겨 오거나, 청구 시작일을 미래로 정해야 하거나, 구독 등록 SDK를 지원하지 않는 결제대행사를 쓰는 경우 이 방법을 사용합니다.

구독 상태

상태	설명
`INCOMPLETE`	결제수단 등록을 기다리고 있거나(사전 등록) 첫 회차 결제가 실패한 상태입니다. 청구하지 않습니다.
`ACTIVE`	청구 중인 상태입니다.
`PAUSED`	일시중지된 상태입니다. 인보이스 생성과 결제가 없습니다.
`ENDED`	해지 또는 종료일 도달로 끝난 상태입니다. 다시 살릴 수 없습니다.

인보이스 상태

상태	설명
`PENDING`	결제 결과를 확인하고 있는 상태입니다.
`PAID`	결제가 완료된 상태입니다. 0원 청구도 이 상태가 됩니다.
`FAILED`	결제가 실패한 상태입니다. 결제 재시도로 다시 결제할 수 있습니다.
`CANCELED`	청구를 취소한 상태입니다.
`PAID_MANUALLY`	계좌 입금 등으로 대금을 따로 받아 수동 완납 처리한 상태입니다.