Checkify — 개발자 빠른 시작

1. 사이트 생성 및 패스ID 복사

Checkify 앱이나 비즈니스 대시보드에서 디지털 사이트를 생성하고 임베드가 실행될 도메인을 등록하세요. Checkify은 사이트당 하나의 패스를 자동 프로비저닝합니다(예: chk_live_...).

샌드박스 테스트의 경우 테스트 환경 사이트의 chk_test_...) 테스트 패스를 사용합니다.

2. 포함 스니펫을 추가합니다

이를 페이지에 붙여넣습니다. YOUR_PASS_ID 를 바꾸고 요청을 선택합니다.

<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>
<div
  data-checkify-pass="YOUR_PASS_ID"
  data-checkify-request="human"
  data-checkify-text="Verify with Checkify"
></div>

3. 양식 바인딩(선택 사항)

로그인, 가입, 결제 또는 문의 양식의 경우 SDK이 버튼, 숨겨진 토큰 필드 및 제출 상태를 처리하도록 합니다.

<form id="signup-form">
  <input type="email" name="email" required>
  <input type="hidden" id="checkify_token" name="checkify_token">
  <div id="checkify-button"></div>
  <button id="submit" type="button">Create account</button>
</form>

<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>
<script>
  Checkify.bindForm('#signup-form', {
    passId: 'YOUR_PASS_ID',
    requestType: 'human',
    buttonTarget: '#checkify-button',
    submitButton: '#submit',
    hiddenInput: '#checkify_token'
  });
</script>

4. 백엔드에서 확인

브라우저는 보호된 작업을 허용하기 전에 항상 서버 측에서 확인합니다.

사이트의 API 키를 사용하고 숨겨진 필드에서 POST /v1/qr/results/verify 로 request_id 를 호출하세요(레거시 포함은 여전히 설문 토큰을 제출할 수 있음). 이벤트 및 반환 URL 처리는 서버 확인 가이드. For browser events and return URLs, see the embed API reference를 참고하세요.

요청 유형

요청 유형	Server claim (required_claims)	일반적인 사용
`human`	`human_verified`	봇/스팸 감소
`age_over_18`	`age_over_18`	18개 이상의 콘텐츠 또는 체크아웃
`age_over_21`	`age_over_21`	21개 이상의 제품(미국 주류 등)
`age_over_25`	`age_over_25`	더 높은 연령 기준

Use these request types in your embed (data-checkify-request or Checkify.bindForm). On your server, verify with the matching claim in required_claims.

도메인 바인딩