SMT24 PG 거래시스템

1제안 개요

SMT24 PG 거래시스템은 Tx24가 제작한 T7을 기반으로, 카드 결제의 접수와 승인, 가맹점 관리, 거래 조회, 수수료 · 정산 관리, 지급대행 및 운영 모니터링을 연결하는 통합 제품입니다. 최근 발생하는 거래시스템 보안 사고에 대응하기 위해 보안 강화를 핵심 목표로 새롭게 출시한 시스템입니다.

가맹점은 API, 결제창, 웹훅을 통해 결제를 접수하고, 링크와 QR로 고객에게 결제 경로를 제공할 수 있습니다. 운영사는 본사 관리자에서 가맹점과 서비스 정책을 관리하고 거래 결과를 정산 · 지급 업무로 이어갑니다. 가맹점과 파트너는 별도 포털에서 자신의 권한 범위에 해당하는 거래와 정산 정보를 확인합니다.

시스템은 업무별로 분리된 9개 프로젝트와 공통 라이브러리로 구성됩니다. 필요한 결제 채널과 운영 기능을 먼저 도입하고, 기관 연계나 정산 방식, 전용 업무를 단계적으로 확장할 수 있습니다.

1.1 고객사에 제공하는 가치

기대 효과는 도입 목적이며, 비용 절감률이나 처리시간 개선율을 보장하는 수치는 아닙니다. 고객사의 기존 업무와 도입 후 지표를 비교해 확인합니다.

1.2 적용 대상

• 자체 브랜드의 결제 서비스와 가맹점 운영 체계를 구축하려는 사업자
• 여러 가맹점 또는 파트너의 거래 · 수수료 · 정산을 관리하는 플랫폼 사업자
• 온라인 주문과 상담 · 청구 업무에 결제창 또는 결제 링크를 연결하려는 기업
• 기존 결제 시스템의 관리자, 기관 연계, 정산 업무를 단계적으로 전환하려는 기업
• 2차 · 3차 PG를 운영하는 기업
• 보안 사고에 대응하고 보안 체계를 강화하기 위해 새 거래시스템을 검토하는 기업
• 노후 시스템의 제약으로 업무 확장과 신규 제휴 · 기관 연계가 어려운 기업

2제공 범위 요약

파트너 운영 및 확장 구조

파트너는 대행사 · 총판을 뜻합니다. 파트너를 대표파트너로 지정하고 일반 파트너를 대표파트너 1곳에 소속시킬 수 있습니다(2단계). 대표파트너는 포털에서 자신과 하위 파트너에 연결된 가맹점의 거래 · 가맹점 정보, 하위 파트너 목록과 수익률 · 수익 합계를 확인하고, 하위 파트너별로 걸러 보거나 대시보드 · 가맹점 통계를 「나 / 계층 전체」로 바꿔 볼 수 있습니다. 하위 파트너는 자신의 데이터만 조회하며, 정산 지급과 지갑은 파트너별로 운영됩니다.

수익 관리와 거래 확인을 기반으로 파트너 수에 제한 없이 확장할 수 있는 구조입니다.

3시스템 구성

3.1 구성 원칙

외부 결제 요청을 받는 접점, 결제 업무를 판단하는 코어, 외부 기관과 통신하는 연계 모듈을 분리합니다. 관리자와 가맹점 화면은 업무에 맞게 따로 제공하고, 거래 후처리와 정산 · 지급 작업은 별도 작업 서버에서 수행합니다.

공통 라이브러리 T7_LIB가 내부 통신, 데이터베이스 접근, Redis, 암복호화 연계, 로깅, 작업 스케줄링의 공통 기반을 제공해, 공통 기능의 개선을 여러 서비스에 일관되게 적용할 수 있습니다.

3.2 거래 · 운영 연결 흐름

• 결제 요청부터 승인 결과 확인까지: 고객은 결제창 · 링크 · QR에서 결제하고, 가맹점 시스템은 API로 직접 결제를 요청합니다. 시스템이 요청을 확인하고 외부 결제기관과 연계해 승인 결과를 전달합니다. 결과가 불명확하면 거래 조회로 확인한 뒤 후속 처리합니다.
• 거래 내역에서 정산 · 지급까지: 결제 거래를 정산 정책에 따라 집계해 지급 대상으로 연결합니다. 정산 금액의 확정과 실제 지급 완료를 구분해 관리합니다.
• 운영 상태 수집과 담당자 알림: 서비스별 로그와 JVM 상태를 모아 저장하고, 설정된 오류 · 업무 이벤트를 담당자에게 전달합니다. SMS · 이메일은 T7_MSG로 발송합니다.

외부 진입점의 NGINX, 서버 수량, 망 구간, 데이터베이스와 Redis 배치는 고객사 인프라 설계에서 확정합니다.

