이자·배당 정보를 서비스 안으로: 에이픽 금융소득 조회 API 활용 가이드

11월 01, 2026

에이픽 금융소득 조회의 범위를 이해하고 귀속연도별 이자·배당 데이터를 사용자 화면에 구성하는 방법입니다.

사용자가 자기 기록을 확인하는 새로운 동선

개인 정보를 다루는 서비스를 기획할 때 사용자가 자료를 찾아 숫자를 다시 입력하는 단계를 줄이고 싶을 수 있습니다. 이자와 배당 정보를 확인하는 기능도 같은 관점에서 살펴볼 수 있습니다. 먼저 사용자가 어떤 기록을 보고 싶어 하는지 정의하고, 필요한 자료만 연결하는 화면을 설계해 보세요.

에이픽의 금융소득 조회 API는 본인인증 후 귀속연도별 이자·배당의 건수와 소득금액, 세액 합계 등을 확인하는 기능입니다. 근로소득이나 사업소득을 모두 포함하는 전체 소득 조회로 소개하지 않고, 금융소득이라는 범위를 명확히 표시하는 것이 좋습니다.

**화면 1. 에이픽 공개 홈페이지에서 신규·인기 API 둘러보기**
공식 사이트 실제 화면 · 캡처 2026-11-01 · 원본 페이지 확인

첫 화면은 연도 선택부터 단순하게

연도별 자료를 보여 주는 서비스라면 사용자가 어느 시점을 보고 있는지 항상 알 수 있어야 합니다. 제목에 선택한 귀속연도를 표시하고 다른 연도로 이동해도 표의 의미가 바뀌지 않도록 구성하세요. 여러 연도를 비교할 때는 같은 항목끼리 비교할 수 있는 화면 구조를 먼저 정하는 편이 좋습니다.

조회 결과가 비어 있는 상황도 화면 설계에 포함해 보세요. 자료가 없는 것과 아직 조회가 끝나지 않은 것은 다릅니다. 처음부터 숫자 0을 넣어 보여 주기보다 대기, 완료, 내역 없음 상태를 구분하면 사용자가 결과를 더 정확하게 이해할 수 있습니다.

화면 2. 연동 준비 참고 화면 · 공식 시작 가이드: 인증키 확인 경로와 서버 환경변수 보관 안내 — APICK 공식 공개 화면(2026-10-28), 실제 API 호출 결과가 아닙니다. 보관 캡처로 현재 화면과 다를 수 있습니다.
공식 사이트 실제 화면 · 보관 캡처(현재 화면과 다를 수 있음) · 캡처 2026-10-28 · 원본 페이지 확인

합계 카드와 상세 표의 역할 나누기

상단에는 현재 확인하는 연도와 주요 합계를 배치하고, 아래에서는 항목별 내용을 살펴볼 수 있도록 구성하는 방안을 제안합니다. 화면을 한 번에 복잡하게 만들기보다 사용자가 필요한 정보를 단계적으로 펼칠 수 있게 하세요. 실제 표시할 필드는 공식 응답 명세에서 제공되는 항목을 기준으로 결정합니다.

단위와 항목 이름은 모든 화면에서 일관되게 관리하세요. 금액과 건수의 정렬 방식, 빈 값 표시, 소수점 처리 같은 작은 규칙이 정리되어 있으면 사용자가 표를 읽기 편해집니다. 합계와 상세 데이터를 함께 보여 줄 때는 어떤 기준으로 집계된 값인지도 짧게 안내하는 것이 좋습니다.

화면 3. 연동 준비 참고 화면 · 공식 정적 cURL 요청 예시. 실제 키·API 호출·성공 결과가 아님 — APICK 공식 공개 화면(2026-10-28), 실제 API 호출 결과가 아닙니다. 보관 캡처로 현재 화면과 다를 수 있습니다.
공식 사이트 실제 화면 · 보관 캡처(현재 화면과 다를 수 있음) · 캡처 2026-10-28 · 원본 페이지 확인

내 기록 확인과 계산 도구는 구분해서 확장하기

조회한 기록을 보여 주는 기능을 먼저 완성한 뒤, 별도의 분석 기능이 필요한지 검토해 보세요. 조회 데이터가 있다는 이유만으로 세액을 확정하거나 신고 결과를 자동으로 판단하는 화면을 만들 필요는 없습니다. 사용자가 지금 확인하는 정보의 범위와 서비스가 수행하는 추가 계산을 구분하면 설명이 명확해집니다.

분석 화면을 기획한다면 입력 자료, 계산 기준, 기준 시점을 각각 표시하는 구성을 고려하세요. 정보 확인을 위한 원본 응답과 서비스에서 가공한 값을 분리해 관리하면 추후 화면을 수정할 때도 유연합니다. 계산이나 상담이 필요한 업무는 해당 업무에 맞는 검토 절차를 별도로 준비해야 합니다.

화면 4. 연동 준비 참고 화면 · APICK 회원가입 빈 양식. 입력·제출·가입은 진행하지 않음 — APICK 공식 공개 화면(2026-10-28), 실제 API 호출 결과가 아닙니다. 보관 캡처로 현재 화면과 다를 수 있습니다.
공식 사이트 실제 화면 · 보관 캡처(현재 화면과 다를 수 있음) · 캡처 2026-10-28 · 원본 페이지 확인

작게 연결하고 사용자 이해를 확인하기

처음에는 한 해의 금융소득을 확인하는 화면부터 만들어 보세요. 연도 선택, 본인 승인, 결과 보기, 다른 연도 확인의 흐름이 자연스러운지 살펴보면 필요한 개선점을 찾을 수 있습니다. 공식 화면 캡처를 설명 자료로 사용할 때도 실제 고객의 조회 결과처럼 보이게 꾸미지 않는 것이 중요합니다.

에이픽 금융소득 조회를 활용하면 본인이 승인한 자료를 서비스의 정보 확인 동선에 연결하는 기획을 시작할 수 있습니다. 사용자가 무엇을 확인했고 어느 연도의 자료인지 쉽게 이해하는 화면을 목표로 삼아 보세요. 기능 범위를 정확히 잡을수록 도입 검토도 구체적으로 진행할 수 있습니다.

#에이픽#금융소득조회API#이자배당#데이터연동#간편인증

이 블로그 검색

apick