@capgo/capacitor-stripe-terminal

개요

Stripe Terminal 대면 결제를 위한 Capacitor 플러그인

시작하기 initialize() 그리고 아래에 나열된 다른 핵심 메서드도 살펴보세요.

플랫폼 지원

플랫폼	지원	참고 사항
iOS	지원	네이티브
Android	지원	네이티브
웹	아니요	Capacitor.getPlatform()으로 보호하세요

왜 Capgo인가요?

이 플러그인들은 다음 프로젝트의 포크로 유지 관리됩니다: @capacitor-community/stripe. Capgo는 커뮤니티 프로젝트를 각 Stripe 영역별 문서, 예제 앱, CI를 갖춘 특화 패키지로 분리했습니다.

Capgo는 커뮤니티 저장소의 오픈 이슈와 풀 리퀘스트를 추적하고, 관련 수정 사항을 당사 저장소에 이식한 뒤 최신 Stripe SDK로 배포합니다. 버그나 플랫폼 업데이트가 발생하면 커뮤니티 유지보수자보다 더 빠르게 대응하는 것을 목표로 합니다.

Tap to Pay 및 물리 리더기를 통한 대면 결제의 경우, @capgo/capacitor-stripe-terminal 커뮤니티 패키지의 유지보수되는 업그레이드 경로입니다.

핵심 기능

• initialize - 연결 토큰 제공자(connection token provider) 엔드포인트로 Terminal을 초기화합니다.
• discoverReaders - Tap to Pay, Bluetooth 또는 Internet 리더기를 검색합니다.
• cancelDiscoverReaders - 진행 중인 리더기 검색 세션을 취소합니다.
• connectReader - 검색된 리더기에 연결합니다.

공개 API

메서드	설명
initialize	연결 토큰 제공자 엔드포인트로 터미널을 초기화합니다.
discoverReaders	Tap to Pay, Bluetooth 또는 인터넷 리더를 검색합니다.
cancelDiscoverReaders	진행 중인 리더 검색 세션을 취소합니다.
connectReader	검색된 리더에 연결합니다.
getPluginVersion	네이티브 Capacitor 플러그인 버전을 가져옵니다.

참조 값

이 값들을 다음에 사용하세요 TapToPayUxConfiguration.darkMode Tap to Pay 설정 시

Tap To Pay 다크 모드

값	사용자는 다음을 확인할 수 있습니다:
SYSTEM	기기 시스템 외관에 맞춰 설정합니다.
DARK	Tap to Pay 플로우를 다크 외관으로 고정합니다.
LIGHT	Tap to Pay 플로우를 라이트 외관으로 고정합니다.

Source of Truth

이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-stripe-terminal.

관련 플러그인

• @capgo/native-purchases App Store 및 Play Store 구독용
• @capgo/capacitor-pay Stripe Payment Sheet 없이 지갑 전용 Apple Pay / Google Pay 사용 시