개발자

하나의 API로, 모든 제품에.

먼저 신원 확인을 한 뒤 후원 계정을 만들고, 그다음 바인드와 언락을 합니다. API 키는 여러분의 서버에 그대로 남습니다. 브라우저나 모바일 앱은 여러분의 백엔드와 통신하고, 그 백엔드가 저희와 통신합니다. WharfKit 지갑 세션과 패스키를 지원합니다.

const baseUrl = process.env.BOUND_IDENTITY_URL!;
const apiKey = process.env.BOUND_IDENTITY_API_KEY!; // server-side only

async function identityFetch(path, init) {
  const res = await fetch(baseUrl + path, {
    ...init,
    headers: {
      Authorization: "Bearer " + apiKey,
      Accept: "application/json",
      "Content-Type": "application/json",
      ...init?.headers,
    },
  });
  const body = await res.json();
  if (!res.ok) throw new Error(body.message || "HTTP " + res.status);
  return body;
}

// 1. Verify the person first — no chain account yet (default organization policy).
const { personDid, verificationUrl } = await identityFetch("/v1/kyc/start", {
  method: "POST",
  body: JSON.stringify({}),
});
// … open verificationUrl from your KYC provider …

// 2. When approved, take the one-time create token.
const { kycCreateToken } = await identityFetch(
  "/v1/kyc/status?personDid=" + encodeURIComponent(personDid),
);

// 3. Sponsor the provisional account. Token replay is rejected.
const { accountDid } = await identityFetch("/v1/accounts/free", {
  method: "POST",
  body: JSON.stringify({
    ownerPublicKey,
    personDid,
    kycCreateToken,
    // Production also requires emailProofToken + phoneProofToken
  }),
});

// 4. Bind the approved person to this account: the user signs once.
const { payloadToSign, message } = await identityFetch("/v1/bind/challenge", {
  method: "POST",
  body: JSON.stringify({ accountDid, personDid }),
});
await identityFetch("/v1/bind/confirm", {
  method: "POST",
  body: JSON.stringify({
    accountDid,
    personDid,
    nonce: message.nonce,
    signature, // WharfKit / passkey over payloadToSign
  }),
});

// 5. Lift faucet limits. Done.
await identityFetch("/v1/accounts/unlock", {
  method: "POST",
  body: JSON.stringify({ accountDid }),
});

신분증은 여러분의 코드를 거치지 않으며, 시크릿이 브라우저에 도달하지도 않습니다. 기본 조직은 KYC가 승인될 때까지 무료 계정 생성을 거부합니다. sandbox.identityinc.io 샌드박스에 먼저 연동하세요, 무료 테스트 확인, 시뮬레이션 체인, 그다음 프로덕션 트래픽을 Builder 또는 Growth로 옮기세요.