DocsReferencesChangelog
Docs

내 사이트에서 서명받기

모두싸인은 기본적으로 이메일 또는 카카오톡으로 서명요청 링크를 전송하고, 해당 링크를 통해 서명 참여자가 서명을 입력할 수 있습니다.
만약 내 사이트에서 유저가 바로 서명을 입력하게 하기 위해서는 “보안링크로 임베디드 참여” 기능을 사용해야 합니다.

 

 

보안링크로 임베디드 참여

"서명 요청 API" 와 "템플릿으로 서명 요청 API"로 서명요청을 실행할 때에 참여자 signingMethod의 type을 SECURE_LINK 로 설정할 수 있습니다. SECURE_LINK 서명 수단은 참여자의 연락처로 서명요청 링크를 전송하지 않습니다. 대신, "임베디드 참여자의 보안링크 조회" 기능을 통해 서명을 입력할 수 있는 “보안링크 embeddedUrl” 을 획득 할 수 있습니다.

🚧

보안링크(SECURE_LINK) 참여자의 이메일 또는 휴대전화번호는 검증되지 않습니다.

EMAIL, KAKAO 서명 요청 수단은 해당 연락처로 서명 입력링크가 전달되므로, 참여자가 해당 연락처를 점유하고 있음을 확인합니다. 하지만 SECURE_LINK 를 통해 서명을 진행할 시에는 입력한 연락처를 통한 서명이 아니므로 해당 연락처에 대한 점유는 확인되지 않습니다.
체결하고자 하는 계약의 성격과 상황에 맞게 적절한 서명 수단을 선택해 주세요.

 

 

서명 요청 시 보안링크(SECURE_LINK)로 설정

curl --request POST \
     --url https://api.modusign.co.kr/documents/request-with-template \
     --header 'Accept: application/json' \
     --header 'Authorization: Basic VVNFUjo=' \
     --header 'Content-Type: application/json' \
     --data '
{
  "templateId": "TEMPLATE_ID",
  "document": {
    "title": "2020_근로계약서_홍길동"
    "participantMappings": [
      {
        "name": "김모두",
        "signingMethod": {
          "type": "SECURE_LINK",
          "value": "[email protected]"
        }
      }
    ],
  }
}
'

보안링크 (SECURE_LINK) 참여자의 embeddedUrl 조회

"임베디드 참여자의 보안링크 조회 API"에 문서 ID와 대상 참여자 ID를 전달해 서명을 입력할 수 있는 "보안링크 embeddedUrl" 을 조회할 수 있습니다.
해당 URL은 10분간 유효하며, 10분뒤에는 접근할 수 없습니다.

curl --request GET \
     --url https://api.modusign.co.kr/documents/{DOCUMENT_ID}/participants/{PARTICIPANT_ID}/embedded-view \
     --header 'Accept: application/json' \
     --header 'Authorization: Basic VVNFUjo=' \
     --header 'Content-Type: application/json'
응답
{
  "embeddedUrl": "https://app.modusign.co.kr/embedded-participant?di=..."
}

 

 

보안링크 임베디드 URL 열기

해당 URL을 클라이언트로 전달하여, 새 창, 새 탭 또는 iframe 내에서 열 수 있습니다.
해당 URL을 통해 서명을 입력할 수 있습니다.

// 새탭으로 열기
window.open("https://app.modusign.co.kr/embedded-participant/XXX?di=XXXXXXX...");

// 새창으로 열기
window.open(
  'https://app.modusign.co.kr/embedded-participant/XXX?di=XXXXXXX...',
  '_blank', 
  'top=10, left=10, width=1440, height=900'
);

// iframe에 열기
var targetIframe = document.getElementById('target-iframe');
targetIframe.src = 'https://app.modusign.co.kr/embedded-participant/XXX?di=XXXXXXX...';

Updated 7 months ago