송금인 동의 제출 - ORIS API 문서

송금인 약관 동의를 제출한다.

송금인 동의 제출 API는 POST 메소드로 호출되며, 상세 스펙 및 호출 예제는 아래와 같습니다.

요청메시지 URL

요청메시지 URL 표
HTTP URL	/api/oris/v1/users/{userId}/consents
HTTP Method	POST
Content-Type	application/json; charset=UTF-8

요청 메시지 명세

요청 메시지 명세
HTTP	항목	TYPE(길이)	필수	값	설명
Header	Authorization	string	Y	Bearer <access_token>	로그인 시 ORIS로부터 전송받은 access_token을 HTTP Header에 추가 [scope = inquiry]
Parameter	[inpath] userId	string(26)	Y	01JR9JH2S5SG85EJDZK4XYXBV4	송금인ID
Body	termId	string(26)	Y	01OL7JH2S5SG85EUKSK4XYXCR3	약관ID
	identityVerificationMethod	string(50)("FACE_TO_FACE_ID" \| "ID_COPY_REMOTE" \| "MOBILE_PHONE" \| "I_PIN" \| "DIGITAL_CERT" \| "CREDIT_CARD" \| "ONEPASS" \| "MOBILE_ID" \| "SIMPLE_SNS" \| "VIDEO_ID" \| "BIOMETRIC" \| "OTHER")	Y	FACE_TO_FACE_ID	동의자(법정대리인) 본인 인증 수단
	consenterName	string(100)	N	홍길동	동의자 이름, 법정대리인의 경우 대리인 성명
	additionalInfo	string(300)	N	-	동의 추가 정보, 법정대리인의 경우 아동과의 관계
	isUnderFourteen	boolean	N	true	동의자 나이 정보 (만 14세 미만 여부), '개인정보제3자제공' 동의 시 제출 필수

요청 메시지 형태

{
  "termId": "01OL7JH2S5SG85EUKSK4XYXCR3",
  "identityVerificationMethod": "FACE_TO_FACE_ID",
  "consenterName": "홍길동",
  "additionalInfo": "string",
  "isUnderFourteen": true
}

응답 메시지 명세

요청 메시지 명세
HTTP	항목	TYPE(길이)	필수	값	설명
Body	consentId	string(26)	Y	01OL7JH2S5SG85EUKSK4XYXCR3	동의ID
	termTypeName	string(50)	Y	개인정보제3자제공동의	동의 유형 이름
	consentAt	string(date-time)	Y	2025-06-01T18:02:56.303340+09:00	동의 일시
	isUnderFourteen	boolean	Y	false	만 14세 미만

응답 메시지 형태

{
  "consentId": "01OL7JH2S5SG85EUKSK4XYXCR3",
  "termTypeName": "개인정보제3자제공동의",
  "consentAt": "2025-06-01T18:02:56.303340+09:00",
  "isUnderFourteen": "boolean"
}

에러인 경우 응답 메시지 명세

