메인 콘텐츠로 건너뛰기
POST
curl

경로 매개변수

token
string
필수

위젯 세션이 생성되었을 때 반환된 불투명 세션 token입니다.

본문

application/json
method
enum<string>
필수

최종 사용자가 선택한 증명 방식입니다. 컨텍스트의 allowed_methods 중 하나여야 합니다.

사용 가능한 옵션:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
wallet_address
string

기본값은 세션의 wallet_address입니다. 세션이 거래와 연결된 경우 거래의 지갑과 일치해야 합니다.

Maximum string length: 128
chain
string

기본값은 세션의 체인입니다.

Maximum string length: 32

응답

이 방식에 대해 이미 열려 있던 증명이 재개되었습니다.

proof_id
string<uuid>
method
enum<string>
사용 가능한 옵션:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
status
enum<string>

PENDING: 최종 사용자가 이 방식을 선택했으며 증명이 아직 결정되지 않았습니다. 실패한 서명 또는 아직 읽을 수 없거나 확인되지 않은 테스트 입금은 failure_reason과 함께 증명을 PENDING 상태로 유지하므로 최종 사용자가 다시 시도할 수 있습니다. 제출된 SATOSHI_TEST 입금은 유효 기간이 닫힐 때까지 자동으로 재확인되며, 제출된 SCREENSHOT은 검토를 대기합니다. VERIFIED: 소유권이 증명되었습니다. REJECTED: 테스트 입금이 확실히 잘못되었거나(다른 발신자, 입금 주소로 전송된 예상치 않은 금액, 챌린지보다 이전 시점, 또는 이미 다른 지갑을 증명한 거래) 검토자가 스크린샷을 거부했습니다. failure_reason에 구체적인 사유가 표시됩니다. 거부된 증명은 최종적이며 세션 시도 횟수 중 하나를 사용합니다. EXPIRED: 증명을 더 이상 결정할 수 없습니다(유효 기간 만료, 최종 사용자가 방식 변경, 위젯 세션 만료, 또는 지갑 보유자 변경). failure_reason에 구체적인 사유가 표시됩니다.

사용 가능한 옵션:
PENDING,
VERIFIED,
REJECTED,
EXPIRED
wallet_address
string
chain
string

증명이 대상인 주소록 항목의 표준 체인 식별자입니다(예: ETH, BTC, SOL, TRX).

deposit_address
string | null

고객이 사토시 테스트 금액을 보내야 하는 입금 주소입니다. SATOSHI_TEST 증명에만 존재합니다.

expected_amount
string | null

Satoshi 테스트 입금과 일치해야 하는 입금의 고유 통화로 표시된 정확한 온체인 금액입니다. SATOSHI_TEST 증명에만 존재합니다.

expires_at
string<date-time> | null

해당 증명 자체의 사토시 테스트 기간 마감 시한입니다. SATOSHI_TEST 증명에만 존재하며, SATOSHI_TEST가 제공될 경우 위젯 세션 자체의 expires_at이 이를 포함하도록 연장됩니다.

challenge
string | null

고객이 자신의 지갑으로 서명하는 Didit 발행 메시지입니다. MESSAGE_SIGNING 증명에만 존재합니다.

rejection_reason
string

증명이 거부된 이유(최종 사용자를 위한 영어 문장)입니다. status가 REJECTED일 때만 존재하며, 검토자가 스크린샷을 거부한 경우에는 비어 있습니다(검토자 메모는 외부에 공개되지 않음).

created_at
string<date-time>
attempts
integer

이 증명을 위해 증빙 자료(서명, 거래 ID, 업로드)가 제출된 횟수입니다.

failure_reason
enum<string>

마지막 시도가 실패한 이유 또는 증명이 종료된 이유입니다. 실패한 항목이 없으면 비어 있습니다.

사용 가능한 옵션:
,
SIGNATURE_INVALID,
SIGNATURE_UNSUPPORTED_SCHEME,
DEPOSIT_NOT_FOUND,
DEPOSIT_UNCONFIRMED,
DEPOSIT_LOOKUP_FAILED,
DEPOSIT_MISMATCH,
DEPOSIT_STALE,
TXID_REUSED,
CHAIN_UNSUPPORTED,
WINDOW_EXPIRED,
OWNERSHIP_CHANGED,
METHOD_SWITCHED,
REVIEW_REJECTED,
ABANDONED
마지막 수정일 2026년 11월 7일