Appearance

인증 화면 호출 ​

지원환경: React NativeWebView
실행환경: Toss App
SDK 최소버전: v1.2.2
토스앱 최소버전: v5.233.0

본인확인 요청 API 응답에서 받은 txId를 포함해 appsInTossSignTossCert를 호출해요.

토스앱 최소 버전 5.233.0 버전 이상에서 작동해요.

getTossAppVersion 함수를 사용하여 토스앱 버전을 체크해보세요.

tsx
import { appsInTossSignTossCert } from '@apps-in-toss/web-framework';

interface AppsInTossSignTossCertParams {
  txId: string; // 본인확인 요청 시 발급받은 txId
}

/**
 * Toss 인증서 화면을 txId 기반으로 호출합니다.
 *
 * 참고:
 * response는 인증 완료 확정 용도가 아닙니다.
 * 서버에서 txId 기준으로 결과조회 API를 호출해 최종 상태를 판별하세요.
 */
export async function openTossCertWithTxId(
  txId: string
): Promise<unknown> {
  try {
    const params: AppsInTossSignTossCertParams = { txId };
    const response = await appsInTossSignTossCert(params);
    return response;
  } catch (e: unknown) {
    // 호출 실패 처리 (사용자 취소/앱 미설치/스킴 실패 등)
    throw e;
  }
}
tsx
import { appsInTossSignTossCert } from '@apps-in-toss/framework';

interface AppsInTossSignTossCertParams {
  txId: string; // 본인확인 요청 시 발급받은 txId
}

/**
 * Toss 인증서 화면을 txId 기반으로 호출합니다. 
 *
 * 참고:
 * response는 인증 완료 확정 용도가 아닙니다.
 * 서버에서 txId 기준으로 결과조회 API를 호출해 최종 상태를 판별하세요.
 */
export async function openTossCertWithTxId(
  txId: string
): Promise<unknown> {
  try {
    const params: AppsInTossSignTossCertParams = { txId };
    const response = await appsInTossSignTossCert(params);
    return response;
  } catch (e: unknown) {
    // 호출 실패 처리 (사용자 취소/앱 미설치/스킴 실패 등)
    throw e;
  }
}

응답 ​

  • onSuccess
    • 파라미터 없음
  • onError
    • Error { code: string; message: string } (예: 사용자 취소, 앱 미설치, 스킴 실패 등)
ts
// 에러 타입 예시
type AppsInTossSignTossCertError = {
  code: string;
  message: string;
};

// try/catch로 onSuccess/onError 대응하기
try {
  await appsInTossSignTossCert({ params: { txId } });
  // onSuccess: 파라미터 없음
} catch (e: any) {
  const err: AppsInTossSignTossCertError = {
    code: e?.code ?? 'UNKNOWN',
    message: e?.message ?? String(e),
  };
  // onError: 에러 처리
}