📁 목차

Hyperswitch는 유연성과 제어력을 위해 설계된 모듈형 오픈 소스 (open-source) 결제 인프라를 제공합니다. 당사의 결제 제품군 (Payment Suite) 외에도, 이 솔루션을 통해 기업은 불필요한 복잡성이나 벤더 종속 (vendor lock-in) 없이 기존 결제 스택 위에 필요한 모듈만 선택하여 통합할 수 있습니다.

각 모듈은 독립적이며 결제 처리 (payment processing)의 다양한 측면을 최적화하도록 특수 제작되었습니다.

상세 정보

비용 관측성 (Cost Observability)

결제 비용을 감사, 모니터링 및 최적화하기 위한 고급 관측성 (observability) 도구입니다. 셀프 서비스 대시보드와 실행 가능한 인사이트를 통해 숨겨진 수수료, 등급 하락 및 페널티를 감지합니다.

더 읽어보기 -
매출 회복 (Revenue Recovery)

카드 BIN, 지역, 결제 수단 등에 따라 조정된 지능형 재시도 (retry) 전략을 통해 수동적 이탈 (passive churn)에 대응합니다. 재시도 알고리즘, 페널티 예산 및 회복 투명성에 대한 세밀한 제어를 제공합니다.

더 읽어보기 -
볼트 (Vault)

카드, 토큰 (tokens), 지갑 및 은행 자격 증명을 저장하기 위한 PCI 준수 (PCI-compliant) 볼트 서비스입니다. 고객과 연결된 결제 수단의 통합되고 안전하며 재사용 가능한 저장소를 제공합니다. 또한 VGS 및 TokenEx를 포함한 기존 제공업체를 재토큰화 (re-tokenizing)하거나 저장된 카드를 마이그레이션할 필요 없이 연결할 수 있는 BYOV (bring-your-own-vault)를 지원합니다.

더 읽어보기 -
지능형 라우팅 (Intelligent Routing)

각 트랜잭션을 Stripe, Adyen, Braintree, Worldpay, Checkout.com 및 120개 이상의 기타 결제 서비스 제공업체 (PSP) 중 예측 승인율 (auth rate)이 가장 높은 곳으로 라우팅합니다. 재시도를 줄이고, 다운타임을 방지하며, 지연 시간 (latency)을 최소화하는 동시에 첫 번째 시도 성공률을 극대화합니다. 더 읽어보기 -
대조 (Reconciliation)

소급 지원, 단계적 스케줄링 및 맞춤형 출력을 통해 2-way 및 3-way 대조 (reconciliation)를 자동화합니다. 수동 운영 노력을 줄이고 감사 신뢰도를 높입니다.

더 읽어보기 -
대체 결제 수단 (Alternate Payment Methods)

PayPal, Apple Pay, Google Pay, Samsung Pay, Pay by Bank 및 Klarna와 같은 BNPL 제공업체를 위한 드롭인 위젯 (drop-in widgets)을 제공합니다. 원클릭 결제를 통해 전환율을 극대화합니다.

더 읽어보기

원클릭 로컬 설정 (One-click local setup)

git clone --depth 1 --branch latest https://github.com/juspay/hyperswitch
cd hyperswitch
...

이 스크립트는 다음을 수행합니다:

• Docker/Podman 감지

• 다양한 배포 프로필 (deployment profiles) 제공:
  Standard (표준): 앱 서버 (App server) + 컨트롤 센터 (Control Center)
  Full (전체): 모니터링 (monitoring) + 스케줄러 (schedulers) 포함
  Minimal (최소): 단독 앱 서버 (Standalone App server)

• 완료 시 접속 링크 제공

추가 도움이 필요한 경우, 비디오 튜토리얼을 확인하세요.

👉 설정 후, 커넥터 (connector)를 구성하고 결제를 테스트하세요.

Hyperswitch는 별도의 설정이 필요 없는 완전 호스팅된 샌드박스 (sandbox) 환경을 제공합니다. UI에서 직접 컨트롤 센터 (Control Center)를 탐색하고, 결제 커넥터 (payment connectors)를 구성하며, 결제를 테스트할 수 있습니다.

호스팅된 샌드박스 (Hosted Sandbox)에서 할 수 있는 작업

• 전체 컨트롤 센터 (Control Center) 접속
• 결제 커넥터 (payment connectors) 구성
• 로그 (logs), 라우팅 규칙 (routing rules), 재시도 전략 (retry strategies) 확인
• UI에서 직접 결제 시도

