상태 코드

OOLIN은 상세 처리 상태를 유지하며 필요한 경우 단순화된 고객용 상태를 제공합니다.

출금의 고객 상태 (user_status)

아래 표는 출금의 user_status입니다. 출금의 상세 status에는 REQUESTED, HOT_STAGE, HOT_FAILED 같은 별도 값이 있으므로 두 필드를 같은 enum으로 처리하지 않습니다.

상태	의미	최종 상태
PENDING	접수 후 컨펌 또는 검사 대기	아니오
PROCESSING	승인·서명 또는 블록체인 실행	아니오
COMPLETED	성공적으로 확정	예
FAILED	처리 실패	예
REJECTED	정책 또는 운영 거절	예
CANCELLED	완료 전 취소	예

내부이체는 일반적으로 빠르게 완료되지만 거래 상세로 결과를 확인해야 합니다. 외부 출금은 여러 중간 상태를 거치며 완료 상태와 유효한 tx hash가 있어야 성공입니다.

입금은 필요한 컨펌과 정책 처리가 끝날 때까지 대기합니다. Cursor 탐지는 이후 상태 변경을 다시 반환하지 않으므로 비최종 레코드는 ID로 polling합니다.

출금은 진단과 대사를 위해 원본 status와 user_status를 모두 저장하십시오.

입금의 상세 상태 (status)

입금 목록·상세는 user_status 대신 status를 반환합니다. 외부 입금 상태는 다음과 같이 해석합니다.

status	처리 관점
PENDING, INSPECTED, APPROVE_PENDING, APPROVED, VERIFIED	컨펌·검사·승인·검증 과정. 입금 완료로 처리하지 않고 상세 조회를 계속합니다.
REFUND_REQUIRED, REFUND_REQUESTED, REFUND_PENDING	환불 절차 대상 또는 진행 중. 입금 완료로 적립하지 않고 운영 대응과 상태 추적을 유지합니다.
COMPLETED	입금 완료. 고객 입금 완료 판단에 사용합니다.
REFUNDED	환불로 종료. 고객 입금 성공으로 처리하지 않습니다.
FAILED	처리 실패. 고객 입금 성공으로 처리하지 않습니다.

내부 입금 조회는 PENDING 또는 COMPLETED로 표시됩니다. 개별 결제의 성공 여부는 원본 내부이체의 출금 상세로 확인합니다. refund_withdrawal_id는 현재 계약에서 항상 null이므로 환불 출금 ID가 제공된다고 가정하지 않습니다. 필드별 계약은 API Reference를 확인하십시오.

상태 전이 처리

이전·새 상태와 관찰 시각을 저장합니다. 검증된 전이에서만 고객 알림과 되돌릴 수 없는 업무 효과를 실행하고, 같은 응답을 두 번 처리해도 안전하도록 handler를 멱등하게 구현합니다.

예상보다 오래된 상태는 지연된 read나 replica 관찰일 수 있으므로 최종 업무 상태를 자동으로 되돌리지 않습니다. 최종 상태 이후 모순되는 응답은 리소스 ID와 request ID를 포함해 조사합니다.

지역화 label은 표시 시점에만 사용하며 모니터링·저장·대사는 안정적인 enum 값을 사용합니다.