curl --fail \
https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/generate-pdf/ \
-H 'x-api-key: YOUR_API_KEY' \
--output report.pdffrom didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
content = client.sessions.generate_pdf(
"11111111-2222-3333-4444-555555555555",
)
with open("download.pdf", "wb") as file:
file.write(content)import { writeFile } from "node:fs/promises";
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const content = await didit.sessions.generatePdf("11111111-2222-3333-4444-555555555555");
await writeFile("download.pdf", Buffer.from(await content.arrayBuffer()));ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
resp, err := client.Sessions.GeneratePDF(ctx, "11111111-2222-3333-4444-555555555555")
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
file, err := os.Create("download.pdf")
if err != nil {
log.Fatal(err)
}
defer file.Close()
if _, err := io.Copy(file, resp.Body); err != nil {
log.Fatal(err)
}import java.nio.file.Path;
import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
client.sessions().generatePdf("11111111-2222-3333-4444-555555555555")
.writeTo(Path.of("download.pdf"));<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$content = $didit->sessions->generatePdf('11111111-2222-3333-4444-555555555555');
$content->saveTo('download.pdf');require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
content = didit.sessions.generate_pdf("11111111-2222-3333-4444-555555555555")
File.binwrite("download.pdf", content)using System;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var content = await client.Sessions.GeneratePdfAsync("11111111-2222-3333-4444-555555555555");
await content.SaveToAsync("download.pdf");"<string>"PDF 생성 API: KYC·KYB 컴플라이언스 보고서
Didit의 GET /v3/session//generate-pdf/로 KYC 또는 KYB 세션의 브랜드 적용 컴플라이언스 보고서를 다운로드하세요. 화이트 라벨, 감사 대응 가능, 사용량 기반 요금.
curl --fail \
https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/generate-pdf/ \
-H 'x-api-key: YOUR_API_KEY' \
--output report.pdffrom didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
content = client.sessions.generate_pdf(
"11111111-2222-3333-4444-555555555555",
)
with open("download.pdf", "wb") as file:
file.write(content)import { writeFile } from "node:fs/promises";
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const content = await didit.sessions.generatePdf("11111111-2222-3333-4444-555555555555");
await writeFile("download.pdf", Buffer.from(await content.arrayBuffer()));ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
resp, err := client.Sessions.GeneratePDF(ctx, "11111111-2222-3333-4444-555555555555")
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
file, err := os.Create("download.pdf")
if err != nil {
log.Fatal(err)
}
defer file.Close()
if _, err := io.Copy(file, resp.Body); err != nil {
log.Fatal(err)
}import java.nio.file.Path;
import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
client.sessions().generatePdf("11111111-2222-3333-4444-555555555555")
.writeTo(Path.of("download.pdf"));<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$content = $didit->sessions->generatePdf('11111111-2222-3333-4444-555555555555');
$content->saveTo('download.pdf');require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
content = didit.sessions.generate_pdf("11111111-2222-3333-4444-555555555555")
File.binwrite("download.pdf", content)using System;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var content = await client.Sessions.GeneratePdfAsync("11111111-2222-3333-4444-555555555555");
await content.SaveToAsync("download.pdf");"<string>"KYC 및 KYB 지원
사용자 인증(KYC) 및 기업 확인(KYB) 세션 모두에서 작동합니다. Didit은 적절한 PDF 템플릿을 자동으로 선택합니다:- 사용자 인증(KYC) 세션 → 신분증 인증, 라이브니스 감지, 얼굴 대조, AML, 주소 증명(POA) 섹션이 포함된 보고서.
- 기업 확인(KYB) 세션 → 해당 기능이 워크플로에 포함된 경우 법인 등기부, 주요 인물(UBO/임원), 문서, AML, 설문지, 전화번호, 이메일, IP 분석 섹션이 포함된 보고서.
파일 이름 규칙
| 구분 | 파일 이름 |
|---|---|
| 사용자 | session_<session_id>.pdf |
| 기업 | business_<session_id>.pdf |
Content-Disposition: attachment; filename=... 헤더를 통해 반환됩니다.
상태 요건
PDF를 생성하려면 세션이APPROVED, DECLINED, IN_REVIEW 중 하나의 상태여야 합니다. 진행 중이거나 아직 시작되지 않은 세션은 403을 반환합니다.
예시
- 사용자 인증(KYC) PDF
- 기업 확인(KYB) PDF
curl https://verification.didit.me/v3/session/4c5c7f3a-.../generate-pdf/ \
-H "x-api-key: YOUR_API_KEY" \
-o kyc-report.pdf
curl https://verification.didit.me/v3/session/bs-01HJX1.../generate-pdf/ \
-H "x-api-key: YOUR_API_KEY" \
-o kyb-report.pdf
화이트 라벨
애플리케이션에서 화이트 라벨 맞춤 설정이 활성화되어 있으면 PDF에 귀사의 로고와 개인정보 처리방침 URL이 사용됩니다. Console → Customization에서 설정합니다.권한
read:sessions 권한이 필요합니다. 두 유형 모두 같은 스코프를 사용합니다.
관련 문서
- 세션 개요
- 세션 조회: 동일한 결정을 담은 JSON 버전
- 사용자 이력 PDF 다운로드: 한 사용자의 보고 가능한 모든 세션을 하나의 파일로 제공
- KYB 응답 스키마: 기업 PDF에 포함되는 필드
인증
Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.
경로 매개변수
렌더링할 사용자 인증(KYC) 또는 기업 확인(KYB) 세션의 UUID입니다(POST /v3/session/에서 반환된 session_id). 두 세션 유형 모두 동일한 경로가 작동하며, 수신된 보고서 유형을 확인하려면 응답의 Content-Disposition 파일명을 사용하십시오.
반드시 올바른 형식의 소문자 UUID여야 합니다. 라우트는 유효한 UUID만 일치시키므로, 잘못된 형식의 값은 애플리케이션 코드가 실행되기 전에 URL 라우터에 의해 거부되며 응답은 아래 표시된 JSON {"detail": ...} 형식이 아닌 404 HTML 페이지로 반환됩니다. 라우트의 UUID 변환기는 표준 소문자 형식만 일치시키므로 대문자 16진수 UUID는 HTML 404로 거부됩니다.
"11111111-2222-3333-4444-555555555555"
응답
렌더링된 PDF 문서로, 바이너리 application/pdf 형식으로 직접 반환됩니다. JSON 래퍼나 다운로드 URL 간접 참조가 없습니다. 본문은 %PDF 매직 바이트(PDF 1.7)로 시작합니다. .pdf 파일로 저장하거나 호출자에게 스트리밍하세요.
The response is of type file.