우리 서비스 화면에서 바로 서명받기

고객이 우리 서비스 화면을 떠나지 않고, 신청 화면에서 이어서 바로 서명합니다. 카카오톡이나 이메일을 확인하러 다른 곳으로 가지 않아도 되므로, 서명하러 가는 사이에 고객이 이탈하는 일을 줄일 수 있습니다.

한눈에 보는 흐름

이런 경우에 맞습니다

• 온라인 접수 화면에서 위임 계약서에 바로 서명받는 경우
• 회원 전환·서비스 가입 단계에서 약정서에 서명받는 경우
• 자사몰에서 렌탈 약정서에 서명받는 경우
• 신청서를 제출한 직후 같은 화면에서 계약까지 끝내는 경우

준비할 것

연동 흐름

sequenceDiagram
    autonumber
    participant C as 고객
    participant S as 우리 서비스
    participant M as 모두싸인
    Note over C,S: 고객이 우리 서비스에서 신청 정보를 입력함
    C->>S: 계약서 서명하기 클릭
    S->>M: 서명 요청 (임베디드 보안 링크로 지정)
    S->>M: 서명 화면 주소 요청
    M-->>S: 서명 화면 주소 (10분 동안 유효)
    S->>C: 우리 서비스 화면 안에 서명 화면 열기
    C->>M: 계약서 확인 후 서명
    M-->>C: 우리 서비스의 다음 화면으로 이동
    M-->>S: 서명 완료 알림 (웹훅)
    Note over S: 등록 완료·서비스 시작 등 다음 단계 진행

1. 서명 요청: 고객이 서명 버튼을 누르면 템플릿으로 서명 요청 API를 호출합니다. 고객 정보로 문서 편집 입력란을 채우고, 서명자를 임베디드 보안 링크(SECURE_LINK)로 지정합니다. 임베디드 보안 링크로 지정한 서명자에게는 모두싸인이 카카오톡이나 이메일을 보내지 않습니다.
2. 서명 화면 주소 받기: 임베디드 서명자의 보안링크 조회 API로 서명 화면 주소(embeddedUrl)를 받습니다. 서명을 마친 고객을 보낼 우리 서비스 주소는 redirectUrl로 함께 지정합니다.
3. 우리 서비스 화면 안에서 서명: 받은 주소를 우리 서비스의 새 창, 새 탭 또는 iframe으로 엽니다. 고객은 우리 서비스 화면을 벗어나지 않고 계약서를 확인한 뒤 서명합니다.
4. 우리 서비스로 돌아오기: 서명이 끝나면 고객은 redirectUrl로 지정한 우리 서비스의 다음 화면으로 이동합니다. 이때 주소에 문서 ID와 결과(eventType)가 함께 붙어 오므로, 서명 완료·거절·나가기에 따라 다른 화면을 보여 줄 수 있습니다.
5. 서명 완료 알림: 모든 서명이 끝나면 모두싸인이 우리 서비스의 웹훅 주소로 서명 완료 알림(document_all_signed 이벤트)을 보냅니다. 등록 완료나 서비스 시작 같은 다음 단계는 이 알림을 기준으로 진행합니다.

사용하는 API

함께 보면 좋은 문서

• 내 사이트에서 서명받기
• redirectUrl 활용하기
• 임베디드 문서 열람