DocuSign API: Tạo URL chữ ký nhúng với thời gian hết hạn cụ thể

Điều hướng API của DocuSign để ký nhúng an toàn

Trong bối cảnh các giao thức kỹ thuật số không ngừng phát triển, các doanh nghiệp ngày càng dựa vào các nền tảng chữ ký điện tử để hợp lý hóa quy trình làm việc đồng thời đảm bảo an toàn và tuân thủ. DocuSign, với tư cách là người dẫn đầu trong lĩnh vực này, cung cấp các khả năng API mạnh mẽ cho phép các nhà phát triển tích hợp quy trình ký trực tiếp vào ứng dụng của họ. Một chức năng quan trọng trong số này là tạo URL chữ ký nhúng, cho phép người dùng ký tài liệu mà không cần rời khỏi ứng dụng lưu trữ. Bài viết này khám phá cách đạt được điều này bằng API của DocuSign, tập trung vào việc thiết lập thời gian hết hạn cụ thể để tăng cường kiểm soát. Từ góc độ kinh doanh, việc tích hợp như vậy có thể giảm thiểu ma sát trong quá trình giới thiệu khách hàng và thực hiện hợp đồng, có khả năng cải thiện tỷ lệ chuyển đổi lên đến 30% theo các tiêu chuẩn ngành.

Vai trò của chữ ký nhúng trong quy trình kinh doanh hiện đại

Chữ ký nhúng cho phép tài liệu được hiển thị trong iframe hoặc chế độ xem web, tạo ra trải nghiệm người dùng liền mạch. Không giống như chữ ký từ xa, yêu cầu người nhận truy cập liên kết qua email, chữ ký nhúng rất lý tưởng cho các tình huống trong ứng dụng, chẳng hạn như cổng bán hàng hoặc hệ thống nhân sự. API của DocuSign hỗ trợ chức năng này thông qua eSignature REST API, cho phép kiểm soát theo chương trình đối với các buổi ký. Các doanh nghiệp coi trọng điều này vì nó cho phép duy trì tính nhất quán của thương hiệu và thu thập các sự kiện hoàn thành theo thời gian thực.

Việc thiết lập thời gian hết hạn cho các URL này sẽ tăng thêm một lớp bảo mật, ngăn chặn truy cập trái phép sau một khoảng thời gian xác định. Điều này đặc biệt hữu ích trong các ngành có rủi ro cao như tài chính hoặc pháp lý, nơi các tài liệu nhạy cảm về thời gian phải được bảo vệ khỏi các cuộc tấn công phát lại hoặc phơi nhiễm vô thời hạn.

Đang so sánh các nền tảng chữ ký điện tử với DocuSign hoặc Adobe Sign?

eSignGlobal cung cấp giải pháp chữ ký điện tử linh hoạt và hiệu quả về chi phí hơn với tuân thủ toàn cầu, giá cả minh bạch và trải nghiệm giới thiệu nhanh hơn.

👉 Bắt đầu dùng thử miễn phí

Triển khai URL chữ ký nhúng bằng DocuSign API

Để tạo URL chữ ký nhúng với thời gian hết hạn cụ thể, nhà phát triển phải xác thực thông qua OAuth 2.0 và tương tác với Envelopes API của DocuSign. Quá trình này bao gồm việc tạo phong bì, chuẩn bị chữ ký và sau đó truy xuất URL tạm thời để nhúng. Từ góc độ kinh doanh, việc nắm vững chức năng này có thể giảm chi phí vận hành bằng cách tự động hóa các hoạt động theo dõi thủ công và tích hợp với các công cụ CRM như Salesforce.

Bước 1: Xác thực và tạo phong bì

Đầu tiên, hãy lấy mã thông báo truy cập bằng quy trình ủy quyền JWT hoặc mã ủy quyền của DocuSign. Mã thông báo này cấp quyền truy cập API trong tối đa 8 giờ, sau đó phải được làm mới.

Tạo phong bì bằng điểm cuối /accounts/{accountId}/envelopes. Dưới đây là ví dụ về yêu cầu định dạng JSON thông qua POST:

{
  "emailSubject": "Vui lòng ký tài liệu này",
  "documents": [
    {
      "documentBase64": "base64-encoded-document-content",
      "name": "Agreement.pdf",
      "fileExtension": "pdf",
      "documentId": "1"
    }
  ],
  "recipients": {
    "signers": [
      {
        "email": "signer@example.com",
        "name": "John Doe",
        "recipientId": "1",
        "routingOrder": "1"
      }
    ]
  },
  "status": "sent"
}