3.3 프로젝트별 역할

3.4 시스템 특징

3.5 구성 소프트웨어

4결제 서비스

4.1 API 결제

가맹점 서버가 주문 · 결제 정보를 보내면 거래 코어가 입력값과 인증 키, 가맹점 · 서비스 상태를 확인하고 기관 연계 모듈로 승인을 요청합니다. 결과에는 거래 식별자와 업무 결과 코드가 포함됩니다. 공개 연동 문서는 카드 승인 · 취소, 승인 결과 조회, 거래 · 정산 보고서 조회를 제공합니다.

통신 응답을 받지 못하면 승인 결과 조회로 처리 결과를 확인합니다. 승인 여부가 불명확한 거래는 바로 재결제하지 않고 원거래 상태를 확인한 뒤 후속 처리하도록 연동합니다.

4.2 Checkout 결제창

결제창의 인증 완료와 실제 승인 완료는 다른 단계입니다. 주문 상태는 최종 승인 결과를 기준으로 바꿉니다.

4.3 Payment Link와 QR

링크 발급 요청의 중복 확인, 링크 사용 중지, 결제 진행 · 완료 · 확인 필요 상태 관리가 포함됩니다. 링크를 SMS · 이메일로 보내는 업무는 공통 메시지 모듈과 연결해 구성합니다.

4.4 취소와 거래 조회

원거래 기준의 전체취소 · 부분취소를 처리하며 잔여 취소 가능 금액과 정책을 확인합니다. 같은 원거래의 동시 부분취소에는 잠금과 금액 재확인 절차가 있습니다. 거래 조회와 매출전표 링크는 고객 응대와 거래 확인에 활용합니다.

5본사 · 가맹점 운영 시스템

5.1 본사 관리자

5.2 가맹점 · 파트너 포털

• 가맹점 서비스에 따른 결제창 호출 및 결제 링크 생성
• 거래와 취소 내역 조회, 거래자료 다운로드
• 정산 내역과 지급 관련 정보 조회
• 월렛 잔액 · 거래 및 계약에 따른 이체 업무
• 파트너 통계 · 정산 · 월렛 업무
• 사용자, 상품 및 공지 기능

메뉴와 처리 권한은 접속 주체와 서비스 설정에 따라 적용하며, 모든 가맹점에 같은 결제 · 지급 권한을 주지 않습니다.

5.3 본사 관리자 메뉴별 기능 명세

정산 확정과 실제 송금 완료는 별도 상태로 관리합니다. 「정산완료」라는 메뉴명만으로 지급 완료를 판단하지 않습니다.

5.4 가맹점 · 파트너 · 영업 사용자 메뉴

조회 · 취소 · 송금 등 실제 처리 권한은 서버의 권한 검사와 업무 정책을 따르며, 메뉴가 보이는 것이 처리 권한을 뜻하지 않습니다.

6정산 · 전자지갑 · 지급대행

6.1 거래를 기준으로 한 정산

거래 후처리 작업이 원천 거래를 정산과 통계용 데이터로 연결하고, 정산 생성 작업이 가맹점 · 파트너별 정산 묶음을 만듭니다. 서비스별 정산 정책은 수수료와 적용일, 정산 계좌, 정산 유형(실시간 · 일 · 주 · 월 · 월렛)을 관리합니다.

정산 산식과 반올림, 취소 반영 기준, 지급 보류 · 해제 조건은 도입 초기에 합의합니다. 기존 시스템을 전환할 때는 같은 거래 표본으로 계산 결과를 비교한 뒤 적용합니다.

6.2 전자지갑과 계좌 연계

전자지갑 API는 예금주 확인, 잔액 조회, 송금 및 이체 결과 조회를 제공하고, 본사와 가맹점 월렛 사이의 집금 · 지급 경로도 갖추고 있습니다. 지급대행 작업은 지급 대상을 만들고 송금을 요청한 뒤 기관 처리 결과와 내부 상태를 확인합니다.

전자지갑은 계좌 · 잔액 · 송금 업무 모듈을 가리키며, 특정 금융상품의 법적 지위나 별도 사업 인허가를 뜻하지 않습니다.

6.3 결과 불명 거래의 관리

결제 · 송금 중 통신 장애가 나면 외부 기관의 처리 결과와 내부 기록을 대조합니다. 이체 결과 조회, 통신 장애 확인 작업, 관리자 처리 경로가 있으며, 모든 장애 거래의 자동 복구나 자동 재송금을 기본 범위로 보지 않습니다.

7외부 기관 연계

T7_EXT가 기관별 요청과 응답을 처리합니다. 결제 코어와 기관별 통신을 분리해, 기관 연계 변경을 담당 모듈 중심으로 관리합니다.

