FOR DEVELOPERS & AGENTS
입금 누락 · 정산 차이 대사
온라인 사업자·회계 자동화 에이전트용. 예정 정산과 실제 입금 목록을 참조 ID·통화별로 대조해 누락, 예상 외 입금, 차액, 중복 참조를 보고합니다. 금액은 최소 화폐 단위 정수 문자열로 입력합니다. 수작업 대사 시간을 줄이는 용도이며 은행 연결·세무 판단·환율 계산은 포함하지 않습니다.
판매 준비 중 · 현재 결제 불가
최대 64 KiB 입력. CSV와 표 데이터는 최대 1,000행·50열입니다. 결과를 만들 수 없는 입력은 결제 전에 거절합니다.
샘플 전체 JSON
입력하고 실행하기
민감한 개인정보·API 키·비밀번호는 입력하지 마세요. 결제 요청과 결과는 거래 기록으로 보관합니다.
전체 결과 · 결제 영수증 JSON
같은 결제 요청의 재시도는 저장된 결과를 반환합니다. 결제가 불확실하면 새 결제 대신 운영자에게 결제 참조값으로 문의하세요.
에이전트·개발자 연결
POST https://api.tumn.com/v1/products/settlement-reconciliation
CI/CD 배포 검사, 웹훅 재처리, 장애 분석 등 필요한 단계에서 상품 API를 호출하세요. 별도 회원가입 없이 고정 샘플을 확인할 수 있습니다.
Node.js · fetch 연결 예시
// Free fixed sample: no wallet and no charge
const sampleResponse = await fetch("https://api.tumn.com/products/settlement-reconciliation/sample");
if (!sampleResponse.ok) throw new Error('Sample unavailable');
const sample = await sampleResponse.json();
console.log(sample.result);
// Request payment terms; this does not sign or send money
const response = await fetch("https://api.tumn.com/v1/products/settlement-reconciliation", {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(sample.input)
});
console.log(response.status, await response.json());
// 402: review x402 terms with your spending policy before signing.
// 503: sales paused or service unavailable. Do not create a payment.결제 · 오류 · 재시도 처리
400은 입력 수정, 402는 결제 조건·서명 검토, 403은 자기 구매 차단, 429는 요청 제한, 503은 판매 중지·검증 대기·일시적 서비스 불가입니다. 409 또는 결제 결과가 불확실한 경우 새 서명을 자동 생성하지 마세요.
결제 활성화 시에만 x402 v2 조건을 제공합니다. 에이전트는 요청당 예산·누적 지출 한도와 수취인·금액·네트워크·USDC 계약·상품 URL을 검증한 뒤 서명해야 합니다. 재시도에는 같은 결제와 동일 요청 본문을 사용합니다.