블로그로 돌아가기
가이드

펌뱅킹 전문(Message) 구조 이해하기

금융 IT 시스템을 처음 접하면 가장 낯선 개념 중 하나가 '전문(Message)'입니다. 펌뱅킹 전문의 기본 구조를 알아봅니다.

2026-03-11
7분
#펌뱅킹#전문통신#금융시스템
펌뱅킹 전문(Message) 구조 이해하기 썸네일 이미지

금융 IT 시스템을 처음 접하면 가장 낯선 개념 중 하나가 전문(Message) 이에요.

일반적인 웹 시스템에서는 JSON이나 REST API를 사용하지만, 금융권에서는 여전히 전문 기반 통신이 많이 사용돼요.

특히 펌뱅킹 시스템에서는 거의 모든 거래가 전문(Message) 형태 로 전달돼요.

이번 글에서는 펌뱅킹 전문의 기본 구조를 정리해볼게요.


펌뱅킹 전문이란?

펌뱅킹 전문은 기업 시스템과 은행 시스템이 통신할 때 사용하는 정해진 형식의 데이터 패킷 이에요.

쉽게 말하면 다음과 같은 덩어리예요:

  • 거래 종류 정보
  • 계좌 정보
  • 금액 정보
  • 처리 결과 반환

기업 시스템이 이체 요청을 보내면 이 요청은 전문 형태 로 은행 시스템에 전달돼요.


전문의 기본 구조

대부분의 금융 전문은 크게 두 영역으로 구성돼요:

  1. 공통부 영역
  2. 개별부 영역
펌뱅킹 전문 구조300 bytes
공통부100B · offset 0
거래 코드4 · 0
전문 길이4 · 4
기관 코드10 · 8
거래 일자8 · 18
전문 번호20 · 26
개별부200B · offset 100
출금 계좌번호20 · 100
입금 계좌번호20 · 120
이체 금액15 · 140
계좌 예금주30 · 155
거래 메모50 · 185
필수
선택
응답전용 / 예비
길이 · 위치

공통부

공통부 는 거래를 처리하기 위한 기본 정보가 들어있는 영역이에요.

대표적으로 다음 정보가 포함돼요:

  • 거래 코드
  • 전문 길이
  • 기관 코드
  • 거래 일자
  • 전문 번호

이 정보들은 거래를 구분하고 추적하기 위해 사용돼요.

예를 들어 거래 코드 는 "이 전문이 계좌조회인지, 이체인지"를 구분하는 역할을 해요.


개별부

개별부 영역에는 실제 거래 정보가 들어가요.

예를 들어 계좌이체 전문이라면 다음과 같은 정보가 포함돼요:

  • 출금 계좌번호
  • 입금 계좌번호
  • 이체 금액
  • 계좌 예금주
  • 거래 메모

이 영역이 실제 금융 거래 데이터를 담는 부분이에요.


전문 기반 통신을 사용하는 이유

금융 시스템에서 전문 기반 통신을 사용하는 이유는 다음과 같아요:

첫 번째는 안정성이에요

금융 거래는 오류가 발생하면 큰 문제가 될 수 있기 때문에 정해진 형식의 메시지를 사용하는 것이 안정적이에요.

두 번째는 대량 처리예요

기업에서는 하루 수천 건 이상의 거래가 발생할 수 있기 때문에 빠르게 처리할 수 있는 구조가 필요해요.

세 번째는 금융망 표준이에요

금융권에서는 오래전부터 전문 기반 통신을 사용해 왔기 때문에 여전히 많은 시스템이 이 구조를 유지하고 있어요.

NOTE

참고

헥토파이낸셜의 실시간 펌뱅킹은 고정길이 전문(300바이트) 방식을 사용하며, 공통부 100바이트 + 개별부 200바이트로 구성됩니다.

전문을 이해해야 하는 이유

금융 IT 개발이나 운영을 하다 보면, 다음과 같은 상황을 자주 만나게 돼요.

  • 거래 실패 원인 분석
  • 전문 오류 확인
  • 오류 코드 분석

이때 전문 구조를 이해하고 있어야 문제 원인을 빠르게 찾을 수 있어요.

특히 장애 상황에서는 전문 로그를 통해 거래 흐름을 추적하는 경우가 많아요.

펌뱅킹 전문은 금융 시스템에서 가장 기본적인 통신 방식이에요.

처음에는 구조가 낯설지만 공통부와 개별부 구조만 이해 하면 전체 흐름을 파악할 수 있어요.

다음 글에서는 실제 은행 결제에서 자주 발생하는 펌뱅킹 장애 사례 를 정리해볼게요.

다음 글: 펌뱅킹 장애 사례 정리 →

실시간 펌뱅킹 문서 바로가기 →

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?