시작하기

이 플러그인의 설치 단계와 전체 markdown 가이드가 포함된 설정 프롬프트를 복사하세요.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-stripe-terminal`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/stripe-terminal/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

설치

bun add @capgo/capacitor-stripe-terminal
bunx cap sync

가져오기

import { StripeTerminal } from '@capgo/capacitor-stripe-terminal';

빠른 시작

import { StripeTerminal } from '@capgo/capacitor-stripe-terminal';

await StripeTerminal.initialize({ isTest: true });

예시: discoverReaders

import { StripeTerminal, TerminalConnectTypes } from '@capgo/capacitor-stripe-terminal';

const result = await StripeTerminal.discoverReaders({ type: TerminalConnectTypes.Simulated });
// The result holds sensitive values: use it without logging it.

예시: setConnectionToken 설정하기

import { StripeTerminal } from '@capgo/capacitor-stripe-terminal';

await StripeTerminal.setConnectionToken({ token: 'token-123' });

자주 하는 실수

리스너: 화면이 unmount될 때 핸들을 제거하세요.
한 번만 초기화: 앱 부트스트랩 시 setup을 실행하세요.
단일 진실 공급원: 신뢰 src/definitions.ts GitHub 레포지토리에서.

백엔드 요구 사항

Stripe Terminal은 연결 토큰을 생성하는 보안 백엔드 엔드포인트가 필요합니다. 해당 URL을 다음으로 전달하세요: initialize().

await StripeTerminal.initialize({
  tokenProviderEndpoint: 'https://api.example.com/stripe/terminal/connection-token',
  isTest: true,
});

await StripeTerminal.discoverReaders({ type: 'tap-to-pay' });

예제 앱

git clone https://github.com/Cap-go/capacitor-stripe-terminal.git
cd capacitor-stripe-terminal/example-app
bun install
bun run start

기준 소스

이 페이지는 다음 저장소의 최신 공개 API를 다룹니다: Capgo/capacitor-stripe-terminal.