첫 거래를 보내고,
위험 탐지 결과까지 확인하세요.

# private registry를 사용하는 경우
npm config set @guardian:registry https://fdsguard.co.kr/repository/npm-private/
pnpm add @guardian/fds-risk-sdk

import { GuardianFdsClient } from '@guardian/fds-risk-sdk';

const client = new GuardianFdsClient({
  baseUrl: 'https://api.fdsguard.co.kr',
  apiKey: process.env.GUARDIAN_API_KEY!,
  // 기존 호환 API용 옵션입니다. /v1 호출은 API 키로 사이트가 결정됩니다.
  siteCode: 'unused-for-v1',
  timeoutMs: 3000,
  retryAttempts: 5,
});

const now = new Date().toISOString();
const payload = {
  schema_version: '1.0',
  source_event_id: 'tid_demo_20260820_000001',
  occurred_at: now,
  sent_at: now,
  source_system: 'merchant-payment-server',
  event_type: 'PAYMENT_CAPTURE',
  merchant_external_id: 'merchant_10001',
  merchant: { legal_name: '주식회사 유앤아이위아', primary_domain: 'shop.example.kr' },
  business: { business_registration_no: '4558103507', business_type: 'CORPORATION' },
  transaction: { source_event_id: 'tid_demo_20260820_000001', type: 'PAYMENT', status: 'APPROVED', occurred_at: now, amount_minor: 18000, currency: 'KRW', channel: 'ECOMMERCE', tid: 'tid_demo_20260820_000001' },
  payment_method: { type: 'CARD', token: 'customer-payment-method-token' },
};

const idempotencyKey = 'pay_20260820_000001';
const accepted = await client.submitTransactionV1(payload, idempotencyKey);
const status = await client.getIngestionV1((accepted as any).ingestion_id) as {
  status?: string; evaluation_state?: string; ingestion_id?: string;
};

switch (status.status) {
  case 'EVALUATED':
    console.log('평가 완료:', status);
    break;
  case 'ACCEPTED':
  case 'STORED':
  case 'EVALUATING':
  case 'FAILED_RETRYABLE':
    // 아직 완료되지 않았습니다. 1~5초 간격으로 다시 조회합니다.
    console.log('평가 진행/재시도 중:', status.status);
    break;
  case 'FAILED_FINAL':
  case 'DLQ':
    // 자동 재시도를 멈추고 ingestion_id를 운영자에게 전달합니다.
    console.error('최종 실패:', status);
    break;
  default:
    console.warn('알 수 없는 ingestion 상태:', status);
}