ENKO
< 작업 목록으로
HASH: 0x0022...2025.11 - Present

BEATOZ CPG (Core) - Crypto Payment Gateway

Payment Gateway

시스템 설명

여러 체인의 결제 상태를 하나로 관리하는 결제 게이트웨이입니다. 결제 오케스트레이터와 체인별 모니터링 워커, HMAC 서명 웹훅, 운영 화면을 구현했습니다. 중복 요청을 막고 확정이 늦는 거래를 추적해 정산 단계로 넘기도록 구성했습니다.

기술 스택

TypeScriptNestJSPostgreSQLRedisBullMQNext.jsTailwindCSSDockerAWS EC2PrometheusGrafana
BEATOZ CPG (Core) - Crypto Payment Gateway
ROLE: SOLO_DEVELOPERDOMAIN: BLOCKCHAIN
!

문제도전 과제

서로 다른 네트워크/결제 타입에서도 결제 상태(요청→탐지→확정→정산)가 일관되게 유지되어야 했고, API 플로우 뿐 아니라 ‘월렛 직접 전송’ 케이스까지 탐지/연결해야 했습니다. 또한 스토어(가맹점) 온보딩/공개 목록, 통합 결제 UX(위젯/세션/커스텀 결제), 커스터디 월렛, 인증/권한, 웹훅 신뢰성뿐 아니라 issuer, treasury, 컴플라이언스 계열 서비스와 연결 가능한 통합 지점을 함께 갖춰야 했습니다.

✓

해결해결 방식

스토어 페이지에서 사용할 수 있는 가맹점 공개 목록(`public-list`)과 Developer Site 전용 상점 등록(`register`, 자동 승인) 흐름을 구현하고, API Credential을 SSOT로 관리했습니다. 결제 오케스트레이터에서 Strategy/Adapter 선택 및 QR 데이터 SSOT 저장, 조건부 체인 스캔(직접 전송 탐지)과 캐시 기반 호출 제한을 구성했습니다. 결제 제품(통합 결제/위젯/커스텀 결제) API와 세션/상태 조회를 제공하고, 커스터디 월렛 관리 및 서명 서비스 구조를 포함했습니다. 여기에 issuer 연동 훅, treasury 측 정산 처리로 넘길 수 있는 연결 지점, HMAC 서명 + 재시도/기록을 포함한 웹훅 전달 시스템을 더해 중앙 dev pilot 배포 레이어와 맞물리도록 구성했습니다.

구현 범위

여러 체인의 결제 상태를 하나로 관리하는 결제 게이트웨이입니다. 결제 오케스트레이터와 체인별 모니터링 워커, HMAC 서명 웹훅, 운영 화면을 구현했습니다. 중복 요청을 막고 확정이 늦는 거래를 추적해 정산 단계로 넘기도록 구성했습니다.

증빙 자료

공개 가능한 증빙 자료가 등록되지 않았습니다.

SYSTEM_COMPONENTS

Backend API

Payment Engine & Settlement

기술 스택

NestJSTypeORMPostgreSQLBullMQ

하이라이트

  • →Unified payment orchestrator (Strategy/Adapter)
  • →Chain-specific workers & processors
  • →Settlement queues & controllers

Dashboards

Admin & Merchant UI

기술 스택

Next.jsTailwindCSSshadcn-ui

하이라이트

  • →Admin dashboard
  • →Merchant dashboard
  • →Operational tooling

Payment Products

Widget / Session / Custom Payment

기술 스택

NestJSCQRSDTO/VO

하이라이트

  • →Integrated payment sessions
  • →Payment widget config
  • →Custom payment flows
기술 상세

개요

  • ▶1인 개발로 진행한 암호화폐 결제 게이트웨이 모노레포입니다.
  • ▶API(결제/정산) + 네트워크 모니터링 워커 + 웹훅 + 운영 대시보드로 구성했습니다.
  • ▶issuer, treasury, custody, CKYC 등과 함께 운영되는 Beatoz 통합 dev pilot에서 결제 도메인을 담당하도록 구성했습니다.

핵심 구성

0) 스토어(가맹점) 온보딩

  • ▶스토어 페이지 등에서 가맹점 선택을 위한 공개 목록과, Developer Site 전용 상점 등록 플로우를 제공합니다.

1) 결제 오케스트레이션(Strategy/Adapter)

  • ▶체인/결제 타입별 차이를 Strategy/Adapter로 분리해 확장 가능한 결제 엔진을 구성했습니다.
  • ▶QR 데이터는 SSOT로 저장하고, 체인 타입에 따라 ‘직접 전송’ 감지/스캔 흐름을 연결했습니다.

1-2) 결제 제품(통합 결제/위젯/커스텀 결제)

  • ▶통합 결제창 생성/설정, 결제 세션 시작 및 상태 조회, 커스텀 결제 플로우 등 “결제 UX 레이어”를 API로 제공합니다.

1-3) 커스터디 월렛(운영 키/서명)

  • ▶커스터디 월렛 생성/요청/관리와 서명 서비스 구성을 포함합니다.
  • ▶issuer 연동 및 인접 재무/컴플라이언스 도메인으로 이어질 수 있는 런타임 연결 지점을 함께 고려했습니다.

2) 모니터링 워커(큐 분리)

  • ▶네트워크별 트랜잭션 탐지/컨펌 모니터링을 워커로 분리하고, 큐를 분리해 장애 전파를 줄였습니다.

3) 웹훅 전달(HMAC 서명 + 재시도)

  • ▶외부 시스템 연동을 위해 HMAC 서명 웹훅과 재시도 정책을 구현했습니다.
  • ▶웹훅 전달 결과(성공/실패/재시도)를 기록해 운영 추적이 가능하도록 구성했습니다.

4) 정산/운영 UI

  • ▶Admin/Merchant 대시보드로 트랜잭션/정산/상태를 운영 가능하게 제공했습니다.
  • ▶중앙 AWS 기반 dev pilot 배포 레이어에 맞는 런타임 형태로 정리했습니다.