송금인 송금 내역 상세 조회

송금인이 참가기관이 제공하는 프로그램에서 본인의 송금 내역 단건을 조회한다.

(모든 참가기관에서 제출한 개인별, 금융기관별 송금내역(송금/정정/퇴결)의 조회가 가능하며 송금인 정보 제공 동의 필요)

보안통신흐름

송금인 송금 내역 상세 조회 API는 GET 메소드로 호출되며, 상세 스펙 및 호출 예제는 아래와 같습니다.

요청메시지 URL
요청메시지 URL 표
HTTP URL/api/oris/v1/users/{userId}/remittances/{businessMessageIdentifier}
HTTP MethodGET
요청 메시지 명세
요청 메시지 명세
HTTP항목TYPE(길이)필수값설명
HeaderAuthorizationstringYBearer <access_token>로그인 시
ORIS로부터 전송받은
access_token을
HTTP Header에 추가
[scope = inquiry]
Parameter[inpath] userIdstring(26)Y01JR9JH2S5SG85EJDZK4XYXBV4송금인ID
[inpath] businessMessageIdentifierstring(21)Y202412161004000000000송금 일련번호
응답 메시지 명세
요청 메시지 명세
HTTP항목TYPE(길이)필수값설명
BodybusinessMessageIdentifier

string(21)

Y

202412161004000000000

송금 일련번호 : 참가기관이 발급한 모든 요청별 고유한 송금 일련번호({날짜+참가기관코드+일련번호9자리숫자})
sender

object

Y

-

송금인 정보
sender.userName

string(100)

Y

류가람

송금인명
sender.userType

string

Y

내국인

송금인 구분
sender.userCountry

string(10)

Y

KR

송금인 국가
agency

object

Y

-

송금 기관 정보
agency.agencyName

string(100)

Y

한국은행

참가기관명
agency.agencyId

string(26)

Y

01JPPEG5B48T1JFNJ895GHJZRZ

참가기관ID
histories[]

array<object>

N

-

연관 내역
histories[].requestDate

string(date-time)

N

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

송금 일시
histories[].usdExchangeAmount

number

N

870

송금액(USD환산금액)
histories[].status

string

Y

신규

송금 상태
histories[].createdAt

string(date-time)

N

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

신고 일시
응답 메시지 형태
{
  "businessMessageIdentifier": "202412161004000000000",
  "sender": {
    "userName": "류가람",
    "userType": "내국인",
    "userCountry": "KR"
  },
  "agency": {
    "agencyName": "한국은행",
    "agencyId": "01JPPEG5B48T1JFNJ895GHJZRZ"
  },
  "histories": [
    {
      "requestDate": "2025-06-30T18:02:56.303340+09:00",
      "usdExchangeAmount": 870,
      "status": "신규",
      "createdAt": "2025-06-30T18:02:56.303340+09:00"
    }
  ]
}
에러인 경우 응답 메시지 명세
요청 메시지 명세
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"
}
인증 정보가 없는 경우 응답 메시지 형태(401)
{
  "code": "ACCESS_TOKEN_REQUIRED",
  "message": "Access token is required for authentication."
}
토큰 유효하지 않은 경우 (서명 검증 실패) 응답 메시지 형태(401)
{
  "code": "ACCESS_TOKEN_INVALID",
  "message": "Invalid access token signature."
}
개인정보제3자제공 동의가 없는 경우 응답 메시지 형태(403)
{
  "code": "CONSENT_REQUIRED",
  "message": "Consent is required for 개인정보제3자제공",
  "missingConsentType": "개인정보제3자제공"
}
개인정보보호서약서 동의가 필요한 경우 응답 메시지 형태(403)
{
  "code": "CONSENT_REQUIRED",
  "message": "Consent is required for 개인정보보호서약서",
  "missingConsentType": "개인정보보호서약서"
}
권한이 없는 경우 응답 메시지 형태(403)