빠르게 봉투 시작하기

매개변수 이름

유형

필수

설명

subject

string

true

봉투 제목

예: “Offer Letter”

remark

string

false

봉투 메모，길이 제한 1000자

object

false

서명자가 수행할 수 있는 작업

boolean

false

서명자가 해당 봉투를 다른 사람이 서명하도록 전달할 수 있는지 여부, 기본값은 false입니다.

true - 봉투의 서명자가 봉투를 다른 사람에게 전달할 권한을 갖습니다.

false - 봉투의 서명자가 봉투를 다른 사람에게 전달할 권한을 갖지 않습니다.

boolean

false

서명자가 이름을 수정할 수 있는지 여부, 템플릿 서명에만 적용되며 기본값은 false입니다.

true - 서명자가 이름을 수정할 수 있습니다.

false - 서명자가 이름을 수정할 수 없습니다.

expireAfterSeconds

long

false

봉투 만료 시간, 몇 초 후 봉투가 만료되는지

만료 범위: 86,400초(1일) ~ 7,776,000초(90일)

redirectUrl

string

false

유효한 https 주소여야 합니다.

callBackUrl

string

false

콜백 주소(길이 500), https 프로토콜 주소와 일치해야 합니다.

sendLaterAfterSeconds

long

false

사용자 지연 전송 지원, 초 단위

지원 시간 범위: 3600초(1시간) ~ 259200초(30일)

CCInfos

array

false

참조인 정보 모음

userEmail

string

false

참조인 이메일 주소

userName

string

false

참조 수신인 이름으로, 서명 페이지와 봉투에 참조 수신인 이름을 외부로 표시하는 데 사용됩니다.