요청 메시지 명세
HTTP	항목	TYPE(길이)	필수	값	설명
Body	message	string	N	요청에 실패했습니다.	오류 메시지
Body	code	string("ERROR" \| "BAD_REQUEST" \| "INVALID_REQUEST" \| "UNAUTHORIZED" \| "FORBIDDEN" \| "ACCESS_TOKEN_REQUIRED" \| "ACCESS_TOKEN_EXPIRED" \| "ACCESS_TOKEN_INVALID" \| "ACCESS_TOKEN_NOT_ENOUGH_PERMISSION" \| "AGENCY_NOT_FOUND" \| "AGENCY_NOT_ACTIVE" \| "AGENCY_NOT_APPROVED" \| "AGENCY_NOT_MATCH" \| "AGENCY_ACCESS_DENIED" \| "AGENCY_CODE_DUPLICATED" \| "MEMBER_NOT_FOUND" \| "MEMBER_NOT_ACTIVE" \| "MEMBER_NOT_MATCH" \| "MEMBER_PASSWORD_NOT_MATCH" \| "MEMBER_EMAIL_DUPLICATED" \| "MEMBER_PASSWORD_RESET" \| "MEMBER_PASSWORD_RESET_WITH_OLD" \| "MEMBER_PASSWORD_INVALID_FORMAT" \| "MEMBER_PASSWORD_FAIL_LIMIT_EXCEEDED" \| "MEMBER_PASSWORD_EXPIRED" \| "MEMBER_ACCOUNT_LOCKED" \| "MEMBER_PASSWORD_REUSED" \| "MEMBER_ACCESS_DENIED" \| "API_KEY_NOT_FOUND" \| "USER_NOT_FOUND" \| "USER_NOT_ACTIVE" \| "ACCOUNT_NOT_FOUND" \| "REMITTANCE_NOT_FOUND" \| "REMITTANCE_ALREADY_EXISTS" \| "REMITTANCE_ALREADY_CANCELED" \| "REMITTANCE_ACCOUNT_YEAR_MISMATCH" \| "THREAD_NOT_FOUND" \| "THREAD_ACCESS_DENIED" \| "POST_NOT_FOUND" \| "POST_ACCESS_DENIED" \| "COMMENT_NOT_FOUND" \| "COMMENT_ACCESS_DENIED" \| "FILE_NOT_FOUND" \| "FILE_ACCESS_DENIED" \| "FILE_ALREADY_ATTACHED" \| "FILE_DELETE_FAILED" \| "TERM_NOT_FOUND" \| "TERM_CANNOT_UPDATE" \| "TERM_CANNOT_DELETE" \| "TERM_CANNOT_SET_INITIATION_DATE" \| "TERM_CANNOT_WITHDRAW_INITIATION_DATE" \| "TERM_TYPE_NOT_FOUND" \| "CONSENT_REQUIRED" \| "CONSENT_NOT_FOUND" \| "CONSENT_NOT_MATCH" \| "GROUP_NOT_FOUND" \| "GROUP_UPDATE_FORBIDDEN" \| "GROUP_DELETE_FORBIDDEN" \| "BATCH_NOT_FOUND" \| "BATCH_CHUNK_NOT_FOUND")	N	ERROR	오류 코드

요청값이 제약 조건에 위반되는 경우 응답 메시지 형태(400)

{
  "code": "BAD_REQUEST",
  "message": "Failed to convert value of type 'java.lang.String' to required type 'java.lang.Boolean'"
}

메소드 인자 타입이 일치하지 않는 경우 응답 메시지 형태(400)

{
  "code": "BAD_REQUEST",
  "message": "Failed to convert value of type 'java.lang.String' to required type 'java.lang.Boolean'"
}

메소드 인자 검증 실패한 경우 응답 메시지 형태(400)

{
  "code": "BAD_REQUEST",
  "message": "Validation failed for argument at index 0 in method"
}

json 형식이 잘못된 경우 응답 메시지 형태(400)

{
  "code": "BAD_REQUEST",
  "message": "Malformed JSON request"
}

요청값이 잘못된 경우 응답 메시지 형태(400)

{
  "code": "BAD_REQUEST",
  "message": "Invalid argument"
}

인증 정보가 없는 경우 응답 메시지 형태(401)

{
  "code": "ACCESS_TOKEN_REQUIRED",
  "message": "Access token is required for authentication."
}

토큰 유효하지 않은 경우 (서명 검증 실패) 응답 메시지 형태(401)

{
  "code": "ACCESS_TOKEN_INVALID",
  "message": "Invalid access token signature."
}

개인정보보호서약서 동의가 필요한 경우 응답 메시지 형태(403)

{
  "code": "CONSENT_REQUIRED",
  "message": "Consent is required for 개인정보보호서약서",
  "missingConsentType": "개인정보보호서약서"
}

권한이 없는 경우 응답 메시지 형태(403)

{
  "code": "AGENCY_ACCESS_DENIED",
  "message": "Agency access denied"
}

토큰이 만료된 경우 응답 메시지 형태(403)

{
  "code": "ACCESS_TOKEN_EXPIRED",
  "message": "Access token has expired."
}

요청한 URL에 맞는 핸들러를 찾을 수 없는 경우 응답 메시지 형태(404)