Điều này sẽ tạo một phong bì cơ bản với một người ký duy nhất. status: "sent" sẽ bắt đầu quy trình làm việc ngay lập tức.

Bước 2: Thêm trường chữ ký và người nhận nhúng

Đối với chữ ký nhúng, hãy chỉ định người nhận là nhúng bằng cách bao gồm clientUserId và chi tiết xác thực. Cập nhật người nhận:

"signers": [
  {
    "email": "signer@example.com",
    "name": "John Doe",
    "recipientId": "1",
    "routingOrder": "1",
    "clientUserId": "unique-client-id-123",
    "userId": "signer-user-id",
    "authenticationMethod": "none",  // Hoặc "email" để tăng cường bảo mật
    "embedUrlEvents": {
      "url": "https://your-app.com/return-url"
    }
  }
]

clientUserId liên kết phiên với ứng dụng của bạn, đảm bảo người ký được xác thực trong môi trường của bạn.

Tiếp theo, hãy xác định các trường chữ ký bằng điểm cuối /envelopes/{envelopeId}/recipients/{recipientId}/tabs. Đối với một trường chữ ký đơn giản:

{
  "signHereTabs": [
    {
      "documentId": "1",
      "pageNumber": "1",
      "xPosition": "100",
      "yPosition": "200",
      "width": "200",
      "height": "50",
      "recipientId": "1"
    }
  ]
}

Điều này sẽ đặt một tab chữ ký trên tài liệu.

Bước 3: Tạo URL chữ ký nhúng với thời gian hết hạn

Bước cốt lõi là gọi điểm cuối /accounts/{accountId}/envelopes/{envelopeId}/views/recipient để lấy URL chữ ký. Chỉ định returnUrl để chuyển hướng sau khi ký và thiết lập thời gian hết hạn thông qua các tham số truy vấn hoặc cài đặt phong bì.

Ví dụ về yêu cầu GET:

GET /accounts/{accountId}/envelopes/{envelopeId}/views/recipient?email=signer@example.com&userName=John%20Doe&returnUrl=https://your-app.com/complete

Phản hồi bao gồm một trường url với liên kết chữ ký nhúng, có thời gian hết hạn mặc định là 5 phút. Để tùy chỉnh thời gian hết hạn, hãy sử dụng thuộc tính expireAfter của phong bì (tính bằng ngày) khi tạo hoặc sử dụng expireEnabled và expireAfterDays của API trong cấu hình nâng cao. Để kiểm soát chi tiết, hãy tích hợp với Thông báo sự kiện của DocuSign để theo dõi và thu hồi quyền truy cập sau khi hết hạn.

Trong mã (ví dụ Python bằng thư viện requests):

import requests

headers = {
    'Authorization': f'Bearer {access_token}',
    'Content-Type': 'application/json'
}

# Create envelope (as above)
envelope_response = requests.post(f'{base_url}/envelopes', json=envelope_data, headers=headers)
envelope_id = envelope_response.json()['envelopeId']

# Get embedded URL
url_params = {
    'email': 'signer@example.com',
    'userName': 'John Doe',
    'returnUrl': 'https://your-app.com/complete'
}
url_response = requests.get(f'{base_url}/envelopes/{envelope_id}/views/recipient', params=url_params, headers=headers)
signing_url = url_response.json()['url']

URL này hiện có thể được nhúng vào iframe: <iframe src="{signing_url}" width="100%" height="600px"></iframe>. Thời gian hết hạn đảm bảo rằng liên kết không hợp lệ sau thời gian đã đặt, thường được thực thi ở phía máy chủ để ngăn chặn giả mạo.

Các phương pháp hay nhất và cân nhắc về kinh doanh

Từ quan điểm kinh doanh, việc triển khai thời gian hết hạn có thể giảm trách nhiệm pháp lý trong các ngành được quản lý. Theo dõi việc sử dụng API thông qua bảng điều khiển của DocuSign để tránh giới hạn hạn ngạch—gói Starter giới hạn ở 40 phong bì mỗi tháng, trong khi gói Advanced với giá 5760 đô la mỗi năm cung cấp nhiều hơn. Kiểm tra trong chế độ hộp cát để đảm bảo tuân thủ ESIGN/UETA ở Hoa Kỳ hoặc eIDAS ở Liên minh Châu Âu. Các cạm bẫy phổ biến bao gồm clientUserId không khớp dẫn đến xác thực không thành công hoặc bỏ qua returnUrl ảnh hưởng đến tính liên tục của quy trình người dùng.