연계 구현이 있다는 것이 해당 기관과 고객사의 계약이나 상용 개통 완료를 뜻하지는 않습니다. 신규 PG · VAN · 금융기관 연계와 카드사 직접 승인 · 매입, 가상계좌, 실시간 계좌이체, 현금영수증, 빌링은 별도 범위로 협의합니다.

8기술 기반과 운영 관리

HTTP 중계, 거래 코어, 기관 연계, 작업 서버가 나뉘어 있어 거래량에 맞춘 증설을 설계할 수 있습니다. 서버를 늘리는 것만으로 처리량이나 무중단 운영이 보장되지는 않으므로 DB 경합, Redis 의존성, 작업 중복 실행, 기관 처리 한도를 함께 검증합니다.

각 서비스의 로그와 JVM 상태를 Redis 큐로 모아 T7_LOG가 저장하고, 프로세스 시작 · 종료와 WARN · ERROR, 설정된 업무 태그를 알림 채널(SMS, 이메일, NAVER WORKS Bot, ntfy)로 연결합니다.

9보안 및 거래 통제

이 문서는 보안 인증 취득이나 전 구간 보안 검증 완료를 주장하지 않습니다. 망분리 · 고가용성 구성과 고도화 FDS, 원격 백업, 무손실 로그 복구는 적용 범위를 협의합니다.

10도입 제안

계정 탈취, 비인가 권한 상승, 계정 정보의 무단 변경, 승인되지 않은 임의 결제, 야간 이상거래처럼 운영 현장에서 우려하는 위협을 예방 · 통제하는 것을 주요 설계 목표로 삼았습니다.

10.1 도입 유형

10.2 권장 추진 절차

10.3 초기 협의 항목

• 사업 및 운영 구조: 본사 · 가맹점 · 파트너 관계, 서비스 대상과 운영 조직
• 결제 범위: 수기 · 인증 결제, 결제창 · 링크 · QR, 취소 및 고객 안내 방식
• 기관 조건: 사용 PG · 금융기관 · 인증기관, 계약 · 개통 상태, 테스트 환경
• 정산 정책: 수수료 · 부가세 · 계산 단위, 정산 주기, 보류 · 해제와 지급 계좌
• 자금 업무: 월렛 · 지급대행 필요 여부, 지급 승인 절차, 결과 불명 처리 기준
• 인프라 · 운영 수준: 예상 거래량, 피크 시간, 가용성, 백업 · 복구, 지원 시간
• 전환 조건: 기존 거래 · 정산 잔액 · 가맹점 데이터 이관 범위, 병행 운영 방식

10.4 성능과 운영 품질의 확인 기준

성능 목표는 고객사 예상 거래량과 실제 배포 구성을 기준으로 합의하며, 다른 시스템의 시험 결과를 성능 수치로 쓰지 않습니다.

11기본 범위와 별도 검토 범위

11.1 기본 범위

카드 결제 · 취소와 조회, Checkout · 링크 결제, 본사 · 가맹점 운영 화면, 가맹점 · 파트너 정산, 전자지갑 · 지급 연계, 로그 · 상태 수집과 메시지 발송을 도입 검토의 기본 범위로 제안합니다.

11.2 추가 협의 범위

11.3 운영 전 확인 사항

• Checkout · Payment Link 최신 구현과 공개 가이드의 URL · 관리키 · 대표 QR 계약 정합성
• 결제창에서 최종 승인까지의 내부 인증 · 라우팅 및 중복 요청 통제
• 장기 지급 복구 작업의 적용 여부와 관리자 복구 절차
• 메시지 일괄 발송의 중복 방지와 실패 처리, 로그 큐의 장애 시 보존 · 재처리
• 운영용 보안 설정, 개인정보 처리와 로그 노출 범위, 외부 기관별 시험 결과

12도입 제안의 핵심

SMT24는 협력사 Tx24의 T7을 기반으로, 거래 접수부터 정산 · 지급 결과 확인까지 관리할 수 있는 PG 거래시스템 구축을 제안합니다. 기존 주문 · 업무 시스템에 결제 기능을 연결하거나, 본사와 가맹점 포털을 포함한 운영 체계를 구성할 수 있습니다.

첫 단계로 실제 업무 시나리오 기반의 기능 시연과 정산 정책 적합성 검토를 제안합니다. 이 결과로 공급 범위, 추가 개발, 기관 개통, 운영 책임과 비용을 구체화합니다.

공급 범위 · 비용 · 일정 · 운영 지원은 도입 협의로 확정합니다. 기능의 구현 여부와 고객사 환경의 개통 · 검수 완료는 구분하며, 도입 효과는 적용 범위와 운영 환경에 따라 달라집니다.