여러 명 순서대로 서명

한 문서에 여러 명이 서명해야 할 때 서명 순서를 정해 보냅니다. 앞 사람이 서명을 마쳐야 다음 사람에게 서명 요청이 전달되고, 우리 서비스는 웹훅으로 서명이 진행될 때마다 알림을 받아 지금 누구 차례인지 확인할 수 있습니다. 거래처가 먼저 서명하고 회사가 마지막에 서명하는 계약에 많이 씁니다.

한눈에 보는 흐름

우리 서비스가 서명 순서를 정해 서명 요청을 보내면 거래처가 먼저 서명하고, 웹훅으로 차례가 회사 담당자에게 넘어간 것을 확인한 뒤 회사 담당자가 서명해 계약이 체결되는 흐름

이런 경우에 맞습니다

  • 거래처가 먼저 서명하고 회사 대표나 담당자가 마지막에 서명(날인)하는 경우
  • 미성년자 본인과 법정대리인이 함께 서명하는 경우
  • 학생과 보호자, 신청자와 기관 담당자처럼 역할이 다른 사람이 차례로 서명하는 경우
  • 플랫폼 이용자 양쪽이 모두 서명해야 계약이 성립하는 경우

준비할 것

어디서준비할 것
모두싸인API를 쓸 수 있는 요금제, API Key, 서명자 역할과 순서를 정해 둔 템플릿(요청할 때 순서를 정한다면 없어도 됩니다)
우리 서비스서명자별 이름과 연락처, 서명 진행 알림을 받을 웹훅 주소(https), 회사 담당자가 우리 서비스 안에서 서명한다면 서명 화면을 띄울 화면

서명 순서를 정하는 두 가지 방법

방법이렇게 동작합니다
템플릿에 순서 정해 두기템플릿에서 서명자 역할(예: 거래처, 회사)과 순서를 정해 두고, 템플릿으로 서명 요청 API에서 역할마다 서명자를 지정합니다. 같은 계약을 반복해서 보낼 때 씁니다.
요청할 때 순서 지정하기서명 요청 API에서 서명자마다 signingOrder(1~30)로 순서를 지정합니다. 모든 서명자를 1로 지정하면 순서 없이 동시에 서명 요청이 전달됩니다.

연동 흐름

아래는 거래처가 먼저 서명하고 회사 담당자가 마지막에 서명하는 흐름입니다.

sequenceDiagram
    autonumber
    participant S as 우리 서비스
    participant M as 모두싸인
    participant A as 거래처
    participant B as 회사 담당자
    Note over S: 계약 체결이 확정됨
    S->>M: 서명 요청 (서명 순서: 거래처 → 회사)
    M->>A: 카카오톡·이메일로 서명 요청 전달
    A->>M: 계약서 확인 후 서명
    M-->>S: 서명 입력 알림 (웹훅)
    M->>B: 다음 차례에게 서명 요청 전달
    B->>M: 계약서 확인 후 서명
    M-->>S: 서명 완료 알림 (웹훅)
    S->>M: 문서 상태 확인
    Note over S: 계약 체결 처리
  1. 서명 요청: 서명 순서를 정해 서명 요청을 보냅니다. 템플릿을 쓰면 템플릿에 정해 둔 순서를 따르고, 서명 요청 API를 쓰면 서명자마다 signingOrder로 순서를 지정합니다.
  2. 첫 번째 서명자에게 전달: 모두싸인이 첫 번째 순서의 서명자에게만 서명 요청을 보냅니다.
  3. 서명: 첫 번째 서명자가 계약서를 확인하고 서명합니다.
  4. 서명 입력 알림: 서명자가 서명할 때마다 우리 서비스의 웹훅 주소로 document_signed 이벤트가 전달됩니다. 이 알림에는 누가 서명했는지 담겨 있지 않으므로, 문서 상세 조회의 signings(서명한 참여자와 시간)와 currentSigningOrder(지금 차례)로 진행 상황을 확인합니다.
  5. 다음 차례에게 전달: 앞 사람이 서명을 마치면 모두싸인이 다음 순서의 서명자에게 서명 요청을 보냅니다.
  6. 서명: 마지막 서명자가 서명합니다.
  7. 서명 완료 알림: 모든 서명이 끝나면 document_all_signed 이벤트가 전달됩니다. 마지막 서명자가 서명할 때는 document_signed 이벤트가 오지 않고 이 이벤트만 옵니다.
  8. 상태 확인: 문서 상세 조회로 상태를 확인하고 계약 체결 처리를 진행합니다.
💡

회사 담당자는 우리 서비스 안에서 서명하게 하려면

회사 담당자를 임베디드 보안 링크(SECURE_LINK)로 지정하면 이메일·카카오톡으로 받지 않고 우리 서비스 화면에서 서명할 수 있습니다. document_signed 알림을 받은 뒤 currentSigningOrder로 회사 담당자의 차례인지 확인하고, 임베디드 서명자의 보안링크 조회 API로 서명 화면을 열어 줍니다. 자세한 방법은 우리 서비스 화면 안에서 서명을 참고하세요.

🚧

앞 사람이 서명하지 않으면 다음 사람에게 넘어가지 않습니다

서명 순서가 정해진 문서는 앞 사람이 서명을 마치기 전까지 다음 서명자에게 서명 요청이 전달되지 않습니다. 앞 서명자의 서명이 늦어지면 서명 요청 알림 재전송 API로 다시 알리세요. 앞 서명자가 입력한 내용이 잘못됐다면 서명내용 수정요청 API로 고쳐 달라고 요청할 수 있습니다.

💡

서명자 수가 상황마다 달라진다면

미성년자일 때만 법정대리인이 서명하는 것처럼 서명자 수가 달라지는 계약은, 템플릿 하나에 모든 서명자 역할을 넣어 두고 템플릿으로 서명 요청 API의 participantMappings에서 필요 없는 서명자를 excluded로 빼면 됩니다. 뺀 서명자의 입력란은 문서에서 함께 빠집니다. 서명자 구성에 따라 계약서 양식 자체가 달라진다면 템플릿을 나눠 두고 조건에 맞는 템플릿을 골라 요청합니다.

사용하는 API

사용하는 API·기능용도
템플릿으로 서명 요청템플릿에 정해 둔 순서대로 역할마다 서명자를 지정해 보냅니다.
서명 요청서명자마다 signingOrder로 순서를 지정해 보냅니다.
웹훅서명자가 서명할 때마다, 그리고 모두 끝났을 때 알림을 받습니다.
문서 상세 조회누가 서명했고 지금 누구 차례인지 확인합니다.
서명 요청 알림 재전송서명이 늦어지는 서명자에게 알림을 다시 보냅니다.
임베디드 서명자의 보안링크 조회회사 담당자의 서명 화면을 우리 서비스 안에서 엽니다.
서명내용 수정요청앞 서명자가 잘못 입력한 내용을 고쳐 달라고 요청합니다.

함께 보면 좋은 문서

👍

다른 시나리오도 살펴보세요

우리 회사 상황에 맞는 다른 시나리오는 API 도입 시나리오에서 찾을 수 있습니다. 전송 수단(이메일·카카오톡)과 임베디드 보안 링크의 차이도 이 문서에서 확인할 수 있습니다.


Did this page help you?