계좌 - 신한은행 간편조회
1. 신한은행 간편조회 계좌 목록 조회shinhan_ easy. accounts. list
MCP 도구 이름 shinhan_
POSThttps:// api. xdata. kr/ v1/ jobsX-Env-Scope: real_test
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
연결된 신한 계좌를 계좌번호와 별칭, 계좌 과목까지 한 번에 나열합니다.
- 세션 로그인 없이 호출합니다. 조회할 때마다 콘솔에 등록한 신한은행 간편조회 아이디와 비밀번호로 로그인합니다. [신한은행 간편조회 로그인]
- include_raw(기관 원본 값 포함 여부)는 선택입니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| provider | string | - | Y | 호출할 기관입니다.
| |
| action | string | - | Y | 호출할 작업입니다.
| |
| account_ | string | 36 | Y | 등록한 자격증명을 가리키는 아이디입니다. 이 기관은 자격증명을 자동으로 고르지 않으므로 생략할 수 없습니다. 생략하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | N | 작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| include_ | boolean | N | 기관 원본 응답을 결과의 raw 칸에 담을지 정하는 값으로, 보내지 않으면 true 입니다. 지금 조회 경로는 이 값을 쓰지 않습니다. raw 칸은 이 값과 관계없이 null 입니다 |
curl --request POST \
--url 'https://api.xdata.kr/v1/jobs' \
--header 'Authorization: Basic {base64(client_id:client_secret)}' \
--header 'X-Env-Scope: real_test' \
--header "Idempotency-Key: list-$(date +%s)-$RANDOM" \
--header 'Content-Type: application/json' \
--data '{
"provider": "shinhan_easy",
"action": "shinhan_easy.accounts.list",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {}
}'Response
- 아래 표의 칸은 작업이 SUCCEEDED 가 된 뒤 GET /v1/jobs/{job_id}/result 의 result.data 에 오고, 응답 예시는 작업을 제출했을 때(POST /v1/jobs)의 응답입니다.
- result.data 의 accounts 로 연결된 계좌 목록을(계좌번호, 별칭, 계좌 과목) 확인합니다. 계좌가 없으면 accounts 는 빈 목록이고 count 는 0 입니다.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| success | boolean | 요청 처리 성공 여부 | |
| account_ | string | 연동 ID | |
| count | number | 조회된 계좌 수(계좌가 없으면 0) | |
| accounts | array | 계좌 목록 - 계좌번호·별칭·계좌 과목을 담습니다 | |
| raw | object | null | 기관 원본 응답 자리 - 지금 조회 경로는 원본을 싣지 않아 include_raw 와 상관없이 null 입니다 |
{
"job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
"status": "QUEUED",
"env_scope": "real_test",
"provider": "shinhan_easy",
"action": "shinhan_easy.accounts.list",
"submitted_at": "2026-05-27T12:34:56+09:00"
}| 순번 | 오류 코드 | 발생 조건 |
|---|---|---|
| POLICY_ | 상품 실행 잠금 — 현재 이 상품은 일시 중지 상태라 요청을 처리하지 못했습니다. 다시 시도해도 해결되지 않으니 서비스문의로 알려 주세요. retryable=false. | |
| PROVIDER_ | 로그인 실패 — 등록한 아이디와 비밀번호로 신한은행 인증에 실패했습니다. retryable=false. | |
| VALIDATION_ | 입력값 오류 — 보낸 값이 이 액션의 요청 형식과 맞지 않습니다. 필수 칸이 빠졌거나 타입이나 범위가 맞지 않는 경우입니다. | |
| PROVIDER_ | 그 밖의 오류 — 그 밖의 신한은행 오류입니다. retryable=true 로 표시되지만 원인이 값 자체라면 재시도로 풀리지 않습니다 - 메시지를 먼저 확인합니다. |
2. 신한은행 간편조회 거래내역 조회shinhan_ easy. accounts. transaction_ history. search
MCP 도구 이름 shinhan_
POSThttps:// api. xdata. kr/ v1/ jobsX-Env-Scope: real_test
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
기간을 지정해 신한 계좌의 입출금 내역을 건별로 받습니다.
- 세션 로그인 없이 호출합니다. 조회할 때마다 콘솔에 등록한 신한은행 간편조회 아이디와 비밀번호로 로그인하고, bank_account_credential_id 로 고른 계좌의 등록 비밀번호를 함께 씁니다. [신한은행 간편조회 로그인]
- sort_order(기본값 desc)·business_type·employee_yn·max_pages(기본값 20)·include_raw 는 모두 선택입니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| provider | string | - | Y | 호출할 기관입니다.
| |
| action | string | - | Y | 호출할 작업입니다.
| |
| account_ | string | 36 | Y | 등록한 자격증명을 가리키는 아이디입니다. 이 기관은 자격증명을 자동으로 고르지 않으므로 생략할 수 없습니다. 생략하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | Y | 작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| bank_ | string | Y | 조회할 계좌의 ID 입니다. shinhan_easy.linked_accounts.list 결과의 links[].accounts[].bank_account_credential_id 값을 그대로 보내며, 요청의 account_link_id 연동에 등록된 사용 중인 계좌여야 합니다 | |
| start_ | string | Y | 조회 시작일입니다. YYYY-MM-DD 나 YYYYMMDD 형식으로 보내며 end_date 보다 늦을 수 없고, 형식이 맞지 않거나 순서가 거꾸로이면 거절합니다. 오늘(한국 시각)로부터 6개월 전보다 앞선 날짜는 입력 오류로 거절합니다 | |
| end_ | string | Y | 조회 종료일입니다. 형식은 start_date 와 같고 start_date 보다 빠를 수 없습니다 | |
| sort_ | string | N | 거래 정렬 순서로 desc 나 asc 를 보내며, 보내지 않으면 desc 입니다. desc 는 최근 거래부터, asc 는 오래된 거래부터 거래 일시 순으로 정렬해 돌려줍니다. 보낸 값은 결과의 query.sort_order 에 그대로 실립니다 | |
| business_ | string | N | 기관 거래내역 조회의 업무구분 값으로, 보내지 않으면 2 입니다. 지금 조회 경로는 이 값을 쓰지 않습니다 | |
| employee_ | string | N | 기관 거래내역 조회의 직원여부 값으로, 보내지 않으면 2 입니다. 지금 조회 경로는 이 값을 쓰지 않습니다 | |
| max_ | number | N | 이어서 받을 최대 쪽 수입니다. 1 이상 100 이하의 정수여야 하며 범위 밖이면 거절하고, 보내지 않으면 20 입니다. 지금 조회 경로는 이 값을 쓰지 않습니다 | |
| include_ | boolean | N | 기관이 돌려준 거래 원본 줄을 결과의 rows_raw 칸에 담을지 정합니다. 보내지 않으면 true 이고, false 이면 rows_raw 는 빈 목록입니다. raw 칸은 이 값과 관계없이 null 입니다 | |
| output_ | array | N | 이 결과를 엑셀(xlsx) 파일로도 받으려면 적습니다. 예: ["xlsx"]. 파일은 result.artifacts 에 함께 오고, 빼면 데이터만 옵니다 |
- 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
curl --request POST \
--url 'https://api.xdata.kr/v1/jobs' \
--header 'Authorization: Basic {base64(client_id:client_secret)}' \
--header 'X-Env-Scope: real_test' \
--header "Idempotency-Key: search-$(date +%s)-$RANDOM" \
--header 'Content-Type: application/json' \
--data '{
"provider": "shinhan_easy",
"action": "shinhan_easy.accounts.transaction_history.search",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {
"bank_account_credential_id": "<필수>",
"start_date": "<필수>",
"end_date": "<필수>",
"sort_order": "desc",
"business_type": "2",
"employee_yn": "2",
"max_pages": 20
}
}'Response
- result.data 의 rows 로 입출금 내역을 건별로 확인합니다.
- 여러 JSON 타입이 함께 표시된 칸은 서버가 세부 타입을 고정하지 않는 기관 원문 또는 동적 값입니다.예시 값의 타입으로 단정하지 말고 실제 값의 타입을 확인해 주세요. null은 값이 비어 있다는 뜻이며, 필드 자체의 생략 여부는 필수 여부와 설명을 확인해 주세요.
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| success | boolean | 조회를 마쳤다는 표지입니다. 성공 응답에서는 항상 true 입니다. | |
| account_ | string | 조회에 쓴 연동의 ID 입니다. 요청에 보낸 값입니다. | |
| query | object | 이번 조회에 실제로 쓴 조건입니다. | |
| query. | string | 조회한 계좌의 ID 입니다. 요청에 보낸 값입니다. | |
| query. | string | 가려진 계좌번호입니다. account.account_no 와 같은 값입니다. | |
| query. | string | 조회 시작일입니다. 요청에 보낸 값을 YYYY-MM-DD 모양으로 맞춘 문자열입니다. | |
| query. | string | 조회 종료일입니다. 요청에 보낸 값을 YYYY-MM-DD 모양으로 맞춘 문자열입니다. | |
| query. | string | 정렬 방향입니다. 요청에서 쓴 값(desc 또는 asc)이고, 보내지 않으면 desc 입니다. | |
| account | object | 조회한 계좌의 요약입니다. 지금 조회 경로에서는 account_no, account_no_display, legacy_account_no, raw_fields 네 칸만 담깁니다. | |
| account. | string | 가려진 계좌번호입니다. | |
| account. | string | 가려진 계좌번호입니다. account_no 와 같은 값입니다. | |
| account. | string | number | boolean | object | array | null | 기관의 「은행구분」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | null | 구 계좌번호 칸입니다. 이 응답에서는 항상 null 입니다. | |
| account. | string | number | boolean | object | array | null | 기관의 「구계좌사용여부」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 기관의 「계좌명」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | number | null | 계좌 잔액입니다. 숫자로 바꾼 값이고, 기관 값이 비었거나 숫자로 읽을 수 없으면 null 입니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 기관 화면에 보이는 모양의 계좌 잔액입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 기관의 「고객명」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | number | null | 출금 가능 금액입니다. 숫자로 바꾼 값이고, 기관 값이 비었거나 숫자로 읽을 수 없으면 null 입니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 기관 화면에 보이는 모양의 출금 가능 금액입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 계좌 신규 일자입니다. 8자리 숫자 날짜는 YYYY-MM-DD 로 바꾼 문자열이고, 그 모양이 아니면 앞뒤 공백을 뗀 기관 값이며, 비어 있으면 null 입니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 기관 화면에 보이는 모양의 신규 일자입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 기관의 「계좌관리점」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 최종 거래 일자입니다. 8자리 숫자 날짜는 YYYY-MM-DD 로 바꾼 문자열이고, 그 모양이 아니면 앞뒤 공백을 뗀 기관 값이며, 비어 있으면 null 입니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 기관 화면에 보이는 모양의 최종 거래 일자입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | number | boolean | object | array | null | 기관의 「연속시작번호」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | number | boolean | object | array | null | 기관의 「연속SUB시작번호」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | number | boolean | object | array | null | 기관의 「거래내역여부」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 기관이 알려 준 조회 시작일입니다. 8자리 숫자 날짜는 YYYY-MM-DD 로 바꾼 문자열이고, 그 모양이 아니면 앞뒤 공백을 뗀 기관 값이며, 비어 있으면 null 입니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 기관 화면에 보이는 모양의 조회 시작일입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 기관이 알려 준 조회 종료일입니다. 8자리 숫자 날짜는 YYYY-MM-DD 로 바꾼 문자열이고, 그 모양이 아니면 앞뒤 공백을 뗀 기관 값이며, 비어 있으면 null 입니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 기관 화면에 보이는 모양의 조회 종료일입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 기관이 알려 준 조회 일자입니다. 8자리 숫자 날짜는 YYYY-MM-DD 로 바꾼 문자열이고, 그 모양이 아니면 앞뒤 공백을 뗀 기관 값이며, 비어 있으면 null 입니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 기관 화면에 보이는 모양의 조회 일자입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 기관의 「조회시간」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | null | 기관 화면에 보이는 모양의 조회 시간입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | string | number | boolean | object | array | null | 기관의 「반복횟수」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다. | |
| account. | object | 항상 빈 객체입니다. 계좌 요약의 기관 원본은 담지 않습니다. | |
| count | number | rows 에 담긴 거래의 건수입니다. | |
| rows | array | 거래내역 목록입니다. 조건에 맞는 거래가 없으면 빈 배열입니다. 지금 조회 경로에서는 sort_order 와 관계없이 기관 화면이 준 순서 그대로입니다. | |
| rows[]. | string | null | 거래 일자입니다. 8자리 숫자 날짜는 YYYY-MM-DD 로 바꾼 문자열이고, 그 모양이 아니면 앞뒤 공백을 뗀 기관 값이며, 비어 있으면 null 입니다. | |
| rows[]. | string | null | 기관 화면에 보이는 모양의 거래 일자입니다. 기관이 준 값을 바꾸지 않고 담습니다. | |
| rows[]. | string | null | 거래 시각입니다. 6자리 숫자 시각은 HH:MM:SS 로 바꾼 문자열이고, 그 모양이 아니면 앞뒤 공백을 뗀 기관 값이며, 비어 있으면 null 입니다. | |
| rows[]. | string | null | 기관 화면에 보이는 모양의 거래 시각입니다. 기관이 준 값을 바꾸지 않고 담습니다. | |
| rows[]. | string | null | 기관의 「적요」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. | |
| rows[]. | number | null | 출금액입니다. 숫자로 바꾼 값이고, 기관 값이 비었거나 숫자로 읽을 수 없으면 null 입니다. | |
| rows[]. | string | null | 기관 화면에 보이는 모양의 출금액입니다. 기관이 준 값을 바꾸지 않고 담습니다. | |
| rows[]. | number | null | 입금액입니다. 숫자로 바꾼 값이고, 기관 값이 비었거나 숫자로 읽을 수 없으면 null 입니다. | |
| rows[]. | string | null | 기관 화면에 보이는 모양의 입금액입니다. 기관이 준 값을 바꾸지 않고 담습니다. | |
| rows[]. | string | null | 기관의 「내용」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. | |
| rows[]. | number | null | 그 거래 건의 잔액입니다. 숫자로 바꾼 값이고, 기관 값이 비었거나 숫자로 읽을 수 없으면 null 입니다. | |
| rows[]. | string | null | 기관 화면에 보이는 모양의 거래 건 잔액입니다. 기관이 준 값을 바꾸지 않고 담습니다. | |
| rows[]. | string | null | 기관의 「거래점」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. | |
| rows[]. | string | number | boolean | object | array | null | 기관의 「입지구분」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. | |
| rows[]. | string | number | boolean | object | array | null | 기관의 「거래번호」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. | |
| rows[]. | string | number | boolean | object | array | null | 기관의 「SUB거래번호」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. | |
| rows[]. | string | null | 기관의 「CMS코드」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. | |
| rows[]. | string | null | 거래 일시입니다. 거래 일자와 시각을 합친 YYYY-MM-DDTHH:MM:SS 모양의 문자열이며 시간대 표기는 없습니다. 일자나 시각을 읽을 수 없으면 null 입니다. | |
| rows[]. | object | 기관이 준 거래 한 줄의 원본 객체입니다. 칸 이름은 기관 쪽 이름이고, include_raw 와 상관없이 담깁니다. | |
| rows_ | array | 기관이 준 거래 줄의 원본 목록입니다. include_raw 가 false 이면 빈 배열입니다. | |
| continuation | object | 이어받기 정보입니다. 지금 조회 경로는 쪽을 이어받지 않으므로 아래 네 칸의 값이 늘 같습니다. | |
| continuation. | number | 기관에 요청한 쪽 수입니다. 지금 조회 경로에서는 항상 0 입니다. | |
| continuation. | boolean | 이어받을 거래가 더 남았는지를 나타냅니다. 성공 응답에서는 항상 false 입니다. | |
| continuation. | string | 마지막 쪽을 받을 때 쓴 이어받기 번호입니다. 지금 조회 경로에서는 항상 빈 문자열입니다. | |
| continuation. | string | 마지막 쪽을 받을 때 쓴 이어받기 SUB 번호입니다. 지금 조회 경로에서는 항상 빈 문자열입니다. | |
| raw_ | object | 기관 원본 응답에서 거래 줄과 계좌 요약이 있는 위치를 가리키는 객체입니다. 지금 조회 경로에서는 raw 가 null 이라 가리키는 원본이 결과에 없습니다. | |
| raw_ | string | 거래 줄(rows_raw)이 들어 있는 기관 응답 안의 위치입니다. | |
| raw_ | string | 계좌 요약의 원본이 들어 있는 기관 응답 안의 위치입니다. | |
| raw | object | null | 기관 응답 원본입니다. 지금 조회 경로에서는 include_raw 와 관계없이 null 입니다. | |
| raw. | array | 쪽마다 받은 기관 응답 원본의 목록입니다. 지금 조회 경로에서는 raw 가 null 이라 오지 않습니다. |
// result.data - 값 자리에는 각 칸의 형식을 적었습니다 (실제 값이 아닙니다)
{
"success": "<boolean>",
"account_link_id": "<string>",
"query": {
"bank_account_credential_id": "<string>",
"masked_account_no": "<string>",
"start_date": "<string>",
"end_date": "<string>",
"sort_order": "<string>"
},
"account": {
"account_no": "<string>",
"account_no_display": "<string>",
"bank_type": "<기관이 준 값>",
"legacy_account_no": null,
"legacy_account_enabled": "<기관이 준 값>",
"account_name": "<기관이 준 값>",
"balance": "<number | null>",
"balance_display": "<기관이 준 값>",
"customer_name": "<기관이 준 값>",
"withdrawable_amount": "<number | null>",
"withdrawable_amount_display": "<기관이 준 값>",
"open_date": "<string | null>",
"open_date_display": "<기관이 준 값>",
"branch_name": "<기관이 준 값>",
"final_transaction_date": "<string | null>",
"final_transaction_date_display": "<기관이 준 값>",
"continuation_start_no": "<기관이 준 값>",
"continuation_sub_start_no": "<기관이 준 값>",
"has_transaction_history_flag": "<기관이 준 값>",
"query_start_date": "<string | null>",
"query_start_date_display": "<기관이 준 값>",
"query_end_date": "<string | null>",
"query_end_date_display": "<기관이 준 값>",
"query_date": "<string | null>",
"query_date_display": "<기관이 준 값>",
"query_time": "<기관이 준 값>",
"query_time_display": "<기관이 준 값>",
"repeat_count": "<기관이 준 값>",
"raw_fields": {}
},
"count": "<number>",
"rows": [
{
"transaction_date": "<string | null>",
"transaction_date_display": "<기관이 준 값>",
"transaction_time": "<string | null>",
"transaction_time_display": "<기관이 준 값>",
"summary": "<기관이 준 값>",
"withdrawal_amount": "<number | null>",
"withdrawal_amount_display": "<기관이 준 값>",
"deposit_amount": "<number | null>",
"deposit_amount_display": "<기관이 준 값>",
"description": "<기관이 준 값>",
"balance": "<number | null>",
"balance_display": "<기관이 준 값>",
"branch_or_channel": "<기관이 준 값>",
"inout_code": "<기관이 준 값>",
"transaction_no": "<기관이 준 값>",
"sub_transaction_no": "<기관이 준 값>",
"cms_code": "<기관이 준 값>",
"transaction_datetime": "<string | null>",
"raw_fields": {}
}
],
"rows_raw": [],
"continuation": {
"requested_pages": "<number>",
"has_more": "<boolean>",
"next_transaction_no": "<string>",
"next_sub_transaction_no": "<string>"
},
"raw_field_map": {
"rows": "<string>",
"account": "<string>"
},
"raw": {
"responses": []
}
}| 순번 | 오류 코드 | 발생 조건 |
|---|---|---|
| POLICY_ | 상품 실행 잠금 — 현재 이 상품은 일시 중지 상태라 요청을 처리하지 못했습니다. 다시 시도해도 해결되지 않으니 서비스문의로 알려 주세요. retryable=false. | |
| PROVIDER_ | 로그인 실패 — 등록한 아이디와 비밀번호로 신한은행 인증에 실패했습니다. retryable=false. | |
| VALIDATION_ | 계좌 자격증명 오류 — 조회에 쓸 계좌를 찾지 못했습니다. bank_account_credential_id 가 없는 계좌이거나, 이미 해제됐거나, 요청한 연동(account_link_id)의 계좌가 아닌 경우이고, 연동한 계정을 찾지 못한 경우도 같은 코드입니다. error.provider_error_ref 는 shinhan_easy.bank_account_credential 입니다. retryable=false - error.message 가 안내하는 대로 계좌 목록에서 계좌를 다시 선택하거나 계정을 먼저 연동한 뒤 다시 요청합니다. | |
| VALIDATION_ | 입력값 오류 — 보낸 값이 이 액션의 요청 형식과 맞지 않습니다. 필수 칸이 빠졌거나 타입이나 범위가 맞지 않는 경우입니다. | |
| VALIDATION_ | 조회 기간 초과 — start_date 가 오늘(한국 시각)로부터 6개월 전보다 앞서면 기관에 묻기 전에 거절합니다. 기간을 좁혀 다시 요청합니다. retryable=false. | |
| VALIDATION_ | 고른 계좌 없음 — bank_account_credential_id 로 고른 계좌를 기관 화면의 계좌 목록에서 찾지 못해 거래내역을 열지 않았습니다. error.provider_error_ref 는 shinhan_easy.invalid_params.SHINHAN_RUNNER_ACCOUNT_NOT_IN_LIST 입니다. 재시도 불가로 표시됩니다(retryable=false) - 같은 요청을 다시 보내도 같은 목록이라 결과가 같습니다. error.message 안내대로 계좌번호를 확인하고 계좌 목록 조회에서 계좌를 다시 고릅니다. | |
| VALIDATION_ | 고른 계좌가 열리지 않음 — 기관에서 열린 계좌가 고른 계좌와 달라, 다른 계좌의 거래가 고른 계좌 이름으로 나가지 않도록 조회 결과를 돌려주지 않았습니다. error.provider_error_ref 는 shinhan_easy.invalid_params.SHINHAN_RUNNER_ACCOUNT_NOT_FIRST 입니다. 재시도 불가로 표시됩니다(retryable=false). 이유와 조회할 수 있는 계좌는 error.message 가 그대로 알려 줍니다. | |
| PROVIDER_ | 그 밖의 오류 — 그 밖의 신한은행 오류입니다. retryable=true 로 표시되지만 원인이 값 자체라면 재시도로 풀리지 않습니다 - 메시지를 먼저 확인합니다. |