참가기관 등록

신규 참가기관을 등록한다.

참가기관 등록 API는 POST 메소드로 호출되며, 상세 스펙 및 호출 예제는 아래와 같습니다.

요청메시지 URL
요청메시지 URL 표
HTTP URL/api/oris/v1/agencies
HTTP MethodPOST
Content-Typeapplication/json; charset=UTF-8
요청 메시지 명세
요청 메시지 명세
HTTP항목TYPE(길이)필수값설명
BodyagencyCode

string(4)

N

1004

참가기관코드
agencyType

string("은행" | "우정사업본부" | "증권사" | "카드사" | "소액송금업체")

Y

은행

참가기관구분
agencyConnectionType

string("직접" | "간접")

Y

직접

참가기관연결방식
name

string(100)

Y

조이은행

참가기관명
description

string(1000)

N

since 2024

참가기관 비고
representative

object

Y

-

참가기관 관리자
representative.name

string(100)

Y

윤조이

참가기관 관리자명
representative.email

string(320)

Y

oris@bok.or.kr

참가기관 관리자 이메일
representative.password

string(100)

Y

123456

참가기관 관리자 비밀번호
representative.phone

string(100)

Y

02-123-1234

참가기관 관리자 전화번호
representative.department

string(100)

Y

해외송금부서

참가기관 관리자 부서
representative.description

string(1000)

N

ORIS 담당

참가기관 관리자 메모
요청 메시지 형태
{
  "agencyCode": "1004",
  "agencyType": "은행",
  "agencyConnectionType": "직접",
  "name": "조이은행",
  "description": "since 2024",
  "representative": {
    "name": "윤조이",
    "email": "oris@bok.or.kr",
    "password": "123456",
    "phone": "02-123-1234",
    "department": "해외송금부서",
    "description": "ORIS 담당"
  }
}
응답 메시지 명세
요청 메시지 명세
HTTP항목TYPE(길이)필수값설명
BodyagencyId

string(26)

Y

01JPPEG5B48T1JFNJ895GHJZRZ

참가기관ID
agencyCode

string(4)

N

1004

참가기관코드
agencyType

string("은행" | "우정사업본부" | "증권사" | "카드사" | "소액송금업체")

Y

은행

참가기관구분
agencyConnectionType

string("직접" | "간접")

Y

직접

참가기관연결방식
name

string(100)

Y

조이은행

참가기관명
description

string(1000)

N

since 2024

참가기관 비고
representativeEmail

string(320)

Y

oris@bok.or.kr

참가기관 대표 관리자 이메일
createdBy

string<json>(1000)

Y

생성자
createdBy.name

string

Y

윤조이

-
createdBy.email

string

Y

joy@bok.or.kr

-
createdAt

string(date-time)

Y

2025-06-30T18:02:56.303340+09:00

생성일시
modifiedAt

string(date-time)

Y

2025-06-30T18:02:56.303340+09:00

수정일시
modifiedBy

string<json>(1000)

Y

수정자
modifiedBy.name

string

Y

윤조이

-
modifiedBy.email

string

Y

joy@bok.or.kr

-
응답 메시지 형태
{
  "agencyId": "01JPPEG5B48T1JFNJ895GHJZRZ",
  "agencyCode": "1004",
  "agencyType": "은행",
  "agencyConnectionType": "직접",
  "name": "조이은행",
  "description": "since 2024",
  "representativeEmail": "oris@bok.or.kr",
  "createdBy": {
    "name": "윤조이",
    "email": "joy@bok.or.kr"
  },
  "createdAt": "2025-06-30T18:02:56.303340+09:00",
  "modifiedAt": "2025-06-30T18:02:56.303340+09:00",
  "modifiedBy": {
    "name": "윤조이",
    "email": "joy@bok.or.kr"
  }
}
에러인 경우 응답 메시지 명세
요청 메시지 명세
HTTP항목TYPE(길이)필수값설명
Bodymessage

string

N

요청에 실패했습니다.

오류 메시지
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"
}
요청한 URL에 맞는 핸들러를 찾을 수 없는 경우 응답 메시지 형태(404)
{
  "code": "BAD_REQUEST",