Các doanh nghiệp báo cáo rằng chữ ký nhúng với thời gian hết hạn có thể giảm thời gian ký xuống 50%, cải thiện sự hài lòng của khách hàng. Tuy nhiên, chi phí API tăng lên khi sử dụng nhiều hơn, vì vậy việc đánh giá các giải pháp thay thế để đạt được hiệu quả chi phí là rất quan trọng.

So sánh các nền tảng chữ ký điện tử hàng đầu

Khi chọn một giải pháp chữ ký điện tử, các yếu tố như tính linh hoạt của API, giá cả và tuân thủ khu vực đóng vai trò quan trọng. Dưới đây là so sánh trung lập giữa DocuSign, Adobe Sign, eSignGlobal và HelloSign (hiện là Dropbox Sign) dựa trên dữ liệu công khai năm 2025. Bảng này nêu bật những khác biệt chính để hỗ trợ việc ra quyết định sáng suốt.

So sánh này nêu bật DocuSign vượt trội trong tích hợp doanh nghiệp nhưng có giá cao hơn, trong khi các nền tảng khác cung cấp giá trị trong các lĩnh vực cụ thể.

DocuSign nổi bật với hệ sinh thái API trưởng thành, thúc đẩy chữ ký nhúng trong hàng nghìn ứng dụng trên toàn cầu. Chương trình dành cho nhà phát triển của họ, từ cơ bản với giá 600 đô la mỗi năm đến các tùy chọn doanh nghiệp tùy chỉnh, nhấn mạnh khả năng mở rộng cho các doanh nghiệp có khối lượng lớn.

Adobe Sign, được tích hợp sâu với quy trình làm việc sáng tạo và tài liệu, cung cấp chữ ký nhúng thông qua API của mình, với các tùy chọn hết hạn được liên kết với vòng đời phong bì. Giá khởi điểm cao hơn nhưng việc kết hợp với Acrobat phù hợp với người dùng sử dụng nhiều PDF.

eSignGlobal cung cấp chữ ký điện tử tuân thủ ở 100 quốc gia toàn cầu chính, với sự hiện diện mạnh mẽ ở Châu Á Thái Bình Dương (APAC). Bối cảnh chữ ký điện tử ở APAC trình bày một cách tiếp cận phân mảnh, tiêu chuẩn cao và được quản lý chặt chẽ, trái ngược với khung ESIGN/eIDAS của phương Tây. APAC yêu cầu phương pháp "tích hợp hệ sinh thái", bao gồm tích hợp phần cứng/API sâu với danh tính kỹ thuật số của chính phủ (G2B), vượt xa các phương pháp email hoặc tự khai báo phổ biến ở Hoa Kỳ/EU. eSignGlobal cạnh tranh trực tiếp với DocuSign và Adobe Sign thông qua giá cả phải chăng—gói Essential của họ với giá 16,6 đô la mỗi tháng cho phép gửi tối đa 100 tài liệu, số lượng chỗ ngồi người dùng không giới hạn và xác minh mã truy cập chữ ký. Nó tích hợp liền mạch iAM Smart của Hồng Kông và Singpass của Singapore, đảm bảo tuân thủ khu vực với chi phí chỉ bằng một phần nhỏ so với các đối thủ cạnh tranh.

Đang tìm kiếm một giải pháp thay thế thông minh hơn cho DocuSign?

eSignGlobal cung cấp giải pháp chữ ký điện tử linh hoạt và hiệu quả về chi phí hơn với tuân thủ toàn cầu, giá cả minh bạch và trải nghiệm giới thiệu nhanh hơn.

👉 Bắt đầu dùng thử miễn phí

HelloSign (hiện là Dropbox Sign) ưu tiên sự đơn giản trong API URL nhúng của mình, với thời gian hết hạn được xử lý thông qua cài đặt tài liệu. Nó hiệu quả về chi phí cho các nhóm nhỏ nhưng thiếu chiều sâu tự động hóa của DocuSign.

Kết luận: Chọn giải pháp phù hợp cho doanh nghiệp của bạn

Tóm lại, API của DocuSign để tạo URL chữ ký nhúng với thời gian hết hạn cụ thể cung cấp khả năng kiểm soát mạnh mẽ đối với quy trình làm việc an toàn, tích hợp. Các doanh nghiệp nên cân nhắc sự trưởng thành của API với tổng chi phí sở hữu và nhu cầu khu vực. Đối với các doanh nghiệp ưu tiên tuân thủ APAC, eSignGlobal nổi bật như một giải pháp thay thế trung lập, được tối ưu hóa theo khu vực cho DocuSign.