서명 진행 시퀀스

생성부터 완료까지 내 서버 ↔ 팩터리 ↔ 서명자 사이의 호출과 이벤트 순서입니다.

내 서버                  Pactery                    서명자
   │  POST /documents       │                          │
   │ ──────────────────────▶│  doc(draft)              │
   │  PUT  /fields          │                          │
   │ ──────────────────────▶│                          │
   │  POST /participants    │                          │
   │ ──────────────────────▶│                          │
   │  POST /send            │                          │
   │ ──────────────────────▶│   서명 링크 + 문자        │
   │                        │ ────────────────────────▶│
   │   webhook: document.sent                          │
   │ ◀──────────────────────│                          │
   │                        │      링크 진입(열람)      │
   │                        │ ◀────────────────────────│
   │   webhook: document.viewed                        │
   │ ◀──────────────────────│   PIN 발송/검증 → 서명    │
   │                        │ ◀───────────────────────▶│
   │   webhook: participant.signed                     │
   │ ◀──────────────────────│                          │
   │   webhook: document.completed (모든 서명 끝)       │
   │ ◀──────────────────────│                          │
   │  GET /documents/{id}/file?audit=true              │
   │ ──────────────────────▶│  완료 PDF + 감사추적     │

포인트

• 발송 이후의 진행은 웹훅이 주도합니다. 폴링은 보조 수단으로만 쓰세요.
• 서명자가 여러 명이고 signing_order가 있으면 participant.signed → 다음 사람 발송 → … 이 반복됩니다.
• document.completed를 받은 뒤 최종 PDF를 받아 보관하면 한 사이클이 끝납니다.