【주의】: 다음 9개의 특수 문자(/ \ : * " < > | ？）와 모든 이모지 표정을 포함할 수 없습니다.

customizeSettings

object

false

사용자 정의 구성

notificationSettings

object

false

알림 유형 사용자 정의 구성

notificationLanguage

string

false

알림 언어, 기본값은 영어입니다.

en-US 영어

zh-CN 중국어 간체

zh-Hant 중국어 번체

ja-JP 일본어

ES-MX 스페인어

signFiles

array

true

서명 파일 정보 모음, 파일 추가 순서대로 표시됩니다.

fileKey 

string

true

서명 파일 fileKey, PDF 형식만 지원합니다.

attachments

array

false

봉투 첨부 파일 모음, 파일 추가 순서대로 표시됩니다.

fileKey 

string

false

파일 fileKey

signerInfos

array

true

서명자 정보 모음

businessId

string

false

개발자가 정의하는 업무 번호, 길이 제한 500

string

false

userEmail

string

true

서명자 이메일 주소

userName

string

true

서명자 이름, 서명 페이지 및 봉투에 서명자 이름을 표시하는 데 사용됩니다.

【참고】다음 9개의 특수 문자(/ \ : * " < > | ？)와 모든 이모티콘을 포함할 수 없습니다.

phoneNumber

object

false

전화 번호, 기본값은 비어 있음

SMS 알림이 필요한 경우 필수 파라미터이며, countryCode와 number를 모두 전달해야 합니다.

countryCode

string

false

국가/지역의 국제 코드, “+”를 전달할 필요 없음

number

string

false

형식 검사는 없으며, 최대 길이만 13자리로 제한됩니다.

customizeSettings

object

false

사용자 정의 구성

notificationSettings

object

false

알림 유형 사용자 정의 구성

customizeMessage

string

false

맞춤 메시지 알림, 문자 제한 200

notificationLanguage

string

false

알림 언어, 기본값은 영어

en-US 영어

zh-CN 중국어 간체

zh-Hant 중국어 번체

ja 일본어

ES-MX 스페인어

signOrder

int

true

서명자 서명 순서, 최소 1. 순서 없는 서명은 동일한 순서 값을 지정할 수 있습니다.

anySigner

boolean

false

임의의 서명자 서명 지원 여부, 기본값 false

true-동일한 signOrder에서 한 명만 서명하면 됨

false-동일한 signOrder에서 모든 사람이 서명해야 함

authModes

string

false

확인 방법, 기본값은 noAuth

authConfig

object

false

인증 방식 설정

accessCode

object

false

서명 비밀번호 설정, authModes=accessCode일 때 필수 입력

accessCode

string

false

비밀번호 내용, 대소문자 구분 없음, 영숫자 포함 가능, 길이 제한 45

promptInfo

string

false

접속 비밀번호 힌트 정보, 접속 비밀번호를 포함할 수 없으며, 길이 제한 30, authModes=1일 때 필수 입력. 

sms

object

false

SMS OTP 검증, authModes=sms일 때 필수 입력

countryCode

string

false

국가/지역 국제 코드, “+”는 입력하지 않아도 됨

number

string

false

형식 검사는 하지 않으며, 최대 길이 13자리로 제한

idVerification

object

false

신분증 인증 설정, authModes=idVerification일 때 필수 입력

name

string

false

서명인의 신분증에 기재된 전체 이름, 최대 길이 100자

emailAuth

object

false

이메일 OTP 확인, authModes=emailAuth일 때 필수 입력

authEmail

string

false

서명인 신원 확인 이메일 주소

digitalId

array

false

전자 신원 확인, authModes=digitalId일 때 필수 입력

authApp

string

false

전자 신원 확인에 사용되는 앱

singpass - Singpass를 사용하여 인증

idNumber

string

false

서명인이 인증해야 할 신분증 번호

digitalSignature

boolean

false

디지털 서명 활성화 여부, 기본값은 false

true - 활성화, false - 비활성화

freeFormSign

boolean

false

서명인이 자유롭게 서명할 수 있는지 여부, 기본값은 false

추가 설명:

freeFormSign을 true로 선택하면 sealInfos 아래의 다른 매개변수를 전달할 필요가 없습니다. 동시에 전달하면 freeFormSign의 우선 순위가 sealInfos보다 높으며 sealInfos 아래의 매개변수는 적용되지 않습니다.

[주의]자유 서명은 서명자가 드래그할 수 있는 도장/서명 수와 위치를 제한하지 않습니다.

sealInfos

array

false

서명 작업 정보

fileKey

string

true

서명 파일 fileKey

signConfigs

array

false

컨트롤 위치 정보, 전자 서명을 하려면 컨트롤의 위치 정보를 지정해야 합니다.

fieldType

string

false

컨트롤 유형, 기본값은 signature입니다.

signature-서명 컨트롤

stamp-도장 컨트롤

sizeRule

string

false

서명 영역 크기 표시 방식

originalSize-서명/도장의 실제 크기에 따라 날인

targetSize-사용자 정의 서명/도장 영역 높이 및 너비

sizeRule, height, width가 모두 비어 있으면 서명/도장의 실제 크기에 따라 날인됩니다.

sizeRule이 비어 있고 height, width가 비어 있지 않으면 지정된 크기에 따라 날인됩니다.

sizeRule이 비어 있지 않으면 지정된 표시 방식에 따라 날인됩니다.

height

int

false

서명 컨트롤 높이, fieldType이 signature/stamp인 경우에 적용되며 단위는 px이고 양의 정수만 전달할 수 있으며 기본값은 auto(즉, 시스템 자동 크기)입니다.

fieldType=signature인 경우 범위는 20-250px로 설정할 수 있습니다.

fieldType=stamp일 때, 범위는 30-280px로 설정할 수 있습니다.

width

int

false

서명 컨트롤 너비, fieldType이 signature/stamp일 때 적용, 단위는 px, 양의 정수만 입력 가능, 기본값은 auto(시스템 자동 크기)입니다.

fieldType=signature일 때, 범위는 20-250px로 설정할 수 있습니다.

fieldType=stamp일 때, 범위는 30-280px로 설정할 수 있습니다.

signatureOptions

string

false

서명 컨트롤 옵션. fieldType이 signature일 때만 적용됩니다.

입력 가능한 매개변수:

template: 템플릿 서명

handDrawn: 손으로 그린 서명

upload: 로컬에서 서명 이미지 업로드

다중 선택 가능, ","로 구분, 기본값은 전체 선택

movable

boolean

false

서명 시 위치 이동 허용, 기본값은 false

false-서명자가 자신의 서명 컨트롤 위치를 조정하는 것을 허용하지 않음

true-서명자가 자신의 서명 컨트롤 위치를 조정하는 것을 허용함

allowedOptions

array

false

서명자가 승인할 수 있는 옵션, fieldType이 approval일 때 적용됩니다. 기본값은 ["approve", "decline"]입니다.

approve-동의

decline- 거절

pageNo

string

false

서명 페이지 번호; 연속 페이지 번호는 "-"로 연결하고, 개별 페이지 번호는 ","로 연결합니다.

예: 1-3,6-10

posX

float

false

x축 좌표

[주의] fieldType이 signature인 경우, 좌표 위치는 서명 영역을 나타냅니다.왼쪽 하단；

fieldType이 stamp인 경우, 좌표 위치는 날인 영역을 나타냅니다.중심점위치

2026년 2월 3일부터 fieldType이 signature 또는 stamp인 경우, 좌표 위치는 날인 영역의 중심점 위치를 나타냅니다.

posY

float

false

y축 좌표

[주의] fieldType이 signature인 경우, 좌표 위치는 서명 영역을 나타냅니다.왼쪽 하단；

fieldType이 stamp인 경우, 좌표 위치는 날인 영역을 나타냅니다.중심점위치

2026년 2월 3일부터 fieldType이 signature 또는 stamp인 경우, 좌표 위치는 날인 영역의 중심점 위치를 나타냅니다.

fillConfigs

array

false

컨트롤 정보 입력

fieldName

string

false

컨트롤 이름, 글자 수 제한 128

required

boolean

false

필수 입력 여부, 기본적으로 필수 입력

true-필수 입력

false-필수 아님

fieldType

string

false

컨트롤 유형:

1-단일 행 텍스트

15-체크 상자

textField

object

false

텍스트 컨트롤 속성

overflowType

int

false

text에만 적용, 기본값 1

1-자동 글꼴 크기 축소

2-입력 제한

minFontSize

float

false

text에만 적용, overflowType=1에만 적용, 기본값 8

5, 5.5, 6, 6.5, 7, 7.5, 8, 9, 10, 10.5, 11, 12, 14, 15, 16, 18, 20, 22, 24, 26, 28, 36, 42, 48, 56, 72

width

int

false

컨트롤 너비, 기본값 160px

font

int

false

텍스트에만 적용, 글꼴, 기본값 돋움

1-돋움

2-새 돋움

4-고딕

5-흘림

6-Arial

7-Helvetica

9-Times New Roman

10-방송

11-Georgia

12-Monospace

fontSize

float

false

텍스트에만 적용, 글꼴 크기, 기본값 12

5, 5.5, 6, 6.5, 7, 7.5, 8, 9, 10, 10.5, 11, 12, 14, 15, 16, 18, 20, 22, 24, 26, 28, 36, 42, 48, 56, 72

textColor

string

false

텍스트에만 적용, 16진수 색상, 기본값 검은색 #000

bold

boolean

false

텍스트에만 적용, 글꼴 굵게 여부, 기본값 false

true-굵게

false-굵게 안 함

italic

boolean

false

텍스트에만 적용, 기울임꼴 여부, 기본값 false

true-기울임꼴

false-기울임꼴 아님

underline

boolean

false

텍스트에만 적용되며, 글꼴에 밑줄을 추가할지 여부입니다. 기본값은 false입니다.

true - 밑줄 추가

false - 밑줄 추가 안 함

lineThrough

boolean

false

텍스트에만 적용되며, 취소선을 추가할지 여부입니다. 기본값은 false입니다.

true - 취소선 추가

false - 취소선 추가 안 함

horizontalAlignment

string

false

텍스트에만 적용되며, 수평 가운데 맞춤 형식입니다. 기본값은 left입니다.

LEFT - 왼쪽 정렬

CENTER - 가운데 정렬

RIGHT - 오른쪽 정렬

tickBoxField

object

false

체크 상자 속성

tickOptions

array

false

tickBox에만 적용되며, 기본값은 1입니다.

1 - 체크 표시

2 - 엑스 표시

posX

float

false

컨트롤 위치 X 가로 좌표

posY

float

false

컨트롤 위치 Y 세로 좌표

pageNo

string

false

컨트롤이 있는 페이지 번호

signDateConfigs

array

false

서명 날짜 위치 정보

movable

boolean

false

서명 시 위치 이동 허용, 기본값은 false

false-서명자가 자신의 서명 컨트롤 위치를 조정할 수 없음

true-서명자가 자신의 서명 컨트롤 위치를 조정할 수 있음

pageNo

string

false

서명 페이지 번호; 연속 페이지 번호는 "-"로 연결하고, 개별 페이지 번호는 ","로 연결，예: 1-3, 6-10;

연속되지 않은 경우 ","로 구분하여 전달합니다.

posX

float

false

x축 오프셋, 페이지 왼쪽 하단이 좌표 원점

posY

float

false

y축 오프셋, 페이지 왼쪽 하단이 좌표 원점

signDateFormat

string

false

서명 날짜 형식, 기본 형식은 yyyy-MM-dd

지원되는 지정 형식:

yyyy년MM월dd일

yyyy-MM-dd

yyyy/MM/dd

dd.MM.yyyy

MM dd yyyy

dd MM yyyy

매개변수 이름

유형

설명

envelopeId

string

봉투 ID

CCInfos

array

참조인 정보 모음

userEmail

string

참조인 이메일 주소

userName

string

참조인 이름

signFiles

array

서명 파일 정보 모음

fileKey

string

서명 파일 fileKey

attachments

array

봉투 첨부 파일 모음

fileKey

string

파일 fileKey

signerInfos

array

서명 정보

businessId

string

개발자 정의 비즈니스 번호, 길이 제한 500

userEmail

string

서명자 이메일 주소

userName

string

서명자 이름

signOrder

int

서명자 서명 순서, 최소 1

accessCode

string

서명 페이지 액세스 암호