Developers

키 발급부터
첫 점수까지

파트너 등록 → 키 발급 → 샌드박스 첫 조회 → 라이브 전환. 표준 REST, 서명된 응답, 재시도되는 웹훅, 4개 언어 SDK.

Quickstart

네 단계면 연동됩니다

파트너 등록 · 키 발급
파트너 포털에서 Client ID와 API 키를 받습니다. 샌드박스 키는 직접 발급합니다.
whoami로 확인
GET /fi/whoami로 키와 스코프를 확인합니다.
샌드박스 첫 점수 조회
고정 연습 주체와 고정 검증 케이스로 등급별 응답을 미리 받아 봅니다.
라이브 전환
체크리스트를 통과하면 같은 코드로 운영 환경에 붙습니다.

5-minute integration

한 번의 호출

# Consent-gated soft-pull score (deny-by-default)
curl -X POST https://trendy.storydot.kr/superapp/api/fi/score/query \
  -H "X-Client-Id: $CLIENT_ID" -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pairwiseSub":"pairwise-subject-id","purpose":"LOAN_UNDERWRITING"}'
# → { success, data: { score, tier, reasonCodes[…] } } · every query is audit-logged

import { verifyTierProof } from "@superwallet/verifier-sdk/zkp";
// Verify a zero-knowledge tier proof — no score revealed
const ok = await verifyTierProof({ proof, publicSignals, minThreshold: "3" }); // GOOD or better

// partner-sdks/java — scan a presented QR and verify the VP
var verifier = new SuperWalletVerifier(config);
var result = verifier.scanAndVerify(rawQr);
if (result.isValid()) { /* trusted DID subject */ }

from superwallet_verifier import SuperWalletVerifier
# VP/QR verification + SSO (parity with Java/PHP/TS)
verifier = SuperWalletVerifier(api_base_url="https://trendy.storydot.kr/superapp/api")
result = verifier.verify(verifier.parse_qr_data(qr_payload))

Partner API

핵심 엔드포인트

기본 URL https://trendy.storydot.kr/superapp/api · 헤더 인증 X-Client-Id + X-API-Key · 분당 60회.

메서드	경로	설명
POST	/fi/score/query	동의 기반 점수 조회 — 점수 · 등급 · 사유코드
POST	/fi/decision/evaluate	인수 조건에 대한 판정 평가
POST	/fi/score/batch	배치 조회 1~100건
POST	/fi/verify	제시된 자격증명 검증
POST	/api/v1/fi/proof/verify	영지식 등급 증명 검증 (scope proof:verify)
GET	/fi/score/history	점수 이력, 최대 365일
POST	/fi/consent/requests	동의 요청 생성
GET	/fi/consent/{id}	동의 상태 조회
GET	/fi/usage	사용량, 최대 92일
GET	/fi/whoami · /fi/health	키 확인 · 상태 확인

Built for production

운영을 위한 설계

Webhooks

서명되고, 재시도됩니다

이벤트 4종. X-HACS-Signature HMAC-SHA256 서명, 실패 시 1분 · 5분 · 30분 · 2시간 재시도.

Sandbox

결정적인 시험 환경

고정 연습 주체와 고정 검증 케이스, 등급별 응답으로 경계 조건까지 미리 시험합니다.

Recipes

등급컷 레시피

750 / 650 / 550 / 450 등급컷과 위험군별 여신 조건 참고표, 심사 흐름 예시를 제공합니다.

Errors

사유코드와 에러의 구분

재시도할 에러와 판정 사유를 명확히 나눈 에러코드 표와 HTTP 상태 규칙.

Issuers

발급기관 API

신청 → 심사 → 승인 → 기관 명의 발급. 실패하면 닫히는(fail-closed) 발급 경로.

Compliance

감사 가능한 모든 판정

동의 통제, 해시체인 접근로그, 모델 거버넌스, 결정 프로비넌스, 식별자 최소화.

SDKs

쓰는 언어 그대로

언어	패키지	버전
TypeScript · JavaScript	@superwallet/verifier-sdk (npm)	2.3.0
TypeScript · ZK	@superwallet/zk-kit (npm) — 운영 회로 21 ID	0.2.0
Java 17	com.superwallet (Gradle)	1.1.0
Python	superwallet-verifier	1.1.0
PHP 8.1+	superwallet/verifier-sdk (Composer)	—