Service
고객이 로그인한 세션으로 신한은행 인터넷뱅킹 정보를 읽기 전용으로 조회합니다. 잔액을 포함한 전체 계좌 목록, 요구불 계좌 상세와 거래 내역, 간편이체 결과 합계, 일별 외환 환율 고시를 제공합니다.
74.34%30일 가동률평균 응답775ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/shinhan-bank/account-details | Returns the current balance, withdrawable amount, status, last transaction date, and service or restriction flags for one demand-deposit account. Use when the caller already has a twelve-character account_number from shinhan-bank:accounts and needs that account's current detail. Do NOT use to discover accounts — use shinhan-bank:accounts instead. Do NOT use for transaction history — use shinhan-bank:transactions instead. Only demand-deposit accounts (product subject code 110) are supported: an account_number this provider can rule out before calling the bank fails with INVALID_REQUEST, and one the bank itself refuses fails with UPSTREAM_REJECTED. Returns account_number, product_name, account_management_branch_code, balance_krw, withdrawable_amount_krw, opened_date, last_transaction_date, checked_at, status, unrecognized_status_code, and flags. | |
| POST | /v1/shinhan-bank/accounts | Lists every account in the signed-in customer's Shinhan Bank portfolio with balance, withdrawable amount, product codes, deposit type, status, and service flags. Use when the caller needs to discover account numbers or see all balances at once; no input is required. Do NOT use for one account's current detail — use shinhan-bank:account-details instead. Do NOT use for transaction history — use shinhan-bank:transactions instead. Returns items, returned_count, and total_balance_across_returned_accounts_krw. | |
| POST | /v1/shinhan-bank/easy-transfer-results | Returns the customer's easy-transfer (간편이체) result totals for an inclusive date window of at most one calendar year. Use when the caller needs the transfer, error, and fee amount totals for easy transfers in a period; start_date and end_date are required. Do NOT use for per-account transaction rows — use shinhan-bank:transactions instead. Individual result rows are not returned: items is always empty because the bank's row format has not been confirmed, and a request that does return rows fails with UPSTREAM_SCHEMA_ERROR. Returns start_date, end_date, checked_at, items, returned_count, transfer_amount_total_krw, error_amount_total_krw, and fee_amount_total_krw. |
key가 호출할 수 있는 서비스와 API의 범위를 정의합니다.
멱등한 호출의 재시도 규칙과 backoff 동작을 설명합니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
| POST | /v1/shinhan-bank/fx-rate-board | Returns Shinhan Bank's latest published foreign-exchange rate board for one past or current weekday business date: telegraphic-transfer, cash, and traveller's-cheque buy and sell rates and the base rate in KRW per currency quote unit, plus the USD cross rate for each currency. Use when the caller needs the bank's posted exchange rates for a given date. Do NOT use for account balances or transactions — use shinhan-bank:accounts or shinhan-bank:transactions instead. publication_date must be a weekday and not in the future in Korea Standard Time; dates the bank rejects, such as bank holidays, fail with UPSTREAM_REJECTED and are not worth retrying. Returns published_at, publication_round, items, and returned_count. |
| POST | /v1/shinhan-bank/transactions | Lists the transactions of one demand-deposit account within an explicit inclusive date window, newest first by default. Use when the caller has an account_number from shinhan-bank:accounts and needs its transaction history for a specific period; start_date and end_date are required and sort_by may be oldest_first or newest_first. Do NOT use for the account's current balance or flags — use shinhan-bank:account-details instead. Do NOT use for easy-transfer result totals — use shinhan-bank:easy-transfer-results instead. The response has no cursor or row limit; has_more is false when the bank reports the end of history and null for an unrecognized history-state code. Returns account_number, items, returned_count, has_more, and unrecognized_history_state_code. |
