AYS 딥리서치 — 신뢰강화 4기능 구현 디테일

핵심 결론

어뷰징 탐지·정산 reconcile는 키 없이 즉시 가능. 국세청 API는 data.go.kr 활용신청(2~3영업일) 후. 페널티는 정책 선행.

1. 국세청 사업자등록 API (구현 직결)

• 엔드포인트: https://api.odcloud.kr/api/nts-businessman/v1/validate(진위확인) · /status(상태조회)
• POST JSON, Content-Type: application/json, 쿼리 serviceKey(URL인코딩 발급키)
• 바디: {"businesses":[{"b_no":"10자리","start_dt":"YYYYMMDD","p_nm":"대표자명"}]} — b_no 필수, 진위확인은 start_dt+p_nm 추가
• 응답: b_stt(계속/휴업/폐업), tax_type, end_dt, valid(Y/N)
• 키: data.go.kr 가입→활용신청→승인(2~3일)→serviceKey. 일 1,000건 무료(초기 충분)
• 스푸핑 방지: b_no 단독 불가, 대표자명(p_nm) 대조 필수

2. 담합·어뷰징 임계값

• 동일 구매자-판매자 쌍: 30일 3회+ & 클레임0 → 플래그, 7일 5회+ → 즉시 수동검토
• 클레임 이상: 완료 24h내 분쟁, 단기 다수 동시분쟁 = 사기성
• 디바이스/IP fingerprint 다중계정, 순환거래(A→B→A wash trading)
• 대응: 시그널 1~2=추가인증, 3+=수동검토, 명백 순환=즉시정지. 정상 마찰 최소화

3. 단계적 페널티 (우리 구현 정밀화 포인트)

• 초범 경감(경고+랭킹하락) — 공급자 이탈 방지 핵심
• 재범 판단 = 90일 rolling window(우리 구현 6개월 → 90일로 조정 권장)
• 3차 영구퇴출 검토, 1년 무위반 시 카운터 리셋
• 양면시장: 공급자 이탈 피해 큼 → 초범 경감 강하게, 재참여 인센티브 병행

4. 정산 Reconciliation (우리 reconciler 강화 포인트)

• Idempotency Key: 모든 지급에 UUID(권장 거래ID+ts 해시) → PG 중복처리 차단
• 지수 백오프 1→2→4…32s, 최대 5회 → DLQ
• DLQ 10분/1h 배치 재처리, 24h 미처리 → 관리자 알림
• 3상태(pending/settled/failed) + 유니크 제약 UPSERT

우리 구현과의 정합 (Workflow 산출 대비 조정점)

• 담합탐지.한선 임계(3건+클레임0) = 연구값 일치 ✓ (기간을 30일로 명시 권장)
• 단계페널티.한선 window 6개월 → 90일로 조정 + 1년 무위반 리셋 추가 권장
• 정산재연동.한선 posted 플래그 → idempotency key + 지수백오프 강화 권장
• 사업자검증: 키 발급 후 /validate 연동 (현재 pending/수동 모드로 빌드). p_nm 대조 필수

출처

data.go.kr 공지 / Velog·r2bit 사업자API 가이드 / SEON·RST·Sardine 마켓 사기탐지 / Chattermill·Kreezalid 양면시장 리텐션