사용자 계정 연동 상태 검증

DOSI SDK는 사용자 관련 작업을 처리하거나 사용자 정보를 조회할 때, 사용자 월렛이 해당 작업을 처리할 수 있는 상태인지 미리 검증합니다. 검증 결과 처리할 수 없는 상태라면 오류 응답을 반환합니다.

API를 호출하기 전에 파트너사가 직접 상태를 확인할 수 있습니다. 사용자 계정 연동 상태 조회 엔드포인트를 사용하세요.

사용자 계정 연동 상태

상태 종류는 아래와 같습니다.

상태 이름	설명	API 호출 제한
Channel Linkage Available	사용자가 파트너사 DOSI 채널 연동에 동의해 서비스를 받을 수 있는 상태. 이 상태가 되려면 아래 2가지 조건을 만족해야 합니다. DOSI 사용자 계정이 정상 상태 사용자가 해당 파트너사 DOSI 채널을 연동하기로 동의한 상태	제한 없음
No User Agreement	사용자가 파트너사 DOSI 채널 연동에 동의하지 않았거나 연동 동의를 취소해 서비스를 받을 수 없는 상태	일부 API 호출 제한
User Suspended	사용자 계정이 일시적으로 정지돼 서비스를 받을 수 없는 상태	일부 API 호출 제한
User Unregistered	사용자 계정이 삭제돼 서비스를 받을 수 없는 상태	API 처리 불가

추후 상태 종류가 늘어날 수 있습니다.

오류 응답

사용자 계정 연동 상태 검증 실패로 API를 처리하지 못하는 경우에는 다음과 같은 오류 응답을 반환합니다.

• HTTP 상태 코드: 409 Conflict

• HTTP 응답 본문 (JSON 형태)

  이름	유형	설명	주의 사항
  responseCode	String	사용자 계정 연동 상태. 다음 중 하나입니다. NO_USER_AGREEMENT USER_SUSPENDED USER_UNREGISTERED	이 문서에 나열하지 않은 값을 받으면 무시하세요. 추후 상태 종류가 늘어날 수 있습니다.
  errorMessage	String	상세 오류 메시지	사람이 이해할 용도로 전달하는 정보이므로, 사전 고지 없이 바뀔 수 있습니다. 클라이언트에서 데이터를 처리할 때 이 메시지를 사용하지 마세요.

응답 예시

아래는 사용자 계정 연동 상태 검증이 실패했을 때의 응답 예시입니다.

No User Agreement

{
  "responseCode": "NO_USER_AGREEMENT",
  "errorMessage": "*** This is a message for human readers, not for computers. ***"
}

User Suspended

{
  "responseCode": "USER_SUSPENDED",
  "errorMessage": "*** This is a message for human readers, not for computers. ***"
}

User Unregistered

{
  "responseCode": "USER_UNREGISTERED",
  "errorMessage": "*** This is a message for human readers, not for computers. ***"
}

검증 대상 엔드포인트

아래 표는 사용자 계정 연동 상태 검증 대상 엔드포인트별로 상태에 따른 실행 가능 여부를 보여줍니다.

엔드포인트	Channel Linkage Available	No User Agreement	User Suspended	User Unregistered
프록시(proxy) 상태 조회
프록시(proxy) 설정 요청
프록시(proxy) 설정 요청 커밋
프록시(proxy) 설정 중 인증 상태 조회
디지털 아이템 목록 조회 (deprecated)
디지털 아이템 목록 조회
실링
배치 실링	Note	Note	Note	Note
언실링
배치 언실링
재실링
사용자가 판매 중인 디지털 아이템 조회
사용자가 판매 중인 디지털 아이템 판매 취소
판매 취소 상태 조회

배치 실링 실행 조건

사용자 월렛을 2개 이상 지정한 경우, 모든 사용자 월렛의 연동 상태가 조건을 충족해야 API를 처리할 수 있습니다.