워크플로우
공급자 등록
고객 생성 API를 호출하여 공급자 정보를 볼타에 등록합니다. 등록 후 발급되는
customerKey를 저장합니다.인증서 등록 URL 발급
인증서 등록 URL 조회 API를 호출하여 공급자가 인증서를 등록할 수 있는 URL을 발급받습니다.
역발행 요청
역발행 API를 호출합니다.
Customer-Key 헤더에 공급자의 customerKey를 전달합니다.승인 URL 획득
승인 URL 조회 API를 호출하여 승인 페이지 URL을 발급받습니다. 생성된 URL은 10분간 유효합니다.
발행 완료 웹훅 수신
승인이 완료되면 웹훅으로
taxInvoiceUrl이 포함된 알림이 전송됩니다.세금계산서 조회 (선택)
세금계산서 조회 API로 발행 결과를 확인합니다.
역발행 요청 취소
승인 전이라면 요청 취소 API를 호출하여 역발행 요청을 취소할 수 있습니다.- 정상 취소 시 HTTP 200과 함께 응답이 반환됩니다.
- 이미 승인/취소/발행된 경우에는 에러가 반환됩니다.
적합한 경우
- 플랫폼 UX 안에서 승인 프로세스를 완결하고 싶은 경우
- 공급자가 이미 인증서를 등록한 상태인 경우
- 실시간으로 승인 상태를 추적해야 하는 경우
이메일 승인 역발행과의 차이
| 이메일 승인 | 간편 승인 | |
|---|---|---|
| 승인 방식 | 볼타가 보낸 이메일 링크 | 플랫폼이 발급한 승인 URL |
| 인증서 필요 | 불필요 | 필요 |
| UX 제어 | 볼타에 위임 | 플랫폼이 직접 제어 |
| URL 유효시간 | - | 10분 |
