WooCommerce 신분증 인증 플러그인: WordPress KYC

​

사전 요구 사항

• WordPress 6.0 이상
• PHP 7.4 이상
• Didit 콘솔 계정

​

1단계: Didit 자격 증명 가져오기

1. business.didit.me에서 가입하거나 로그인합니다.
2. API & Webhooks로 이동하여 API 키를 복사합니다.
3. 워크플로로 이동하여 워크플로를 만들거나 선택한 뒤 워크플로 ID를 복사합니다.

​

2단계: 플러그인 설치

1. 0.3.4 릴리스에서 didit-verify-0.3.4.zip을 다운로드합니다.
2. WordPress 관리자 화면에서 플러그인 → 새로 추가 → 플러그인 업로드로 이동합니다.
3. 다운로드한 ZIP 파일을 선택하고 지금 설치를 클릭합니다.
4. 활성화를 클릭합니다.

​

3단계: 플러그인 구성

​

모드 선택

​

세션 옵션 구성 (API 모드에서만)

• Vendor Data: 각 인증을 Didit 대시보드의 특정 사용자와 연결하여 누가 인증했는지 추적할 수 있습니다. 기본값은 WordPress 사용자 ID(예: wp-42)입니다. 사용자 이메일, 사용자 지정 접두사를 선택하거나 이 기능을 끌 수도 있습니다.
• Callback URL: 인증이 끝난 뒤 사용자를 리디렉션할 사이트의 페이지입니다. Didit은 쿼리 매개변수로 verificationSessionId와 status를 추가합니다.
• Callback Method: 리디렉션을 처리할 기기를 지정합니다. initiator(인증을 시작한 기기), completer(인증을 마치는 기기), both 중에서 선택합니다.
• Language: 54개 언어 중에서 선택하거나 브라우저에서 자동으로 감지하도록 설정할 수 있습니다.

​

표시 옵션 구성

• Display Mode: 모달(팝업 오버레이) 또는 Embedded(페이지 안에 인라인 표시)를 선택합니다.
• Close Button: 모달의 X 버튼을 표시하거나 숨깁니다.
• Exit Confirmation: 닫을 때 “정말 닫으시겠습니까?” 대화 상자를 표시합니다.
• Auto-close: 인증이 완료되면 모달을 자동으로 닫습니다.
• Debug Logging: SDK 이벤트를 브라우저 콘솔에 기록합니다(문제 해결용).

​

버튼 꾸미기

• 버튼 텍스트와 성공 텍스트
• 배경색과 글자색
• 모서리 반경, 안쪽 여백, 글꼴 크기

​

4단계: 사이트에 인증 추가

​

WooCommerce 스토어의 경우

1. 설정 → Didit Verify → WooCommerce에서 Require identity verification at checkout을 선택합니다.
2. 인증 섹션이 표시될 위치를 선택합니다.
   • 결제 페이지 상단
   • 청구 정보 입력 뒤
   • 주문 메모 뒤
   • “주문하기” 버튼 앞(권장)
3. 선택 사항으로 Product Scope를 고릅니다. 모든 제품(기본값), 선택한 제품만, 또는 선택한 제품을 제외한 모든 제품 중에서 고를 수 있습니다. 제품 편집기의 Product data → Advanced에서 Didit verification 체크박스를 선택해 제품을 표시합니다. 인증이 필요한 제품이 하나라도 장바구니에 있으면 인증이 필요합니다. 이 범위는 결제 시 인증과 구매 후 인증 모드 모두에 적용됩니다.
4. 선택 사항으로 설정 → Didit Verify → WooCommerce에서 Section Title, Checkout Message, Post-purchase Message를 수정할 수 있습니다. 빈 필드는 기본 텍스트를 사용합니다.
5. 선택 사항으로 Send Billing Data를 켜면 고객의 이름, 이메일, 전화번호, 주소를 Didit에 자동으로 전송하여 사전 입력과 교차 검증에 사용합니다.

​

모든 WordPress 페이지의 경우

[didit_verify]

[didit_verify text="Verify Now" success_text="Done!"]

[didit_verify mode="embedded"]

​

Step 5: 인증된 사용자에게만 콘텐츠 제한하기 (선택 사항)

[didit_gate]
This content is only visible to verified users.
[/didit_gate]

[didit_gate message="Please verify to continue."]Secret content here.[/didit_gate]

[didit_status]

​

인증 상태 확인하기

​

문제 해결

​

보안

1. CSRF nonce: 요청은 반드시 WordPress 사이트에서 시작되어야 합니다
2. 로그인 요구 사항: 등록된 사용자만 세션을 생성할 수 있습니다(설정 가능)
3. 속도 제한: 사용자당 시간당 10개 세션, 게스트는 IP당 시간당 3개 세션
4. 입력 정제: 모든 필드는 허용 목록으로 관리되며 서버 측에서 정제됩니다

​

개발자용

​

PHP 훅

// When a user completes verification
add_action('didit_verification_completed', function ($user_id, $session_id, $status) {
    // Update CRM, send email, grant access, etc.
}, 10, 3);

// When a user cancels verification
add_action('didit_verification_cancelled', function ($user_id, $session_id) {
    // Log cancellation
}, 10, 2);

// When a session is created server-side
add_action('didit_session_created', function ($url, $user_id, $vendor_data) {
    // Log, notify, etc.
}, 10, 3);

​

JavaScript 이벤트

document.addEventListener('didit:complete', function (e) {
    console.log('Result:', e.detail); // { type, session }
});

​

PHP에서 인증 확인하기

$is_verified = Didit_Verify::init()->is_user_verified($user_id);

​

리소스

• 플러그인 소스 코드(GitHub)
• Didit API 문서
• Didit Console
• Create Session API 참조