문서 변환 내장
PDF는 그대로 처리하고, DOCX는 검증된 변환 경로를 사용합니다. HWPX는 beta 경로로 변환한 뒤 서명 좌표를 적용합니다.
API-First Electronic Signature Infrastructure
외부 서비스가 붙는 전자서명 인프라
SignPlug는 자체 전자계약 화면을 만드는 SaaS가 아니라, 고객사 플랫폼이 API와 webhook으로 붙어서 전자서명 흐름을 내장하는 백엔드 중심 제품입니다.
입력 형식
PDF / DOCX / HWPX beta
본인확인
SMS OTP
과금
문서당 500원
지원 정책
PDF 업로드를 권장합니다. DOCX는 정식 지원하며, HWPX는 현재 beta / best-effort로 제공합니다.
Direct Create
웹에서 바로 계약 생성
API 통합 없이도 문서를 업로드하고 참여자와 서명 좌표를 입력해 바로 계약을 만들 수 있습니다. 현재는 계정 구분을 위해 API Key를 직접 넣는 운영자용 생성 폼으로 제공합니다.
생성 결과
`document_id`, 상태, 만료 시간, 참여자별 서명 링크를 여기서 바로 확인할 수 있습니다.
아직 생성된 문서가 없습니다.
운영 메모
이 생성 폼은 현재 API Key 보유 운영자를 위한 최소 UI입니다. 사용자 계정/대시보드 기반 관리 콘솔은 아직 포함하지 않습니다.
현재 생성 API 기준으로 참여자 휴대폰 번호는 필수입니다. OTP를 끄더라도 전화번호를 함께 입력해야 합니다.
Core Features
MVP에 필요한 축만 먼저 구현
좌표 기반 필드
고정 양식 문서에 맞춰 API에서 `signature`, `name`, `date` 필드를 페이지 좌표로 지정합니다.
토큰 기반 공개 서명
로그인 없이 링크로 진입하고, 문서 확인 뒤 OTP 검증과 캔버스 서명을 수행합니다.
Audit Log / Hash
문서 생성, 열람, 검증, 서명, 완료 이벤트와 SHA256 해시를 저장합니다.
Webhook 전송
고객사가 등록한 endpoint로 완료 이벤트를 HMAC 서명과 함께 전달하고 재시도합니다.
test / live 분리
API Key 환경 분리, test 비차감, live 차감 정책으로 개발과 운영을 구분합니다.
Process
계약 생성부터 완료 webhook까지
1. 문서 생성
고객사 플랫폼이 파일, 참여자, 좌표 필드를 넣어 `POST /documents`를 호출합니다.
2. 변환 및 토큰 발급
PDF는 즉시 대기 상태로, DOCX는 검증된 worker 변환 후 진행합니다. HWPX는 best-effort 변환 후 참여자별 signing link를 발급합니다.
3. 사용자 서명
사용자는 링크로 들어와 PDF 확인, 이름 입력, SMS OTP 검증, 동의, 캔버스 서명을 진행합니다.
4. 최종 PDF 생성
모든 서명자가 완료되면 서명 이미지와 이름/날짜가 삽입된 최종 PDF를 생성합니다.
5. 완료 이벤트
audit log, 해시 저장 후 webhook으로 `document.completed`를 전송합니다.
API Surface
외부 플랫폼이 바로 붙는 구조
핵심 엔드포인트
- `POST /signplug/v1/documents`
- `GET /signplug/v1/documents/:documentId`
- `GET /signplug/v1/documents/:documentId/pdf`
- `GET /signplug/v1/documents/:documentId/audit-log`
- `DELETE /signplug/v1/documents/:documentId`
- `GET /signplug/v1/credits`
- `POST /signplug/v1/webhooks`
공개 서명 엔드포인트
- `GET /public/signing-links/:token`
- `GET /public/signing-links/:token/pdf`
- `POST /public/signing-links/:token/otp/request`
- `POST /public/signing-links/:token/otp/verify`
- `POST /public/signing-links/:token/signature`
Runtime Layout
포털과 런타임을 분리한 구조
`moram.net/signPlug`
signplug-web
제품 소개, 도입 메시지, 구조 설명
`api.moram.net/signplug`
signplug-api
문서 생성, 상태 조회, credits, webhook 등록
`sign.moram.net/signplug`
signplug-sign
OTP, PDF 뷰어, 서명 UI
`worker`
signplug-worker
문서 변환, webhook delivery/retry, 배치 처리
Pricing
초기 정책은 단순하게
문서 1건
서명자 수와 무관하게 생성 성공 기준 차감
500원
test 환경은 비차감, live 환경은 선불 크레딧에서 차감합니다.
FAQ
지금 단계에서 중요한 질문
이 제품은 전자계약 SaaS인가?
아닙니다. 자체 사용자를 모으는 SaaS보다는 외부 서비스가 붙는 전자서명 인프라에 가깝습니다.
HWPX도 바로 지원되는가?
현재 HWPX는 LibreOffice 기반 beta / best-effort 지원입니다. 파일 생성 경로와 API 흐름은 준비되어 있지만, 품질 민감 문서는 PDF 업로드를 권장합니다.
중요 문서는 어떤 형식을 권장하나?
현재 운영 정책상 PDF 업로드를 가장 권장합니다. DOCX는 정식 지원하며, HWPX는 호환성 차이가 있을 수 있어 beta로 안내합니다.
본인확인은 어떤 방식인가?
MVP는 SMS OTP입니다. PASS 인증은 이후 확장 범위입니다.
Webhook은 어떤 구조인가?
이벤트별 등록 endpoint에 JSON payload를 보내며, worker가 HMAC-SHA256 서명과 retry/backoff를 처리합니다.