Helm Charts를 사용하여 AWS, GCP 또는 Azure에 배포할 수 있습니다.

Hyperswitch는 확장성, 유연성 및 개발자 경험 (developer experience)을 위해 특수 제작된 상용 오픈 소스 결제 스택 (commercial open-source payments stack)입니다. 모듈형 아키텍처 (modular architecture)로 설계된 Hyperswitch는 벤더 종속 (vendor lock-in)이나 불필요한 통합 없이 라우팅 (routing), 재시도 (retries), 볼팅 (vaulting) 또는 관측성 (observability) 등 필요한 컴포넌트만 선택할 수 있습니다.

성능과 신뢰성을 위해 Rust로 구축된 Hyperswitch는 Stripe, Adyen, Braintree, Worldpay, Checkout.com, Cybersource 및 120개 이상의 프로세서 (processors)에 연결됩니다. 이를 통해 스마트 라우팅 (smart routing) 및 재시도 로직 (retry logic)을 노출하며, 컨트롤 센터 (Control Center)에서 시각적 워크플로 빌더 (visual workflow builder)를 제공합니다. 전체 결제 제품군을 통합하든, 단일 모듈로 기존 스택을 보완하든, Hyperswitch는 사용자의 현재 상황에 맞는 솔루션을 제공합니다.

일반적인 시작점: 단일 Stripe/Stripe Connect 또는 Braintree 연동에서 멀티-PSP 라우팅 (multi-PSP routing)으로 전환하는 팀, 결제 게이트웨이를 TSYS, JP Morgan Payments 또는 기타 매입사 (acquirers)와의 직접적인 매입 연결로 교체하려는 가맹점, 그리고 기존의 VGS, TokenEx 또는 기타 기존 볼트 (vault)를 그대로 유지하면서 Hyperswitch를 통해 결제 플랫폼을 재설계하려는 가맹점들이 이에 해당합니다.

“결제를 위한 Linux” — Hyperswitch는 자체 결제 스택을 소유하고자 하는 팀을 위한 잘 설계된 참조 모델 (reference)입니다.

우리는 다음을 믿습니다:

결제 다양성 수용 (Embracing Payment Diversity): 혁신은 결제 수단, 프로세서 (processors), 그리고 흐름 (flows) 전반에 걸쳐 선택권을 제공함으로써 이루어집니다. -
기본적으로 오픈 소스 (Open Source by Default): 투명성은 신뢰를 유도하고 더 나은, 재사용 가능한 소프트웨어를 구축합니다. -
커뮤니티 주도 개발 (Community-Driven Development): 우리의 로드맵은 실제 사용 사례와 기여자들에 의해 형성됩니다. -
시스템 수준 엔지니어링 (Systems-Level Engineering): 우리는 신뢰성, 보안 및 성능에 대해 높은 기준을 유지합니다. -
가치 창출 극대화 (Maximizing Value Creation): 개발자, 고객, 그리고 파트너 모두를 위하여. -
커뮤니티 주도, 엔터프라이즈 검증 (Community-Driven, Enterprise-Tested): Hyperswitch는 개발자와 기여자들의 실제 피드백을 바탕으로 공개적으로 구축되었으며, 전 세계 400개 이상의 선도적인 기업에 결제 인프라를 제공하는 Juspay 팀에 의해 유지 관리됩니다.

Hyperswitch는 함께 작동하는 일련의 모듈형 서비스와 SDK로 구축되었습니다. 이 리포지토리의 Rust 앱 서버가 핵심이며, 아래의 리포지토리들은 대시보드, 클라이언트 SDK 및 배포 도구를 통해 이를 확장합니다.

결제를 처리하는 Rust 서비스들입니다. 앱 서버가 중심점이며, 볼트 (vault) 및 암호화 서비스가 그와 함께 민감한 데이터 작업을 처리합니다. hyperswitch-prism은 별도의 더 가벼운 진입점으로, 전체 스위치를 실행하지 않고도 결제 프로세서에 직접 사용할 수 있는 통합 커넥터 라이브러리입니다.

| | hyperswitch | card-vault | encryption-service | prism | |
|---|---|---|---|---|
| 언어 (Language) | Rust | Rust | Rust | Rust |
| 역할 (Role) | 앱 서버 (App server). 라우팅 (Routing), 재시도 (retries), 볼팅 (vaulting), 관측성 (observability). | PCI 준수 카드 저장소 (PCI-compliant card storage). | 암호화 (Encryption), 복호화 (decryption), KMS. | 통합 커넥터 라이브러리 (Unified connector library), 100개 이상의 프로세서. |
| 의존성 (Depends on) | card-vault, encryption-service | encryption-service | 없음 (None) | 없음 (None) |

