> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bolta.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 정기 결제 (SaaS)

> SaaS 구독 서비스에서 정기적으로 세금계산서를 자동 발행하는 워크플로우입니다.

SaaS 구독, 월간 서비스 등 정기 결제가 발생할 때 세금계산서를 자동으로 발행하는 시나리오입니다.

## 워크플로우

<Steps>
  <Step title="발급자 등록" icon="code">
    [발급자 등록 API](/api-reference/issuer/register-issuer)로 자사를 등록하고 `issuerId`를 저장합니다.
  </Step>

  <Step title="공동인증서 등록" icon="shield-check">
    정발행에 사용할 자사의 공동인증서를 등록합니다. 볼타 웹에서 직접 등록하거나, `issuerId`로 [인증서 등록 URL 조회 API](/api-reference/certificate/retrieve-issuer-certificate-registration-url)를 호출할 수 있습니다.
  </Step>

  <Step title="정기 발행 실행" icon="code">
    결제 스케줄러가 트리거되면 [정발행 API](/api-reference/tax-invoice-issuance/issue-tax-invoice)를 호출합니다. `Bolta-Client-Reference-Id`에 결제 ID와 시도 번호를 조합해 넣으면 같은 발행 시도의 중복 요청을 막고 처리 상태를 추적합니다. 요청자 관리번호는 [인증 가이드](/docs/api-introduction/authentication#client-reference-id)를 참고하세요.
  </Step>

  <Step title="발행 완료 웹훅 수신" icon="zap">
    발행이 완료되면 볼타가 [웹훅](/docs/api-introduction/webhook-tax-invoice)으로 `taxInvoiceUrl`이 담긴 알림을 보냅니다.
  </Step>

  <Step title="발행 완료 이메일" icon="mail">
    볼타가 구독자에게 세금계산서 수신 안내 이메일을 자동으로 보냅니다.
  </Step>

  <Step title="세금계산서 조회 (선택)" icon="search">
    [세금계산서 조회 API](/api-reference/tax-invoice-retrieval/retrieve-tax-invoice) 또는 [관리번호 조회 API](/api-reference/tax-invoice-retrieval/retrieve-tax-invoice-by-client-reference)로 발행 결과를 확인합니다.
  </Step>
</Steps>

## 적합한 경우

* SaaS 구독 서비스에서 월/연 단위로 자동 청구하는 경우
* 정기 납품, 유지보수 계약 등 반복 거래가 발생하는 경우
* 스케줄러 기반 자동 발행이 필요한 경우

## 구현 팁

* 결제 시스템의 스케줄러와 연동하여 결제 완료 시 자동 발행
* 응답을 받지 못한 경우 같은 요청을 다시 보내지 않고 관리번호 조회 API로 접수 결과 확인
* 발행 실패 웹훅을 받은 뒤 새 발행을 요청할 때는 새 `Bolta-Client-Reference-Id` 사용


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.