출금 상태 추적

출금 생성은 비동기 처리의 시작입니다. OOLIN이 요청을 검증하고 온체인 전송을 처리한 뒤 최종 결과를 Wallet API에 반영합니다. 고객 백엔드는 출금을 생성한 뒤 상세 API로 결과를 조회합니다.

출금 조회

wallet_request GET "/withdrawals/$WITHDRAWAL_ID" | jq
wallet_request GET "/withdrawals?account_id=$ACCOUNT_ID&after_id=0&limit=100" | jq

고객 상태 해석

user_status	처리 의미	고객 백엔드 처리
PENDING	요청 접수 또는 검사	제한된 주기로 조회
PROCESSING	승인·서명 또는 온체인 실행	출금 대기 상태 유지
COMPLETED	온체인 전송 완료	tx_hash, completed_at 저장
FAILED	온체인 처리 실패	실패 기록과 잔액 복구 확인
REJECTED	처리 거절	사유 기록과 운영 대응
CANCELLED	요청 취소	요청 종료와 잔액 확인

최종 성공에는 다음 조건이 모두 필요합니다.

• user_status: "COMPLETED"
• status: "COMPLETED"
• 유효한 tx_hash

중간 PROCESSING 상태를 성공으로 처리하지 마십시오.

최종 잔액 확인

wallet_request GET "/accounts/$ACCOUNT_ID/balances/$ASSET_TYPE_ID" | jq

완료된 출금은 원장에 WITHDRAW / DEBIT으로 기록됩니다. 실패·거절·취소된 출금은 예약된 출금액과 수수료가 사용 가능 잔액으로 복구되었는지 확인합니다. 고객사 백엔드가 자체적으로 잔액을 조정하지 마십시오.

Polling 규칙

• 짧은 무한 루프 대신 제한된 주기와 backoff를 사용합니다.
• 고객 상태가 최종 상태가 되면 polling을 종료합니다.
• 지원 진단을 위해 관찰한 상태 전이와 request_id를 저장합니다.
• Cursor 목록은 신규 레코드만 발견하고 이후 상태 변경을 반복 반환하지 않으므로 비최종 항목은 ID로 조회합니다.

다음: Wallet 전체 흐름 구현