커넥터, 라우팅을 설정하고 트랜잭션을 확인하기 위한 가맹자용 UI (Merchant-facing UIs)입니다. 두 가지 모두 hyperswitch 백엔드가 실행 중이어야 합니다.

	control-center	control-center-embedded
언어 (Language)	ReScript	TypeScript
역할 (Role)	전체 가맹자 대시보드 (Full merchant dashboard). 커넥터, 라우팅 규칙, 분석, API 키.	파트너 및 가맹자가 자신의 앱 내부에 Hyperswitch UI를 노출할 수 있도록 하는 임베디드 가능한 (Embeddable) Hyperswitch 컴포넌트.
의존성 (Depends on)	hyperswitch backend	hyperswitch backend

브라우저가 Hyperswitch와 통신하는 방식입니다. hyperswitch-client-core는 공유 코어이며, 모든 클라이언트 SDK (웹 및 모바일)에 git 서브모듈 (git submodule)로 포함됩니다. hyperswitch-sdk-utils는 헤드리스 구현 (Headless Implementations)을 수행하는 가맹자가 직접 사용하는 공유 에셋 (shared assets)을 보유합니다.

| | hyperswitch-web | client-core | react-hyper-js | sdk-utils | |
|---|---|---|---|---|
| 언어 (Language) | ReScript | ReScript | ReScript | ReScript |
| 배포 (Distribution) | npm | git submodule | npm | git submodule |
| 역할 (Role) | 주요 웹 SDK. 통합 체크아웃을 위해 ReScript로 구축된 React 라이브러리. | 모든 클라이언트 SDK에 의해 전이적으로 소비되는 (consumed transitively) 공유 SDK 코어. | Hyper JS 로더를 감싼 (wrapper) 관용적인 (Idiomatic) React 래퍼. | client-core 및 hyperswitch-web 전반에서 사용되는 공유 유틸리티 및 에셋. |
| 의존성 (Depends on) | hyperswitch backend | 없음 (None) | hyperswitch-web | 없음 (None) |

모바일 앱에 Hyperswitch 체크아웃을 임베딩하기 위한 네이티브 SDK입니다. 모두 git 서브모듈로 포함되는 hyperswitch-client-core를 기반으로 구축되었습니다.

Android	iOS	React Native	Flutter
Repository	hyperswitch-sdk-android	hyperswitch-sdk-ios	react-native-hyperswitch	flutter_hyperswitch
Language	Kotlin	Swift	TypeScript	Dart
Distribution	Maven	CocoaPods (SPM in progress)	npm	pub.dev
Status	공식 지원됨	공식 지원됨	공식 지원됨	공식 지원됨

중요

이전 레포지토리인 hyperswitch-sdk-react-native는 사용 중단(deprecated)되고 이미 npm에서 제거되었습니다. 대신 react-native-hyperswitch를 사용하세요.

Hyperswitch 실행을 위한 도구 모음입니다. 로컬 개발부터 프로덕션까지 지원합니다.

hyperswitch-suite	hyperswitch-helm
Tooling	Terraform (HCL)	Helm charts
Role	core, vault, control-center 및 web을 연결하는 통합 전체 스위트 배포입니다. 풀 스택에 대한 권장 시작점입니다.	GCP, Azure 또는 모든 K8s 호환 플랫폼용 Kubernetes 배포입니다.

전 세계의 기여자들을 환영하며 Hyperswitch 구축에 도움을 주시기 바랍니다. 버그 수정, 문서 개선, 새로운 기능 추가 등 어떤 도움이든 감사하게 생각합니다.

시작하려면 기여 가이드라인(contributing guidelines)을 읽어주세요.

Slack에서 대화에 참여하거나 GitHub의 열린 이슈를 탐색해 보세요.

새로운 제품 기능, 개선 사항, 로드맵 논의 또는 문의 및 아이디어를 공유하려면 GitHub Discussions를 방문하세요.

버그 보고는 이슈 가이드라인을 읽고 기존 및 닫힌 이슈를 검색해 주세요. 문제가 되거나 아이디어가 아직 다루어지지 않았다면 새 이슈를 여세요.

자세한 내용은 CHANGELOG.md 파일을 확인하세요.

이 제품은 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다.